Ferramentas

As ferramentas são usadas para conectar seu agente a sistemas externos ou código inline fornecido ao agente. 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.

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 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 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 seu agente.

Testar uma ferramenta

Antes de usar uma ferramenta no seu agente, você pode testá-la 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, use 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 usar o agente de prévia.

Ferramentas disponíveis

As seguintes ferramentas estão disponíveis:

Ferramenta Descrição
Ferramentas de função do cliente Ferramentas de código executadas no lado do cliente, não pelo agente.
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 repositório de dados do site Pesquisar informações em sites específicos conectando-se a um repositório de dados.
Ferramentas de armazenamento repositório de dados na nuvem Pesquise informações em documentos não estruturados ou conteúdo de perguntas frequentes conectando-se a um repositório de dados preenchido com seus próprios arquivos.
Ferramentas de pesquisa de arquivos Fazer upload de um arquivo ou fornecer uma base de conhecimento RAG para um agente.
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 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 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 com o usuário.

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.