Agentes Personalizados

Agentes personalizados automatizam fluxos de trabalho manuais e recorrentes para toda a sua equipe. Eles são executados automaticamente em segundo plano com base em gatilhos definidos, usando seus documentos e bases de dados existentes como contexto.

Basta configurá-los uma vez — criando um fluxo de trabalho para tarefas repetitivas, como relatórios semanais ou triagem de feedback —, e eles se tornarão um recurso compartilhado em que toda a equipe pode confiar.

Agentes personalizados vivem dentro do Notion e funcionam de acordo com suas instruções. Depois de configurá-los, eles podem:

• Ler as páginas e bases de dados do Notion e alguns aplicativos conectados.

• Ser executados por gatilhos recorrentes e eventos do espaço de trabalho.

• Realizar ações como publicar relatórios, registrar bugs, atualizar registros ou enviar mensagens.

Ao contrário do Agente do Notion, os agentes personalizados são projetados para execução automática em segundo plano com base em gatilhos e cronogramas.

Agentes personalizados são integrados diretamente ao Notion. Agentes personalizados usam seus documentos e bases de dados existentes como contexto e se conectam ao Slack, aumentando a produtividade. Com Agentes personalizados, você pode:

• @mencionar agentes em páginas, propriedades de bases de dados e comentários do Notion.

• Anexá-los a eventos da base de dados (por exemplo, quando uma página é criada ou atualizada).

• Deixe que eles monitorem seu espaço de trabalho e as ferramentas conectadas de acordo com os gatilhos que você configurar.

Use gatilhos para que os Agentes personalizados sejam executados sem que você precise iniciá-los manualmente todas as vezes. Defina um gatilho uma vez e o trabalho acontecerá continuamente em segundo plano.

• Execute-os com base em um cronograma (diário, semanal, mensal e muito mais).

• Reaja a eventos no Notion e no Slack.

• Continue operando em segundo plano depois de publicá-los.

Isso possibilita fluxos de trabalho automatizados, como relatórios regulares, filas de triagem e manutenção de conhecimento, ajudando você a recuperar seu tempo.

Os agentes agem apenas nas páginas, bases de dados e aplicativos externos aos quais você concede acesso explicitamente. Eles nunca têm acesso total ao espaço de trabalho por padrão, o que reduz o risco.

• Controle quem pode editar, executar ou interagir com cada agente.

• Visualize os registros de atividades para ver o que um agente fez e quando.

• Use o histórico de versões para revisar ou restaurar configurações anteriores.

• Mantenha as execuções revisáveis e reversíveis para que você possa iterar com segurança.

Alterações importantes de configuração e acesso nos Agentes personalizados (como atualizações de instruções, mudanças de permissão e adições de integração) são registradas no registro de auditoria do Notion. Isso ajuda os administradores Enterprise a rastrear alterações nos agentes para revisões de segurança e conformidade.

• Você deve estar no plano Business ou Enterprise do Notion. Saiba mais sobre preços para Agentes personalizados.

• Use o computar ou a Web para criar, editar, ver ou interagir com Agentes personalizados.

Você pode criar um Agente personalizado a partir de vários locais. O principal ponto de entrada é a seção Agentes na barra lateral.

1. Acesse a seção Agentes, na barra lateral, e selecione + para criar um agente personalizado.

2. Escolha como deseja começar:

• Criar com o chat de IA

  • No chat, descreva em linguagem natural o que você deseja que o agente faça.

  • Revise as instruções, os gatilhos e o acesso que a IA do Notion gera e itera.

  • Salve.

• Criar a partir de um modelo

  • Escolha um modelo.

  • Revise as instruções, os gatilhos e o acesso que a IA do Notion gera e itera.

  • Salve.

• Criar do zero

  • Selecione Criar em branco.

  • Use um campo de instruções vazio ou inicie uma conversa.

  • Crie suas instruções manualmente, seguindo as melhores práticas para instruções claras e concretas. Defina o que o Agente deve fazer, como ele deve se comportar e qual trabalho ele deve realizar.

  • Defina os gatilhos, o acesso e o seu modelo de IA até que eles correspondam ao seu fluxo de trabalho.

  • Salve.

Os gatilhos determinam quando seu agente é executado. Você pode combinar vários tipos de gatilhos para um único agente. Você também pode usar filtros para ajudar seu agente a ser executado apenas nas páginas ou mensagens que lhe interessam, ou apenas quando certas condições definidas por você forem atendidas (por exemplo, um status específico ou uma palavra-chave).

