As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Uso de ferramentas
Com três modelos Claude da Anthropic, você pode especificar uma ferramenta que o modelo pode usar para responder a uma mensagem. Por exemplo, você pode especificar uma ferramenta que obtenha a música mais tocada em uma estação de rádio. Se o usuário passar a mensagem Qual é a música mais popular no WZPZ? , o modelo determina que a ferramenta especificada pode ajudar a responder à pergunta. Na resposta, o modelo solicita a você executar a ferramenta em seu nome. Em seguida, você executa a ferramenta e passa o resultado da ferramenta para o modelo, que gera uma resposta para a mensagem original. Para obter mais informações, consulte Tool use (function calling)
dica
Recomendamos que você use a Converse API para integrar o uso da ferramenta ao seu aplicativo. Para obter mais informações, consulte Use uma ferramenta para concluir uma resposta do modelo do Amazon Bedrock.
Você especifica as ferramentas que deseja disponibilizar para um modelo no campo tools
. O exemplo a seguir é de uma ferramenta que obtém as músicas mais tocadas em uma estação de rádio.
[ { "name": "top_song", "description": "Get the most popular song played on a radio station.", "input_schema": { "type": "object", "properties": { "sign": { "type": "string", "description": "The call sign for the radio station for which you want the most popular song. Example calls signs are WZPZ and WKRP." } }, "required": [ "sign" ] } } ]
Quando precisa de uma ferramenta para gerar uma resposta a uma mensagem, o modelo retorna informações sobre a ferramenta solicitada, e a entrada para a ferramenta no campo content
da mensagem. Ele também define o motivo da interrupção da resposta para tool_use
.
{ "id": "msg_bdrk_01USsY5m3XRUF4FCppHP8KBx", "type": "message", "role": "assistant", "model": "claude-3-sonnet-20240229", "stop_sequence": null, "usage": { "input_tokens": 375, "output_tokens": 36 }, "content": [ { "type": "tool_use", "id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy", "name": "top_song", "input": { "sign": "WZPZ" } } ], "stop_reason": "tool_use" }
No código, você chama a ferramenta em nome das ferramentas. Em seguida, você passa o resultado da ferramenta (tool_result
) em uma mensagem do usuário para o modelo.
{ "role": "user", "content": [ { "type": "tool_result", "tool_use_id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy", "content": "Elemental Hotel" } ] }
Na resposta, o modelo usa o resultado da ferramenta a fim de gerar uma resposta para a mensagem original.
{ "id": "msg_bdrk_012AaqvTiKuUSc6WadhUkDLP", "type": "message", "role": "assistant", "model": "claude-3-sonnet-20240229", "content": [ { "type": "text", "text": "According to the tool, the most popular song played on radio station WZPZ is \"Elemental Hotel\"." } ], "stop_reason": "end_turn" }
Computer Use (Beta)
O uso do computador é um recurso de Anthropic Claude modelo (em versão beta) disponível com o Claude 3.5 Sonnet v2,Claude 3.7 Sonnet, e. Claude Sonnet 4 Claude Opus 4 Com o Computer Use, o Claude pode ajudar a automatizar tarefas por meio de ações básicas da GUI.
Atenção
O recurso de uso do computador é disponibilizado para você como um “Serviço Beta”, conforme definido nos Termos do AWS Serviço. Está sujeito ao seu Contrato AWS e aos Termos AWS de Serviço e ao modelo de EULA aplicável. Esteja ciente de que a API Computer Use apresenta riscos exclusivos que são distintos dos recursos padrão de API ou das interfaces de chat. Esses riscos aumentam ao usar a API Computer Use para interagir com a internet. Para minimizar os riscos, considere tomar precauções, como:
-
Operar a funcionalidade Computer Use em uma máquina virtual ou contêiner dedicado com privilégios mínimos para evitar acidentes ou ataques diretos ao sistema.
-
Para evitar o roubo de informações, evite fornecer à API Computer Use acesso a contas ou dados confidenciais.
-
Limitar o acesso à internet da API Computer Use aos domínios necessários para reduzir a exposição a conteúdo mal-intencionado.
-
Para garantir a supervisão adequada, mantenha uma pessoa informada sobre tarefas confidenciais (como tomar decisões que possam ter consequências significativas no mundo real) e sobre qualquer coisa que exija consentimento afirmativo (como aceitar cookies, executar transações financeiras ou concordar com os termos de serviço).
Qualquer conteúdo que você permita que o Claude veja ou acesse pode potencialmente substituir as instruções ou provocar erros no Claude ou executar ações indesejadas. Tomar as devidas precauções, como isolar o Claude de superfícies confidenciais, é essencial, inclusive para evitar riscos relacionados à injeção de prompt. Antes de habilitar ou solicitar as permissões necessárias para habilitar os recursos do Computer Use em seus próprios produtos, informe os usuários finais sobre quaisquer riscos relevantes e obtenha o consentimento deles conforme apropriado.
A API de uso do computador oferece várias ferramentas predefinidas de uso do computador para você usar. É possível criar um prompt com sua solicitação, como “enviar um e-mail para Ben com as anotações da minha última reunião” e uma captura de tela (quando necessário). A resposta contém uma lista de ações de tool_use
no formato JSON (por exemplo, scroll_down, left_button_press, screenshot). Seu código executa as ações do computador e fornece ao Claude uma captura de tela mostrando as saídas (quando solicitado).
Desde o lançamento da versão Claude 3.5 v2, o parâmetro tools foi atualizado para aceitar tipos de ferramentas polimórficas; uma tool.type
propriedade foi adicionada para diferenciá-los. type
é opcional; se omitida, a ferramenta é considerada uma ferramenta personalizada (anteriormente o único tipo de ferramenta suportado). Para acessar o uso do computador, você deve usar o anthropic_beta
parâmetro, com uma enumeração correspondente, cujo valor depende da versão do modelo em uso. Consulte a tabela a seguir para obter mais informações.
Somente solicitações feitas com esse parâmetro e enum podem usar as ferramentas de uso do computador. Ele pode ser especificado da seguinte forma: "anthropic_beta":
["computer-use-2025-01-24"]
.
Modelo | Cabeçalho beta |
---|---|
Claude 3.7 Sonnet, Claude Sonnet 4, e Claude Opus 4 | uso do computador-2025-01-24 |
Claude 3.5 Sonnet v2 | uso do computador-2024-10-22 |
Para obter mais informações, consulte Computer Use (beta)
Esta é uma resposta de exemplo que pressupõe que a solicitação continha uma captura de tela da área de trabalho com um ícone do Firefox.
{ "id": "msg_123", "type": "message", "role": "assistant", "model": "anthropic.claude-3-5-sonnet-20241022-v2:0", "content": [ { "type": "text", "text": "I see the Firefox icon. Let me click on it and then navigate to a weather website." }, { "type": "tool_use", "id": "toolu_123", "name": "computer", "input": { "action": "mouse_move", "coordinate": [ 708, 736 ] } }, { "type": "tool_use", "id": "toolu_234", "name": "computer", "input": { "action": "left_click" } } ], "stop_reason": "tool_use", "stop_sequence": null, "usage": { "input_tokens": 3391, "output_tokens": 132 } }
Anthropicferramentas definidas
Anthropicfornece um conjunto de ferramentas para permitir que determinados Claude modelos usem computadores de forma eficaz. Ao especificar uma ferramenta Anthropic definida, os tool_schema
campos description
e não são necessários nem permitidos. Anthropicas ferramentas definidas são definidas porAnthropic, mas você deve avaliar explicitamente os resultados da ferramenta e retornar o tool_results
paraClaude. Como acontece com qualquer ferramenta, o modelo não executa automaticamente a ferramenta. Cada ferramenta Anthropic definida tem versões otimizadas para modelos específicos Claude 3.5 Sonnet (novos) eClaude 3.7 Sonnet:
Modelo |
Ferramenta |
Observações |
---|---|---|
Claude Sonnet 4 e Claude Opus 4 |
|
Atualização para a |
Claude 3.7 Sonnet |
|
Inclui novas ações para um controle mais preciso Mesmos recursos da versão 20241022 Mesmos recursos da versão 20241022 |
Claude 3.5 Sonnet v2 |
|
O type
campo identifica a ferramenta e seus parâmetros para fins de validação, o name
campo é o nome da ferramenta exposto ao modelo.
Se você quiser solicitar que o modelo use uma dessas ferramentas, você pode referenciar explicitamente a ferramenta pelo name
campo. O name
campo deve ser exclusivo na lista de ferramentas; você não pode definir uma ferramenta com a name
mesma ferramenta Anthropic definida na mesma chamada de API.
Considerações de custo para uso de ferramentas
Os preços das solicitações de uso de ferramentas são calculados com base nos seguintes fatores:
-
O número total de tokens de entrada enviados ao modelo (inclusive no parâmetro tools).
-
O número de tokens de saída gerados.
As ferramentas têm o mesmo preço de todas as outras solicitações de Claude API, mas incluem tokens adicionais por solicitação. Os tokens adicionais do uso da ferramenta vêm do seguinte:
-
O
tools
parâmetro nas solicitações da API. Por exemplo, nomes, descrições e esquemas de ferramentas. -
Qualquer bloqueio
tool_use
de conteúdo nas solicitações e respostas da API. -
Qualquer bloco
tool_result
de conteúdo nas solicitações de API.
Quando você usa ferramentas, os Anthropic modelos incluem automaticamente um prompt especial do sistema que permite o uso da ferramenta. O número de tokens de uso da ferramenta necessários para cada modelo está listado na tabela a seguir. Essa tabela exclui os tokens adicionais descritos anteriormente. Observe que essa tabela pressupõe que pelo menos uma ferramenta seja fornecida. Se nenhuma ferramenta for fornecida, uma opção de ferramenta sem opção usará 0 tokens adicionais de prompt do sistema.
Modelo |
Escolha da ferramenta |
Contagem de tokens de alerta do sistema de uso de ferramentas |
---|---|---|
Claude Opus 4 |
|
346 fichas 313 fichas |
Claude Sonnet 4 |
|
346 fichas 313 fichas |
Claude 3.7 Sonnet |
|
346 fichas 313 fichas |
Claude 3.5 Sonnet v2 |
|
346 fichas 313 fichas |
Claude 3.5 Sonnet |
|
294 fichas 261 fichas |
Claude 3 Opus |
|
530 fichas 281 fichas |
Claude 3 Sonnet |
|
159 fichas 235 fichas |
Claude 3 Haiku |
|
264 fichas 340 fichas |