Escolher permissões para um agente de IA
Cada permissão que um token de API ou aplicativo conectado pode ter, o que ela permite, qual predefinição a inclui e quais funções (proprietário, administrador, editor, criador de conteúdo) podem concedê-la.
Cada token de API e aplicativo conectado possui um conjunto de permissões (habilidades) que determinam o que um agente pode fazer no seu espaço de trabalho. Este artigo lista cada permissão, o que ela permite, qual predefinição a inclui e quais funções podem concedê-la.
Como as permissões funcionam
- Um agente atua como a pessoa que criou o token, dentro do que a função dessa pessoa permite. Ele nunca pode fazer mais do que seu proprietário poderia fazer no aplicativo, e só vê as gravações, vídeos e coleções que seu proprietário pode ver.
- Sua função determina o que você pode conceder. No assistente de token e na tela de conexão, uma permissão que sua função não pode conceder aparece esmaecida com "Sua função não pode conceder isso." (ou "Apenas proprietários, administradores e editores podem conceder permissão de publicação." para publicação). Uma predefinição que contém uma delas aparece esmaecida com "Sua função não pode conceder todas as habilidades nesta predefinição."
- A função é verificada em cada chamada, não apenas quando o token é criado. Se a função do proprietário mudar posteriormente, as chamadas que exigem uma permissão que a nova função não permite são recusadas, e o token exibe Excede a função na lista de tokens: "A função do proprietário mudou. Chamadas que precisam das habilidades riscadas são recusadas."
- Cada permissão tem um tipo, exibido como um selo no assistente: Ler, Editar, Publicar, Gerenciar ou Gasta créditos.
- Um agente só vê as ferramentas (MCP) e endpoints (REST) que suas permissões permitem. Chamar um que ele não possui retorna "Este token não possui a habilidade …."
Predefinições
A primeira etapa do assistente de token (Para que serve?) oferece predefinições. Escolher uma seleciona suas permissões; você pode alterar qualquer uma delas na próxima etapa, e o assistente então exibe Personalizado com Redefinir para predefinição.
| Predefinição | Descrição na tela | Permissões |
|---|---|---|
| Redator | "Agentes criam rascunhos; uma pessoa revisa e publica." | content:read, articles:write, changelog:write, media:write |
| Publicador | "Automação confiável que pode alterar o que os leitores veem." | Todas as permissões de sites de documentação, exceto help:read e insights:read |
| Assistente de suporte | "Respostas de documentos publicados. Nada mais." | help:read |
| Somente leitura | "Pesquisa, auditorias e verificações de tradução." | content:read |
| Analista | "Lê conteúdo e sinais do leitor para sugerir correções." | content:read, insights:read |
| Produtor | "Cria rascunhos de conteúdo e inicia trabalho pago dentro dos limites de gastos." | Redator, mais site-pages:write, library:read, videos:create, videos:export, materials:write, credits:spend, jobs:read |
| Agente do espaço de trabalho | "Tudo o que um agente pode fazer neste espaço de trabalho, dentro dos limites de gastos." | Todas as permissões, exceto help:read |
Produtor e Agente do espaço de trabalho incluem credits:spend, portanto, o assistente solicita limites de gastos na etapa Limites. Consulte Controlar gastos e aprovações de agentes.
As predefinições Redator, Publicador, Assistente de suporte, Somente leitura e Analista são para sites de documentação.
Permissões de vídeos
| Permissão | Tipo | O que permite |
|---|---|---|
library:read |
Ler | "Ler gravações, vídeos, artigos e transcrições que o proprietário pode ver": listar a biblioteca e gravações, ler um item, sua transcrição e seu artigo, e obter um código de incorporação. |
videos:create |
Editar | "Citar e solicitar vídeos, artigos a partir de gravações e traduções": solicitar uma citação e solicitar vídeos de instruções, demonstração de produto, limpeza e estilizados a partir de uma gravação, clipes sociais, artigos a partir de uma gravação e traduções de vídeo. Iniciar trabalho pago também requer credits:spend. |
videos:export |
Editar | "Exportar vídeos e obter códigos de incorporação": renderizar um MP4 em 1080p (padrão), 2K ou 4K, sempre a 60 fps, e obter um link de download. Exportações não custam créditos. |
materials:write |
Editar | "Adicionar imagens, vídeos e PDFs aos uploads do espaço de trabalho usados para novos vídeos". |
Permissões do espaço de trabalho
| Permissão | Tipo | O que permite |
|---|---|---|
credits:spend |
Gasta créditos | "Gastar créditos em trabalho cotado, dentro dos limites do token". É a segunda chave que todo início pago precisa, além da permissão para esse trabalho (por exemplo, videos:create). |
jobs:read |
Ler | "Ver trabalhos iniciados por outros tokens do proprietário". Um token sempre vê seus próprios trabalhos; isso adiciona os trabalhos de outros tokens do seu proprietário. Também permite que o agente cancele um trabalho e leia o saldo de créditos do espaço de trabalho. |
Permissões de documentos
Elas se aplicam a sites de documentação. Em Limites → Sites de documentação, um token cobre Todos os sites ("Todo site de documentação neste espaço de trabalho, incluindo os novos.") ou Sites escolhidos.
| Permissão | Tipo | O que permite |
|---|---|---|
content:read |
Ler | "Ler sites, páginas, artigos (rascunhos também), revisões, registro de alterações e páginas do site". Também configurações do site, aparência, navegação e redirecionamentos. |
articles:write |
Editar | "Criar rascunhos de artigos e editar artigos que não estão ativos". Traduzir um artigo (pago) também requer credits:spend. |
structure:write |
Editar | "Criar e editar seções, mover, ocultar e renomear páginas". |
site-pages:write |
Editar | "Editar páginas do site, como home, contato e legal". Gerar ou traduzir uma página do site com IA (pago) também requer credits:spend. |
changelog:write |
Editar | "Criar e editar entradas de registro de alterações como rascunhos". |
media:write |
Editar | "Fazer upload de imagens". |
site:publish |
Publicar | "Publicar: alterar o que os leitores veem, editar conteúdo ativo, marcar páginas como prontas". Também publicar e excluir entradas de registro de alterações e reverter um site. |
insights:read |
Ler | "Ler insights do site: lacunas de pesquisa, perguntas não respondidas e feedback da página". Com articles:write, ele também pode marcar uma lacuna como coberta. |
site:configure |
Gerenciar | "Alterar configurações do site, aparência e navegação", e adicionar redirecionamentos. |
sites:create |
Gerenciar | "Criar novos sites de documentação". |
help:read |
Ler | "Pesquisar apenas páginas públicas publicadas (assistente de suporte)". Um token com apenas esta permissão não vê mais nada. |
Quem pode conceder o quê
| Permissão | Proprietário | Administrador | Editor | Criador de Conteúdo |
|---|---|---|---|---|
content:read, help:read, insights:read, jobs:read |
Sim | Sim | Sim | Sim |
library:read |
Sim | Sim | Sim | Sim |
articles:write, structure:write, site-pages:write, changelog:write, media:write |
Sim | Sim | Sim | Sim |
videos:export |
Sim | Sim | Sim | Sim |
videos:create, materials:write, credits:spend |
Sim | Sim | Não | Sim |
site:publish, site:configure |
Sim | Sim | Sim | Não |
sites:create |
Sim | Sim | Não | Não |
Um Criador de Conteúdo pode dar a um token credits:spend, mas o trabalho pago que requer aprovação é sempre aprovado pelo proprietário do espaço de trabalho ou por um administrador, nunca apenas pelo proprietário do token. Consulte Controlar gastos e aprovações de agentes.
Ainda não disponível para agentes
Os agentes ainda não podem executar pesquisas em sites ou tutoriais gravados, nem publicar vídeos em outras plataformas. Essas permissões não podem ser concedidas.