Use agendamentos recorrentes para executar agentes em uma cadência específica.

1. Abra as Configurações do seu agente personalizado.

2. Acesse a seção Gatilhos.

3. Adicione um gatilho Recorrente.

4. Escolha quando você deseja que o agente seja executado:

   • Escolha a frequência (diária, semanal, mensal ou anual).

   • Defina um horário específico, incluindo o fuso horário (por exemplo, “todos os dias à meia-noite no fuso PST”).

5. Revise o próximo horário de execução agendado para confirmar se o cronograma está correto.

6. Salve o gatilho.

Os gatilhos do Notion executam seu agente com base em eventos no seu espaço de trabalho. Você pode acionar agentes quando:

• Um comentário é adicionado a uma página.

• Uma página é adicionada a uma base de dados.

• Uma propriedade é atualizada em uma base de dados.

• Uma página é removida de uma base de dados.

Alguns gatilhos do Notion permitem que você adicione filtros, como buscar valores de propriedade específicos ou limitar as execuções a páginas em uma visualização específica da base de dados.

Para adicionar um gatilho do Notion:

1. Abra as Configurações do agente personalizado e selecione Gatilhos.

2. Escolha um tipo de gatilho do Notion.

3. Especifique:

   • A página ou base de dados a ser observada.

   • O evento (por exemplo, “página criada na base de dados”).

   • Filtros ou condições opcionais (por exemplo, um valor de status específico ou uma visualização de base de dados).

4. Salve.

Os gatilhos do Slack permitem que os agentes observem eventos em canais públicos e privados do Slack.

Requisitos de configuração

Antes de configurar um gatilho do Slack, um administrador do workspace do Slack deve primeiro conectar o Slack ao workspace do Notion. Isso concede acesso a todos os canais públicos e determina se o Notion AI pode acessar canais privados. Se você quiser trabalhar com um canal privado, também precisará autorizar sua conta do Slack.

Os Agentes personalizados podem monitorar:

• Uma mensagem publicada em um canal.

• Uma reação de emoji adicionada a uma mensagem.

• O Agente personalizado mencionado em uma mensagem.

Anotação: Para acionar um agente mencionando-o com @ no Slack, o administrador do seu workspace do Slack deve primeiro permitir que todos os membros criem grupos de usuários. Assim que essa configuração for ativada, qualquer pessoa poderá acionar o agente mencionando seu nome no canal do Slack associado.

Ao configurar qualquer um dos gatilhos acima, você pode optar por incluir respostas em threads para que o agente responda a mensagens dentro de threads, e não apenas a mensagens de nível superior.

Você pode reduzir o ruído em canais de alto tráfego especificando palavras-chave ou frases para acionar o gatilho.

Para adicionar um gatilho do Slack:

1. Conecte o Slack ao agente durante a configuração, se ainda não tiver feito isso.

2. Em Gatilhos, adicione um gatilho do Slack.

3. Selecione:

   • O tipo de evento.

   • O canal a ser monitorado.

   • Filtros opcionais (por exemplo, acionar apenas quando uma mensagem contiver uma palavra-chave ou frase específica).

4. Salve.

Sempre que um Agente Personalizado é acionado no Slack, ele pode exibir um indicador de digitação (“Trabalhando nisso...”) para sinalizar que está processando a solicitação. Isso nem sempre significa que o agente responderá. Você pode desativar isso a qualquer momento acessando as configurações de gatilho.

Para desativar o indicador de digitação:

1. Acesse o seu agente personalizado.

2. Em Gatilhos, selecione o gatilho do Slack.

3. Selecione Mais configuraçõese desmarque a opção Exibir indicador de digitação no Slack.

Agentes Personalizados usam apenas o conteúdo ao qual você concede acesso explicitamente para o trabalho deles. Você configura isso nas configurações de acesso de cada Agente.

Para controlar o que um agente pode ver no Notion:

1. Abra as Configurações do agente personalizado.

2. Entre na seção Ferramentas e acesso.

3. Adicione páginas ou bases de dados específicas que o agente deve usar como contexto:

   • Adicione páginas e bases de dados focadas para fluxos de trabalho direcionados (por exemplo, “Tickets de clientes”, “Bugs”, “Incidentes”).

   • Libere acesso a Páginas compartilhadas com todos no Notion se quiser garantir uma cobertura ampla que inclua conteúdo em todo o espaço de trabalho.

4. Mantenha o acesso restrito a “nenhum” ou a um pequeno conjunto de páginas se quiser um escopo mais restrito.

