Conectar um sistema ao agente

Coleções resolvem conhecimento estável, como políticas, manuais e catálogos. Elas não resolvem o que muda a cada minuto: o status de um pedido, o saldo de um estoque, o chamado aberto ontem.

Para isso o Agente precisa de uma ferramenta: algo que ele aciona na hora da pergunta. Este guia decide qual caminho usar e monta a ligação.

Coleção ou ferramenta

A pergunta é se o dado tem validade.

• Coleção: o conteúdo vale por semanas ou meses. Indexar é mais barato e mais rápido na resposta.
• Ferramenta: o dado precisa ser o de agora. Cada pergunta dispara uma consulta real ao sistema.

Um mesmo Agente pode ter os dois: a política de trocas na Coleção, o status do pedido pela ferramenta.

Integração ou MCP

Escolhido o caminho da ferramenta, há dois jeitos:

• Integração, quando o serviço está no catálogo que a plataforma já conhece. Menos configuração, manutenção da plataforma.
• MCP, quando o sistema é interno ou específico do seu negócio, ou quando você precisa controlar exatamente quais ferramentas ficam expostas.

O caminho, ponta a ponta

Os dois seguem a mesma sequência de três telas, em papéis diferentes:

1. Na organização, alguém com papel de Superadmin ou Admin cadastra o servidor MCP ou a integração no catálogo, com a credencial de acesso.
2. Na gestão de workspaces, o item é associado ao workspace que vai usá-lo.
3. No workspace, ele é instalado, com nome e configuração próprios.

Entregar ao agente

Instalar no workspace ainda não entrega nada. No formulário do Agente, marque o item na seção MCPs ou Integrações.

Na seção de MCPs, ajuste também o máximo de iterações: quantas vezes o Agente pode acionar ferramentas em uma resposta. O padrão serve para a maioria; suba apenas se o Agente estiver concluindo antes de terminar o trabalho.

Escrever o prompt com ferramenta

Instruções permanentes precisam dizer quando usar a ferramenta. Sem isso, o modelo tende a responder de memória em vez de consultar.

Para qualquer pergunta sobre status, prazo ou valor de um pedido,
consulte o sistema antes de responder. Nunca estime esses dados.

Quando a ferramenta não é acionada

Em ordem de frequência:

• Não está marcada no formulário do Agente. Instalação no workspace não é entrega.
• O prompt não instrui a usá-la, e o modelo respondeu sem consultar.
• O limite de iterações foi atingido antes de completar as chamadas.
• O servidor está fora do ar. A falha aparece nos traces, em Observabilidade.

Os traces são o modo de distinguir os dois primeiros casos dos dois últimos: eles mostram se a chamada chegou a acontecer.

Segurança

Um MCP dá ao Agente a capacidade de agir em sistemas reais, não só de ler. Antes de liberar um servidor para os times, confira o resultado da análise automática em Scanner de segurança.

Próximos passos

• Registre o servidor em MCPs.
• Ou use uma conexão pronta em Integrações.