Conecte agentes de IA aos seus sites de documentação
Deixe o Claude Code, Codex, ChatGPT ou seus próprios scripts redigirem, organizarem e publicarem páginas de sites de documentação. Planos (Pro e superiores), permissões de sites de documentação, escopo de sites e regras de publicação, com links para os guias completos de agentes de IA e API.
Agentes de IA como Claude Code, Codex, Cursor, Claude ou ChatGPT podem ler e escrever em seus sites de documentação para você: redigir artigos, corrigir páginas com baixa avaliação dos leitores, responder a lacunas de conteúdo, traduzir ou publicar. Este artigo aborda o que é específico para sites de documentação. Tokens, conectores, gastos e erros são explicados em Agentes de IA e API.
Antes de começar
- Agentes de IA e API estão disponíveis nos planos Pro, Negócios e Personalizado, incluindo conectores para Claude e ChatGPT. Os planos Gratuito e Starter não incluem esse recurso; tokens e aplicativos param de funcionar se um espaço de trabalho for migrado para um deles.
- Um agente atua como a pessoa que criou seu token ou o conectou, dentro da função dessa pessoa. Ele nunca pode fazer mais em um site do que ela poderia.
- Chamadas de API não custam créditos. Traduzir páginas e gerar páginas de site com IA custam créditos, e apenas com um token que possa gastá-los.
Conectar um agente
Abra o menu do espaço de trabalho e escolha Agentes de IA e API, ou escolha Agentes de IA e API no menu Configurações de um site de documentação (isso abre a atividade para aquele site).
- Token de API para Claude Code, Codex, Cursor ou um script: Tokens → Novo token, depois um assistente de quatro etapas (Finalidade, Permissões, Limites, Revisar). Escolha uma predefinição de site de documentação como Redator ou Publicador, escolha os sites em Limites → Sites de documentação e copie o token, que é exibido apenas uma vez. Veja Criar um token de API.
- Conector para Claude.ai ou ChatGPT: cole a URL do conector de Aplicativos conectados no aplicativo, faça login e escolha os Websites e o Acesso. Veja Conectar aplicativos e agentes de IA.
Predefinições de sites de documentação
| Predefinição | Descrição na tela | Para |
|---|---|---|
| Redator | "Agentes redigem; uma pessoa revisa e publica." | Redigir artigos e entradas de changelog, fazer upload de imagens |
| Publicador | "Automação confiável que pode alterar o que os leitores veem." | Tudo para sites de documentação, incluindo publicação, configurações e criação de sites |
| Assistente de suporte | "Respostas de documentos publicados. Nada mais." | Um bot de ajuda que pesquisa apenas páginas públicas publicadas |
| Somente leitura | "Pesquisa, auditorias e verificações de tradução." | Ler conteúdo |
| Analista | "Lê conteúdo e sinais dos leitores para sugerir correções." | Ler conteúdo e insights |
Produtor e Agente do espaço de trabalho adicionam vídeos e gastos de créditos. Cada permissão e quem pode concedê-la: Permissões de agente.
Permissões de sites de documentação
| Permissão | Permite |
|---|---|
content:read |
Ler sites, páginas, artigos (rascunhos também), revisões, o changelog e páginas de site |
articles:write |
Criar rascunhos de artigos e editar artigos que não estão ativos |
structure:write |
Criar e editar seções; mover, ocultar e renomear páginas |
site-pages:write |
Editar páginas de site como home, contato e legal |
changelog:write |
Criar e editar entradas de changelog como rascunhos |
media:write |
Fazer upload de imagens |
site:publish |
Publicar: alterar o que os leitores veem, editar conteúdo ativo, marcar páginas como prontas |
insights:read |
Ler lacunas de pesquisa, perguntas sem resposta e feedback de página |
site:configure |
Alterar configurações de site, aparência e navegação |
sites:create |
Criar novos sites de documentação |
help:read |
Pesquisar apenas páginas públicas publicadas (para um assistente de suporte) |
A leitura é aberta a qualquer membro. Escrita e organização: proprietário, administradores, editores e Criadores de Conteúdo. Publicação e configurações de site: proprietário, administradores e editores ("Apenas proprietários, administradores e editores podem conceder permissão de publicação."). Criação de sites: proprietário e administradores.
Quais sites um token cobre
Em Limites → Sites de documentação, escolha Todos os sites ("Cada site de documentação neste espaço de trabalho, incluindo os novos.") ou Sites escolhidos. Um token ou aplicativo conectado apenas vê e altera os sites que cobre. Se um artigo também aparecer em um site fora do seu escopo, a alteração é recusada: "Este artigo também é exibido em um site que este token não pode alterar."
Conteúdo ativo precisa de direitos de publicação
Sem site:publish, um agente não pode alterar o que os leitores veem. Editar um artigo que está ativo é recusado ("Este conteúdo está ativo em um site publicado, portanto, alterá-lo requer a capacidade site:publish"), e o agente pode enviar seu rascunho para revisão. Você recebe uma notificação, "agente solicitou revisão de página em site": "Nada foi publicado. Leia o artigo e publique-o quando estiver pronto."
Cada alteração que um agente faz aparece no histórico da página como "Agente nome (token)". As publicações são limitadas a 10 por hora por token. Um site pausado é somente leitura para agentes: "Este site está pausado ou offline e é somente leitura."
O que os agentes podem fazer em um site
Listar sites e ler a árvore de páginas, pesquisar e ler páginas, visualizar Markdown, criar e atualizar artigos, enviá-los para revisão, organizar seções e páginas, editar páginas de site e o changelog, fazer upload de imagens, ler insights e marcar lacunas como cobertas, alterar configurações, aparência, navegação e redirecionamentos, criar sites, traduzir páginas, gerar páginas de site, publicar e reverter. Cada um precisa da permissão correspondente.