Agentes podem, opcionalmente, navegar na web quando necessário. Use o acesso à web quando seu fluxo de trabalho depender de informações externas. Mantenha-o desativado para fluxos de trabalho estritamente internos ou quando desejar um controle mais rigoroso sobre as fontes. Para controlar o acesso à web:

1. Abra as Configurações do seu agente.

2. Encontre a opção de acesso à web .

3. Ative o acesso à web para que o agente busque informações na internet.

4. Desative o acesso à web para restringir o agente apenas ao Notion e aos aplicativos configurados.

Os agentes personalizados podem ler e escrever no Slack por meio de uma integração dedicada.

Antes de conectar o Slack ao seu Agente personalizado, um administrador deve primeiro conectar o espaço de trabalho do Slack ao seu espaço de trabalho do Notion por meio do conector IA do Slack.

Depois de conectados, os Agentes personalizados podem:

• Ler mensagens em canais públicos e privados selecionados.

• Publicar mensagens, respostas e atualizações apenas nos canais específicos que você selecionar.

• Reagir a threads e usar informações do Slack como contexto.

Como conceder aos agentes personalizados acesso ao Slack

• Ao configurar o Agente personalizado, use o prompt para conectar o Slack.

• Confirme que a conta do Slack usa o mesmo e-mail que a sua conta do Notion.

• Aprove os escopos solicitados no fluxo de autorização do Slack.

• Escolha quais canais o agente pode acessar.

Você também pode se conectar a Agentes personalizados se a sua organização usar o Slack Enterprise Grid.

Agentes Personalizados podem ser executados em diferentes modelos de linguagem de grande escala. Isso permite que você equilibre velocidade, custo e qualidade. Você pode ajustar o modelo ao longo do tempo se seu fluxo de trabalho mudar ou se você perceber necessidades de desempenho diferentes.

Os modelos suportados incluem Claude Fable 5 (apenas planos Business e Enterprise), Claude Sonnet 5, GPT, Gemini e Grok. Auto é o padrão recomendado.

O Claude Fable 5 funciona melhor para tarefas como pesquisa aprofundada, escrita complexa e tarefas que envolvem muitas etapas. Antes que qualquer pessoa no seu workspace possa usá-lo, um administrador precisa ativá-lo. Isso ocorre porque a Anthropic lida com os dados desse modelo de forma um pouco diferente dos outros modelos (veja abaixo). Se você quiser acesso, peça ao seu administrador para ativá-lo em Configurações → Notion AI.

Uma observação sobre o tratamento de dados: Ao usar o Claude Fable 5, a Anthropic pode armazenar seus prompts e respostas por um período de tempo para manter o modelo seguro e funcionando bem. Outros modelos de IA disponíveis no Notion não funcionam dessa maneira. É por isso que seu administrador precisa revisar e ativá-lo primeiro.

Saiba como o uso é monitorado no painel de créditos do Notion.

Para escolher um modelo:

1. Abra as Configurações do seu agente personalizado.

2. Acesse a seção Modelo .

3. Selecione um modelo específico, se quiser um comportamento padronizado, ou selecione o automático para que o Notion escolha o melhor modelo a cada solicitação.

4. Salve.

Para ativar o Claude Fable 5 para seu espaço de trabalho (apenas administradores):

1. Acesse Configurações → IA do Notion.

2. Encontre o Claude Fable 5 e ative-o.

O Claude Fable 5 está disponível apenas para os planos Business e Enterprise. Depois de ativado, qualquer pessoa no espaço de trabalho pode selecioná-lo no seletor de modelos nas configurações do Agente do Notion ou do Agente Personalizado.

Os agentes personalizados funcionam como páginas do Notion na hora de compartilhar com outras pessoas do seu espaço de trabalho, mas com algumas diferenças.

Quando compartilhados, os agentes podem aparecer na barra lateral em uma seção de agentes, nos resultados de pesquisa e em qualquer área do espaço de trabalho que liste ou faça referência a agentes.

Para compartilhar um agente:

1. Abra o Agente personalizado.

2. Clique em Compartilhar.

3. Adicione pessoas, grupos ou todo o espaço de trabalho.

Os agentes usam um conjunto simplificado de níveis de permissão:

• Acesso totalUsuários com permissões de acesso total a um agente podem configurar instruções, gatilhos, acesso e modelos, visualizar, além de gerenciar registros de atividades e executar ou interagir com o agente.

• Pode editarUsuários com permissões Pode editar agente conseguirão modificar instruções e configurações, além de revisar atividades.

