Skip to main content
Version: 1.16.0

Ferramentas

Criando ferramentas para o agente​

  1. Crie uma pasta chamada tools dentro da pasta agents.
  2. Dentro da pasta tools, crie um arquivo TypeScript chamado getProducts.ts.
  3. Adicione o seguinte conteúdo ao arquivo getProducts.ts:
// searchProducts.ts
interface SearchProductsArgs {
query: string;
}

export default async function searchProducts(args: SearchProductsArgs) {
// Implementação para buscar produtos
return [
{ id: "1", name: "Produto 1", price: 29.99 },
{ id: "2", name: "Produto 2", price: 39.99 },
];
}

Usando ferramentas​

Você pode usar ferramentas em suas conversas com o agente. Para fazer isso, você deve adicionar a ferramenta ao agente e dar as devidas instruções a ele.

Para adicionar uma ferramenta ao agente, siga os seguintes passos:

  1. Adicione no cabeçalho do agente a seguinte linha:

    ---
    tools: searchProducts
    ---

Dessa forma, o agente agora está pronto para usar a ferramenta searchProducts. Agora bastar adicionar as instruções para o agente usar a ferramenta.

Observações​

  • As ferramentas devem ser funções.
  • As ferramentas devem ser exportadas como default.
  • Os parâmetros que forem objetos devem ser declarados como interface.
  • As ferramentas devem seguir o padrão export default function.