Elegir permisos para un agente de IA
Todos los permisos que puede tener un token de API o una aplicación conectada, qué permiten, qué ajustes preestablecidos los incluyen y qué roles (propietario, administrador, editor, creador de contenido) pueden otorgarlos.
Cada token de API y aplicación conectada conlleva un conjunto de permisos (capacidades) que determinan lo que un agente puede hacer en tu espacio de trabajo. Este artículo enumera cada permiso, qué permite, qué ajuste preestablecido lo incluye y qué roles pueden otorgarlo.
Cómo funcionan los permisos
- Un agente actúa como la persona que creó el token, dentro de lo que permite el rol de esa persona. Nunca puede hacer más de lo que su propietario podría hacer en la aplicación, y solo ve las grabaciones, vídeos y colecciones que su propietario puede ver.
- Tu rol decide lo que puedes otorgar. En el asistente de tokens y en la pantalla de conexión, un permiso que tu rol no puede otorgar aparece atenuado con "Tu rol no puede otorgar esto." (o "Solo los propietarios, administradores y editores pueden otorgar permisos de publicación." para la publicación). Un ajuste preestablecido que contiene uno de ellos aparece atenuado con "Tu rol no puede otorgar todas las capacidades de este ajuste preestablecido."
- El rol se verifica en cada llamada, no solo cuando se crea el token. Si el rol del propietario cambia más tarde, las llamadas que necesitan un permiso que el nuevo rol no permite son rechazadas, y el token muestra Excede el rol en la lista de tokens: "El rol del propietario cambió. Las llamadas que necesitan las capacidades tachadas son rechazadas."
- Cada permiso tiene un tipo, que se muestra como una insignia en el asistente: Leer, Editar, Publicar, Gestionar o Gasta créditos.
- Un agente solo ve las herramientas (MCP) y los puntos finales (REST) que permiten sus permisos. Llamar a uno que no tiene devuelve "A este token le falta la capacidad …"
Ajustes preestablecidos
El primer paso del asistente de tokens (¿Para qué sirve?) ofrece ajustes preestablecidos. Al elegir uno, se marcan sus permisos; puedes cambiar cualquiera de ellos en el siguiente paso, y el asistente mostrará entonces Personalizado con Restablecer a ajuste preestablecido.
| Ajuste preestablecido | Descripción en pantalla | Permisos |
|---|---|---|
| Escritor | "Los agentes redactan; una persona revisa y publica." | content:read, articles:write, changelog:write, media:write |
| Publicador | "Automatización de confianza que puede cambiar lo que ven los lectores." | Todos los permisos de sitios de documentación excepto help:read y insights:read |
| Asistente de soporte | "Respuestas de documentos publicados. Nada más." | help:read |
| Solo lectura | "Investigación, auditorías y comprobaciones de traducción." | content:read |
| Analista | "Lee contenido y señales de los lectores para sugerir correcciones." | content:read, insights:read |
| Productor | "Redacta contenido e inicia trabajo pagado dentro de los límites de gasto." | Escritor, más site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agente del espacio de trabajo | "Todo lo que un agente puede hacer en este espacio de trabajo, dentro de los límites de gasto." | Todos los permisos excepto help:read |
Productor y Agente del espacio de trabajo incluyen credits:spend, por lo que el asistente solicita límites de gasto en el paso Límites. Consulta Controlar el gasto y las aprobaciones de los agentes.
Los ajustes preestablecidos Escritor, Publicador, Asistente de soporte, Solo lectura y Analista son para sitios de documentación.
Permisos de vídeos
| Permiso | Tipo | Qué permite |
|---|---|---|
library:read |
Leer | "Leer grabaciones, vídeos, artículos y transcripciones que el propietario puede ver": listar la biblioteca y las grabaciones, leer un elemento, su transcripción y su artículo, y obtener un código de inserción. |
videos:create |
Editar | "Citar y solicitar vídeos, artículos a partir de grabaciones y traducciones": pedir una cita y solicitar vídeos de procedimientos, demostraciones de productos, limpieza y estilo a partir de una grabación, clips sociales, artículos a partir de una grabación y traducciones de vídeo. Iniciar trabajo pagado también requiere credits:spend. |
videos:export |
Editar | "Exportar vídeos y obtener códigos de inserción": renderizar un MP4 a 1080p (predeterminado), 2K o 4K, siempre a 60 fps, y obtener un enlace de descarga. Las exportaciones no cuestan créditos. |
materials:write |
Editar | "Añadir imágenes, vídeos y PDF a las cargas del espacio de trabajo utilizadas para nuevos vídeos". |
Permisos del espacio de trabajo
| Permiso | Tipo | Qué permite |
|---|---|---|
credits:spend |
Gasta créditos | "Gastar créditos en trabajo presupuestado, dentro de los límites del token". Es la segunda clave que necesita todo inicio de trabajo pagado, junto con el permiso para ese trabajo (por ejemplo videos:create). |
jobs:read |
Leer | "Ver trabajos iniciados por otros tokens del propietario". Un token siempre ve sus propios trabajos; esto añade los trabajos de otros tokens de su propietario. También permite al agente cancelar un trabajo y leer el saldo de créditos del espacio de trabajo. |
Permisos de documentos
Estos se aplican a sitios de documentación. En Límites → Sitios de documentación, un token cubre Todos los sitios ("Cada sitio de documentación en este espacio de trabajo, incluidos los nuevos.") o Sitios elegidos.
| Permiso | Tipo | Qué permite |
|---|---|---|
content:read |
Leer | "Leer sitios, páginas, artículos (también borradores), revisiones, registro de cambios y páginas del sitio". También configuración del sitio, apariencia, navegación y redirecciones. |
articles:write |
Editar | "Crear borradores de artículos y editar artículos que no están publicados". Traducir un artículo (pagado) también requiere credits:spend. |
structure:write |
Editar | "Crear y editar secciones, mover, ocultar y renombrar páginas". |
site-pages:write |
Editar | "Editar páginas del sitio como inicio, contacto y legal". Generar o traducir una página del sitio con IA (pagado) también requiere credits:spend. |
changelog:write |
Editar | "Crear y editar entradas del registro de cambios como borradores". |
media:write |
Editar | "Subir imágenes". |
site:publish |
Publicar | "Publicar: cambiar lo que ven los lectores, editar contenido en vivo, marcar páginas como listas". También publicar y eliminar entradas del registro de cambios y revertir un sitio. |
insights:read |
Leer | "Leer estadísticas del sitio: brechas de búsqueda, preguntas sin respuesta y comentarios de la página". Con articles:write también puede marcar una brecha como cubierta. |
site:configure |
Gestionar | "Cambiar la configuración, apariencia y navegación del sitio", y añadir redirecciones. |
sites:create |
Gestionar | "Crear nuevos sitios de documentación". |
help:read |
Leer | "Buscar solo en páginas públicas publicadas (asistente de soporte)". Un token con solo este permiso no ve nada más. |
Quién puede otorgar qué
| Permiso | Propietario | Administrador | Editor | Creador de contenido |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Sí | Sí | Sí | Sí |
library:read |
Sí | Sí | Sí | Sí |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Sí | Sí | Sí | Sí |
videos:export |
Sí | Sí | Sí | Sí |
videos:create, materials:write, credits:spend |
Sí | Sí | No | Sí |
site:publish, site:configure |
Sí | Sí | Sí | No |
sites:create |
Sí | Sí | No | No |
Un Creador de contenido puede dar a un token credits:spend, pero el trabajo pagado que requiere aprobación siempre es aprobado por el propietario del espacio de trabajo o un administrador, nunca solo por el propietario del token. Consulta Controlar el gasto y las aprobaciones de los agentes.
Aún no disponible para agentes
Los agentes aún no pueden realizar investigaciones de sitios web o recorridos grabados, ni publicar vídeos en otras plataformas. Esos permisos no se pueden otorgar.