• Pode visualizar e interagirUsuários com permissões Pode visualizar e interagir em um agente conseguemexecutar o agente e conversar com ele, bem como visualizar a página Configurações (Gatilhos, Instruções, Ferramentas e Acesso) no modo somente leitura. Eles não podem editar ou compartilhar o agente.

Assim que seu Agente Personalizado for criado, ele aparecerá na barra lateral. Cada página de Agente Personalizado tem três guias principais. Use essas guias juntas para projetar, testar e manter um agente ao longo do tempo.

1. Chat Uma área de conversa individual, privada ou compartilhada para o agente específico.

   • Isso é útil para testar novas instruções, pedir ao agente para executar tarefas únicas e iterar o comportamento.

2. Atividade Um registro de cada execução do agente visível para usuários com acesso total.

   • Os registros incluem o que acionou a execução, as ações tomadas e quaisquer erros ou falhas.

3. Configurações O centro de controle do agente.

   • O painel Configurações inclui Instruções do agente, Gatilhos, permissões de acesso e seleção de modelos.

1. Abra a página Agente.

2. Acesse a guia Configurações.

3. Atualize as Instruções, os Gatilhos, o acesso a páginas, bases de dados e ferramentas externas ou a seleção de modelos.

4. Salve e publique suas alterações.

5. Use a guia Chat e a guia Atividade para verificar se o agente se comporta conforme o esperado após as edições.

Para restaurar uma versão anterior do seu agente personalizado:

1. Abra a página Agente.

2. Acesse o histórico da versão.

3. Revise as versões anteriores para ver:

   • Quem fez as alterações.

   • Quando foram feitas.

   • O que mudou em cada versão.

4. Selecione a versão que você deseja restaurar.

5. Confirme para reverter o agente a essa versão.

Duplicar um Agente Personalizado permite que você copie um agente que já existe e o adapte para um fluxo de trabalho semelhante, sem precisar criá-lo do zero.

Para duplicar um Agente Personalizado:

1. Abra o Agente Personalizado que você deseja copiar.

2. Selecione ••• e escolha Duplicar.

A duplicata é aberta como um agente privado. Você pode revisar e atualizar suas configurações antes de compartilhar ou publicar.

O que você precisa para duplicar um agente

• Autorização para visualizar e interagir com o agente original.

• Permissão para criar Agentes Personalizados sob os controles de administrador do seu espaço de trabalho. Verifique com o administrador do seu espaço de trabalho se não tiver certeza.

O que é transferido

• Nome: A duplicata é nomeada como {Original agent name} (1). Você pode renomeá-la a qualquer momento.

• Modelo de IA: a duplicata usa o mesmo modelo de IA que o original.

• Instruções: Copiadas para uma nova página. Se algum link nas instruções levar a páginas às quais você não tem acesso, ele aparecerá como um chip sem acesso e não será adicionado aos recursos da duplicata.

• Páginas e bases de dados: Qualquer conteúdo do Notion usado pelo agente original ao qual você também tenha acesso será transferido. O conteúdo ao qual você não tem acesso não será incluído.

• Gatilhos: Gatilhos que usam recursos aos quais você tem acesso serão transferidos. Se um gatilho depender de algo que você não pode acessar (como um canal do Slack do qual você não faz parte), esse gatilho não será incluído na duplicata.

O que configurar após a duplicação

• Ferramentas conectadas (como o Slack): A duplicata não herda nenhuma conexão de ferramenta. Você precisará reconectar ferramentas como o Slack na nova cópia.

• Workers: Se o agente original tinha Workers configurados, você precisará configurá-los novamente. Eles não são transferidos automaticamente.

• Histórico de execução: a duplicata começa do zero, sem execuções anteriores ou atividades do original.

• Limites de créditos: quaisquer limites de créditos definidos no original não se aplicarão à duplicata.

Padrão de privacidade

O duplicado é privado por padrão, apenas você pode visualizá-lo. Compartilhe-o pelo menu Share quando estiver pronto.

Se você tiver Acesso completo a um Agente personalizado, poderá exportar seus chats e threads de Insights como um arquivo CSV para análise ou relatório fora do Notion.

Para exportar:

1. Abra o Agente personalizado e vá para a guia Insights.

2. Selecione o período que você deseja exportar.

3. Passe o mouse sobre o botão de exportação → Selecione Export as CSV.

O CSV corresponde às colunas na página All chats. As exportações são limitadas a até 300 chats para o período selecionado.