--- title: Adicione um do catálogo description: >- Instale um agente pronto com um clique e depois ajuste sua programação, seu canal e o que ele pode acessar. sidebar: icon: package --- O catálogo é a forma mais rápida de ter um agente funcionando. Cada item é um agente completo que alguém já projetou: uma instrução que já foi testada, uma programação sensata e um conjunto de permissões que combina com a função. Você adiciona, ajusta as duas ou três coisas que são específicas do seu workspace e ele começa a rodar. Role para baixo na tela **Agents** até **Available to add**. ![O catálogo, com agentes para adicionar e os que já estão instalados marcados como adicionados](/images/agents/catalogue.webp) Cada linha mostra o nome, o slug, uma descrição de uma linha do que ele faz e quando ele roda. Algo como `MON-FRI 08:00` para um agente com horário programado, ou `ON TASK STATUS CHANGED` para um que reage a eventos. Agentes que já estão rodando no seu workspace ficam marcados como **Added** em vez de mostrar o botão Add, então você nunca instala o mesmo agente duas vezes por acidente. ## Adicionando um Aperte **Add** na linha que você quer. O Ali cria o agente no seu workspace na hora, copiando a instrução, a programação e as permissões do template. Se o agente precisa de algo que só você pode decidir, a caixa de configuração abre sozinha logo em seguida. Isso costuma acontecer quando o agente reporta para um canal: o template sabe que ele quer usar o Slack, mas não tem como saber qual é o seu canal. Um agente que ainda precisa de uma decisão carrega um marcador **Needs setup** na lista. Ele não vai rodar até você terminar de configurá-lo. ## Ajustando Seja porque a caixa abriu sozinha ou porque você apertou **Config** na linha, você chega no mesmo formulário. Quatro seções, de cima para baixo. ![A caixa de configuração, mostrando identidade, a instrução e a programação](/images/agents/config-identity.webp) **Identity** é o nome, o avatar, a descrição e a instrução. O slug fica travado assim que o agente existe, já que é por meio dele que as execuções e relatórios fazem referência de volta a ele. Tudo mais é seu para mudar, incluindo a instrução: a instrução de um template é um bom ponto de partida, não um contrato. **When it runs** é o gatilho. Um agente do catálogo chega com uma programação já definida, e os dias, o horário e o fuso horário são todos editáveis. A linha ao lado do fuso horário te mostra quantas execuções isso soma por semana, o que é uma checagem rápida antes de você ampliar uma programação. ![As seções de entrega e permissões da caixa de configuração](/images/agents/config-delivery.webp) **Where it reports** é o canal. **Inbox** joga o relatório na caixa de entrada do workspace e não precisa de mais nada. **Slack** e **Discord** pedem para você escolher um canal e só oferecem canais de uma integração que já está conectada. Se a integração estiver faltando, o campo avisa isso e te aponta para Integrations. **Email** manda para pessoas que você escolhe, usando por padrão o membro em nome de quem o agente roda. **Permissions** é o que o agente pode acessar. Mais sobre isso abaixo. ## Ligando e desligando De volta à lista, cada agente tem um interruptor. Desligado significa que o agente continua configurado, mas para de rodar: sua programação é pulada e os eventos passam por ele sem efeito. É a escolha certa quando você quer pausar algo por uma semana sem perder a configuração e o histórico. **Runs** abre o histórico. **Config** abre o formulário de novo. **Delete** no fim do formulário remove o agente definitivamente, junto com sua programação. ## O que ele pode acessar Agentes do catálogo chegam somente leitura. Isso é proposital: um agente que só lê pode errar no relatório dele, mas não pode errar nos seus dados. ![A seção de permissões, com o interruptor de escrita e as linhas por recurso](/images/agents/config-permissions.webp) O interruptor no topo, **Let this agent change data**, é o que libera a escrita. Deixe desligado e toda linha fica em Read, não importa o que você clique. Ligue e você pode elevar recursos individuais para Write, ou virar **Full access** para conceder escrita em tudo de uma vez. Quando um agente pode alterar dados, as confirmações dele são aprovadas durante a execução e toda alteração fica registrada em nome do agente, então você sempre consegue rastrear uma alteração de volta até o agente que a fez. Dashboard e Knowledge base ficam somente leitura independente do que você fizer, porque são superfícies de leitura. :::tip Rode um agente novo em modo somente leitura por alguns dias primeiro. Leia o que ele produz, refine a instrução e só depois decida se ele precisa escrever alguma coisa. A maioria dos agentes úteis nunca precisa. ::: ## Para onde ir depois Quando nenhum item do catálogo combina com a função que você tem em mente. Confira se o agente que você acabou de adicionar está fazendo o que você esperava.