Ferramentas

As ferramentas são usadas para conectar o agente a sistemas externos ou ao código inline fornecido a ele. Isso permite que o agente interaja com outros sistemas para buscar, atualizar, formatar ou analisar informações. As seções desta página descrevem vários tipos de ferramentas compatíveis.

Criar uma ferramenta

Para criar uma ferramenta:

1. Clique no ícone de ferramenta no lado direito do criador de agentes.
2. Selecione um tipo de ferramenta (consulte as descrições dos tipos de ferramentas neste documento).
3. Forneça as informações solicitadas para a ferramenta.
4. Use o formato snake case para o nome da ferramenta.
5. As descrições das ferramentas são fornecidas aos modelos de agente.

Usar uma ferramenta em um agente

Depois de criar uma ferramenta, você precisa instruir um agente específico a usá-la.

1. Passe o cursor sobre um agente.
2. Clique em Adicionar ferramenta.
3. Selecione uma ferramenta.
4. Descreva como a ferramenta deve ser usada nas instruções do agente.

Testar uma ferramenta

Antes de usar uma ferramenta no agente, você pode testá-la no console:

1. Abra o painel de ferramentas.
2. Clique no botão Testar ferramenta na parte de cima do painel.

3. Forneça a entrada da ferramenta conforme definido pelo esquema dela. Por exemplo, se o esquema for JSON com propriedades place e city, você poderá usar a seguinte entrada:

   {
     "place": "automobile repair center",
     "city": "austin texas"
   }
   

4. Clique em Enviar. A ferramenta é executada com a entrada, e a saída é preenchida.

Depois de testar a ferramenta diretamente, você também pode testá-la usando o agente de prévia.

Ferramentas disponíveis

As seguintes ferramentas estão disponíveis:

Ferramenta	Descrição
Agente como ferramenta	Reutilize as capabilities dos agentes sem transferir para outro agente.
Ferramentas de função do cliente	Ferramentas de código executadas no lado do cliente, não pelo agente.
Ferramentas do Confluence	Conecte seu agente a uma instância do Confluence.
Ferramentas do repositório de dados	Forneça respostas de agentes geradas por IA com base no conteúdo do site e nos dados enviados.
Ferramentas de pesquisa de arquivos	Faça upload de um arquivo ou forneça uma base de conhecimento RAG para um agente.
Ferramentas do Google Maps	Conecte seu agente ao Google Maps. Visualização
Ferramentas de pesquisa do Google	Conecte seu agente ao poder do embasamento com a Pesquisa Google.
Ferramentas do Integration Connectors	Crie ferramentas que utilizam suas conexões configuradas.
Ferramentas do Jira	Conecte seu agente a uma instância do Jira.
Ferramentas do MCP	Conecte-se a um servidor MCP.
Ferramentas da OpenAPI	Conecte-se a uma API externa usando um esquema OpenAPI.
Ferramentas de código Python	Forneça código Python como uma ferramenta para o agente.
Ferramentas do Salesforce	Conecte seu agente a uma instância do Salesforce.
Ferramentas do Service Now	Conecte seu agente a uma instância do Service Now.
Ferramentas do SharePoint	Conecte seu agente a uma instância do SharePoint.
Ferramentas do sistema	Ferramentas integradas que podem ser usadas pelo agente para realizar tarefas comuns.
Ferramentas de widget	Ferramentas de widget flexíveis para criar interações avançadas do usuário.

Tipo de execução

As ferramentas oferecem suporte a dois tipos de execução: assíncrona (sem bloqueio) e síncrona (com bloqueio). A seleção do tipo de execução adequado depende da latência da ferramenta e da experiência desejada do agente. Essa configuração está disponível na guia Avançado da configuração da ferramenta.

Tipo de execução síncrona

Esse tipo deve ser usado quando a execução da ferramenta precisa bloquear a geração de respostas do agente até que a resposta da ferramenta esteja disponível. O agente não vai gerar nenhuma resposta até que a resposta da ferramenta esteja disponível. Essas ferramentas precisam ter baixa latência (menos de 5 segundos) para manter a latência geral de resposta do agente baixa.

Tipo de execução assíncrona

Esse tipo deve ser usado para execução de ferramentas sem bloqueio. Quando uma chamada de ferramenta é acionada, o agente prossegue com uma resposta "pendente". O agente pode continuar conversando com o usuário enquanto a resposta da ferramenta está sendo buscada. Quando a resposta estiver disponível, ela será adicionada ao contexto na próxima vez que uma resposta do agente for gerada. Idealmente usado para ferramentas com latências de resposta de 5 a 60 segundos.

Fluxo de conversa para o tipo de execução assíncrona:

1. O agente aciona a chamada de função: O agente aciona uma chamada de função e está aguardando a resposta. Por exemplo, invoque a ferramenta de status do pedido.
2. Resposta pendente da ferramenta: a ferramenta retorna imediatamente uma function_response contendo um status pendente, como "status": "pending".
3. O agente processa a ferramenta pendente: o agente precisa ser instruído a processar as respostas pendentes conforme desejado. Exemplo de instrução: "Pergunte ao usuário se ele tem outras dúvidas enquanto você busca o status do pedido". Exemplo de resposta do agente: "Posso ajudar com mais alguma coisa enquanto busco o status do seu pedido?".

4. O agente processa a resposta final: a resposta real da ferramenta está disponível para o agente. Ela será incluída como uma tag de contexto. Por exemplo:

   <context>function [<tool_name>] completed with response <response JSON></context>
   

Práticas recomendadas

Use as seguintes práticas recomendadas para ferramentas:

• Sempre escreva nomes de ferramentas semanticamente significativos e relevantes para a tarefa que elas realizam.
• Sempre forneça descrições de alta qualidade das ferramentas e da tarefa ou tarefas que elas podem realizar.
• Para ferramentas assíncronas, inclua instruções detalhadas para os seguintes cenários:
  • Informe ao agente que é uma ferramenta assíncrona e que inicialmente vai retornar uma resposta pendente.
  • Inclua instruções sobre como o agente deve responder quando a ferramenta retornar "pendente".
  • Inclua instruções sobre como o agente deve responder quando a resposta real da ferramenta estiver disponível.
  • Inclua instruções sobre como o agente deve responder se a ferramenta retornar um erro.