Gerencie Agentes Personalizados com a API de Administrador
Saiba como administradores Enterprise podem usar a API de Administrador para gerenciar Agentes Personalizados, rastrear o uso de créditos e aplicar controles em todo o espaço de trabalho.
Acessar as perguntas frequentesSe você é um administrador no Plano Enterprise, pode gerenciar os Agentes Personalizados em seu espaço de trabalho com a API de Administrador. Em vez de clicar nas configurações de um agente por vez, sua equipe pode incorporar informações de agentes e de uso em suas próprias ferramentas e aplicar as mesmas regras a vários agentes de uma só vez. A API de Administrador está disponível apenas para administradores de organização Enterprise usando um token de administrador de propriedade da organização.
Veja todos os Agentes Personalizados em seu espaço de trabalho. Obtenha uma lista de todos os agentes, incluindo quem criou cada um, se está ativo, qual modelo usa, quando foi executado pela última vez e ao que tem acesso.
Rastreie quem tem acesso a um Agente Personalizado. Atualize as autorizações de compartilhamento de um agente.
Rastreie o uso de créditos. Veja quantos créditos cada agente usou e rastreie o uso de créditos em massa.
Defina limites de crédito. Defina ou altere o limite de crédito para um único agente ou defina um padrão de espaço de trabalho para todos os Agentes Personalizados.
Escolha quem pode criar agentes. Defina a política de criação de agentes do seu espaço de trabalho e pause todos os agentes em todo o espaço de trabalho, se precisar.
Desative ou ative um agente. Impeça a execução de um agente específico sem excluir sua configuração e ative-o novamente mais tarde.
Exclua um agente. Remova um agente de uso. Sua configuração é mantida para que possa ser recuperada, se necessário.
O espaço de trabalho deve estar registrado em um Plano Enterprise.
A API de Administrador usa acesso de administrador em nível de organização que sua organização configura, não tokens de integração pessoal. Para etapas de configuração, consulte a documentação para desenvolvedores →
Tudo o que a API de Administrador faz tem um controle correspondente no Notion:
O Diretório de Agentes (
Configurações→Notion AI→Agentes) mostra e gerencia os agentes em seu espaço de trabalho.O painel de controle de créditos do Notion mostra o uso de créditos dos agentes.
Os controles de criação definem quem pode criar agentes.
Use as Configurações para alterações únicas. Use a API de Administrador quando quiser automatizar essas tarefas, gerenciar muitos agentes de uma só vez ou trazer dados de uso para suas próprias ferramentas de relatório.
Incorpore o uso de créditos em relatórios internos, para que cada equipe possa ver quanto custam seus Agentes Personalizados.
Aplique os mesmos limites ou regras a vários agentes de uma só vez.
Transfira a posse de agentes que devem continuar. Desative ou remova agentes que não são mais necessários.
Perguntas frequentes
A API de Administrador aparece no registro de auditoria?
A API de Administrador aparece no registro de auditoria?
As alterações feitas por meio da API de Administrador são atribuídas ao acesso de administrador da sua organização, para que você possa acompanhar o que foi alterado e quando. Saiba mais sobre registros de auditoria →
Onde posso encontrar as referências completas da API?
Onde posso encontrar as referências completas da API?
A referência completa, incluindo as etapas de configuração, encontra-se na documentação para desenvolvedores →
