O Claude é capaz de interagir com ferramentas e funções externas do lado do cliente, permitindo que você equipe o Claude com suas próprias ferramentas personalizadas para realizar uma variedade maior de tarefas.

Aprenda tudo o que você precisa para dominar o uso de ferramentas com o Claude através do nosso novo curso abrangente! Continue compartilhando suas ideias e sugestões usando este formulário.

Aqui está um exemplo de como fornecer ferramentas ao Claude usando a API de Mensagens:

​
Como funciona o uso de ferramentas

Integre ferramentas externas com o Claude nestes passos:

1

Forneça ao Claude ferramentas e um prompt do usuário

  • Defina ferramentas com nomes, descrições e esquemas de entrada em sua requisição API.
  • Inclua um prompt do usuário que possa precisar dessas ferramentas, ex., “Como está o tempo em San Francisco?”
2

Claude decide usar uma ferramenta

  • Claude avalia se alguma ferramenta pode ajudar com a consulta do usuário.
  • Se sim, Claude constrói uma requisição de uso de ferramenta formatada adequadamente.
  • A resposta da API tem um stop_reason de tool_use, sinalizando a intenção do Claude.
3

Extraia a entrada da ferramenta, execute o código e retorne resultados

  • Do seu lado, extraia o nome da ferramenta e a entrada da requisição do Claude.
  • Execute o código real da ferramenta do lado do cliente.
  • Continue a conversa com uma nova mensagem user contendo um bloco de conteúdo tool_result.
4

Claude usa o resultado da ferramenta para formular uma resposta

  • Claude analisa os resultados da ferramenta para elaborar sua resposta final ao prompt original do usuário.

Nota: Os passos 3 e 4 são opcionais. Para alguns fluxos de trabalho, a requisição de uso de ferramenta do Claude (passo 2) pode ser tudo o que você precisa, sem enviar resultados de volta ao Claude.

As ferramentas são fornecidas pelo usuário

É importante notar que o Claude não tem acesso a nenhuma ferramenta integrada do lado do servidor. Todas as ferramentas devem ser explicitamente fornecidas por você, o usuário, em cada requisição API. Isso dá a você controle total e flexibilidade sobre as ferramentas que o Claude pode usar.

A funcionalidade de uso do computador (beta) é uma exceção - ela introduz ferramentas que são fornecidas pela Anthropic mas implementadas por você, o usuário.

​
Como implementar o uso de ferramentas

​
Escolhendo um modelo

Geralmente, use Claude 3.5 Sonnet ou Claude 3 Opus para ferramentas complexas e consultas ambíguas; eles lidam melhor com múltiplas ferramentas e buscam esclarecimentos quando necessário.

Use Claude 3 Haiku para ferramentas diretas, mas note que ele pode inferir parâmetros ausentes.

​
Especificando ferramentas

As ferramentas são especificadas no parâmetro de nível superior tools da requisição API. Cada definição de ferramenta inclui:

ParâmetroDescrição
nameO nome da ferramenta. Deve corresponder ao regex ^[a-zA-Z0-9_-]{1,64}$.
descriptionUma descrição detalhada em texto simples do que a ferramenta faz, quando deve ser usada e como se comporta.
input_schemaUm objeto JSON Schema definindo os parâmetros esperados para a ferramenta.

​
Prompt do sistema para uso de ferramentas

Quando você chama a API Anthropic com o parâmetro tools, construímos um prompt especial do sistema a partir das definições de ferramentas, configuração de ferramentas e qualquer prompt do sistema especificado pelo usuário. O prompt construído é projetado para instruir o modelo a usar a(s) ferramenta(s) especificada(s) e fornecer o contexto necessário para a ferramenta operar adequadamente:

Neste ambiente você tem acesso a um conjunto de ferramentas que pode usar para responder à pergunta do usuário.
{{ INSTRUÇÕES DE FORMATAÇÃO }}
Parâmetros de string e escalares devem ser especificados como estão, enquanto listas e objetos devem usar formato JSON. Note que espaços para valores de string não são removidos. A saída não precisa ser XML válido e é analisada com expressões regulares.
Aqui estão as funções disponíveis em formato JSONSchema:
{{ DEFINIÇÕES DE FERRAMENTAS EM JSON SCHEMA }}
{{ PROMPT DO SISTEMA DO USUÁRIO }}
{{ CONFIGURAÇÃO DE FERRAMENTAS }}

[Continua na próxima parte devido ao limite de caracteres…]

VisãoUso do computador (beta)