Ferramentas

As ferramentas são usadas para conectar seu agente a sistemas externos ou códigos em linha fornecidos a ele. Assim, seu agente pode interagir 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.

Crie 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 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 de ferramentas são fornecidas aos modelos de agentes.

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 seu agente, teste-a no console:

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

3. Forneça entradas para a 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 a Prévia do agente.

Ferramentas disponíveis

As seguintes ferramentas estão disponíveis:

Ferramenta	Descrição
Protocolo A2A	Conecte seu agente a agentes externos usando o padrão de mensagens A2A. (Visualização)
Agente como ferramenta	Reutilizar recursos de 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 de repositório de dados	Fornecer respostas de agentes geradas por IA com base no conteúdo do site e nos dados enviados.
Ferramentas de pesquisa de arquivos	Fazer upload de um arquivo ou fornecer uma base de conhecimento de RAG para um agente.
Ferramentas do Google Maps	Conecte seu agente ao Google Maps. (Visualização)
Ferramentas da Pesquisa Google	Conecte seu agente ao poder do embasamento com a Pesquisa Google.
Ferramentas do conector de integração	Crie ferramentas que utilizem 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 seu 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 ServiceNow.
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 escolha 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. O ideal é que essas ferramentas tenham 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 não bloqueadora de ferramentas. Quando uma chamada de ferramenta é acionada, o agente continua 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. Ideal 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 aguarda uma resposta. Por exemplo, invoque a ferramenta de status do pedido.
2. Resposta pendente da ferramenta: a ferramenta retorna imediatamente um function_response com 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 mais alguma dúvida 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. Isso será incluído como uma tag de contexto. 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 que sejam relevantes para a tarefa que elas realizam.
• Sempre forneça descrições de alta qualidade das suas ferramentas e das 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 vai retornar uma resposta pendente inicialmente.
  • 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.