Agentes personalizados

Os agentes personalizados automatizam os fluxos de trabalho manuais e recorrentes para toda a sua equipe. Eles são executados automaticamente em segundo plano de acordo com gatilhos definidos usando seus documentos e bases de dados 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.

Os agentes personalizados estão dentro do Notion e seguem as suas instruções. Depois de configurados, 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.

Os agentes personalizados são criados diretamente no Notion. Os agentes usam seus documentos e suas bases de dados como contexto e se conectam ao Slack, aumentando a produtividade. Com os 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 entrem em ação 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 atuam apenas nas páginas, bases de dados e aplicativos externos aos quais você concede acesso explicitamente. Por padrão, eles nunca têm acesso total ao espaço de trabalho, 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.

• É necessário ter o Plano Business ou Enterprise do Notion. Saiba mais sobre os preços dos Agentes personalizados.

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

Você pode criar um agente personalizado diretamente 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.

  • Elabore as instruções manualmente, seguindo as práticas recomendadas para ter instruções claras e concretas. Defina o que o agente deve fazer, como deve se comportar e qual trabalho 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 o agente é executado. Você pode combinar vários tipos de gatilhos para um único agente.

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 o 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 página é atualizada em uma base de dados.

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

• O agente personalizado é @mencionado em uma página ou comentário.

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 adicionais, se disponíveis.

4. Salve.

Os gatilhos do Slack capacitam os agentes a observar eventos em canais públicos do Slack. Não há suporte para canais privados.

Requisitos de configuração

Antes de configurar um gatilho do Slack, um administrador do espaço de trabalho do Slack deve primeiro ativar a integração do Notion para Agentes personalizados. Isso dá aos agentes personalizados as permissões de leitura e gravação necessárias para operar no Slack. Depois que a integração estiver habilitada, você poderá configurar gatilhos com base em novas mensagens ou reações de emojis.

Os agentes podem monitorar:

• Uma mensagem publicada em um canal.

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

• Uma thread iniciada em um canal.

• O Agente personalizado mencionado em uma mensagem.

  • Observação: para acionar um agente mencionando-o no Slack, o administrador do espaço de trabalho do Slack deve primeiro permitir que todos os membros criem grupos de usuários. Depois que essa configuração estiver ativada, qualquer pessoa poderá acionar o agente mencionando o nome do canal do Slack associado.

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 ou condições adicionais, se disponíveis.

4. Salve.

Os agentes personalizados usam apenas o conteúdo ao qual você concede acesso explícito para o trabalho deles. Defina 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.

Os agentes podem, opcionalmente, navegar na web quando necessário. Use o acesso à web quando o seu fluxo de trabalho depender de informações externas. Mantenha-o desativado em fluxos de trabalho estritamente internos ou quando você quiser 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 agente personalizado, um administrador deve primeiro integrar o conector IA do Slack ao seu espaço de trabalho nas Configurações de IA do Notion. Os agentes podem fazer o seguinte:

• Ler canais públicos.

• Publicar mensagens, respostas e atualizações nos canais.

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

Para conectar o Slack:

1. Ao configurar o agente, use o prompt para conectar o Slack.

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

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

4. Escolha quais canais o agente pode acessar.

Os agentes personalizados podem ser executados em diversos grandes modelos de linguagem. Com isso, você equilibra velocidade, custo e qualidade. Você pode ajustar o modelo com o passar do tempo se o fluxo de trabalho mudar ou se você notar diferentes necessidades de desempenho. Os modelos compatíveis incluem Claude, GPT e Gemini. O modo automático é o padrão recomendado.

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.

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.

Depois que o agente personalizado for criado, ele aparecerá na barra lateral. Cada página do agente personalizado tem três guias principais. Use-as juntas para elaborar, 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.