Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Uso de herramienta
Con Anthropic Claude los modelos, puede especificar una herramienta que el modelo pueda usar para responder a un mensaje. Por ejemplo, puede especificar una herramienta que obtiene la canción más popular de una emisora de radio. Si el usuario pasa el mensaje ¿Cuál es la canción más popular de WZPZ? , el modelo determina que la herramienta que especificó puede ayudar a responder la pregunta. En su respuesta, el modelo solicita que usted ejecute la herramienta en su nombre. A continuación, ejecuta la herramienta y pasa el resultado de la herramienta al modelo, que generará una respuesta para el mensaje original. Para obtener más información, consulte Uso de herramientas (llamada a funciones)
sugerencia
Le recomendamos que utilice la Converse API para integrar el uso de la herramienta en su aplicación. Para obtener más información, consulte Uso de una herramienta para completar una respuesta modelo de Amazon Bedrock.
Especifique las herramientas que quiere poner a disposición de un modelo en el campo tools. El siguiente ejemplo es de una herramienta que obtiene la canción más popular de una emisora de radio.
[ { "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" ] } } ]
Cuando el modelo necesita una herramienta para generar una respuesta a un mensaje, devuelve información sobre la herramienta solicitada y la entrada en la herramienta en el campo content del mensaje. También establece el motivo de parada de la respuesta a 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" }
En su código, llame a la herramienta en nombre de la herramienta. A continuación, pase el resultado de la herramienta (tool_result) en un mensaje de usuario al modelo.
{ "role": "user", "content": [ { "type": "tool_result", "tool_use_id": "toolu_bdrk_01SnXQc6YVWD8Dom5jz7KhHy", "content": "Elemental Hotel" } ] }
En su respuesta, el modelo utiliza el resultado de la herramienta para generar una respuesta para el mensaje 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" }
Transmisión de herramientas detallada
La transmisión de herramientas detallada es una capacidad Anthropic Claude modelo disponible con, y 4. Claude Sonnet 4 Claude Opus Con una transmisión de herramientas detallada, Claude los desarrolladores pueden transmitir los parámetros de uso de las herramientas sin almacenamiento en búfer ni validación de JSON, lo que reduce la latencia necesaria para empezar a recibir parámetros de gran tamaño.
nota
Al utilizar herramientas de transmisión pormenorizadas, es posible que recibas entradas JSON parciales o no válidas. Asegúrate de tener en cuenta estos casos extremos en tu código.
Para utilizar esta función, simplemente añade el encabezado fine-grained-tool-streaming-2025-05-14 a una solicitud de uso de la herramienta.
A continuación, se muestra un ejemplo de cómo especificar el detallado encabezado de transmisión de la herramienta:
{ "anthropic_version": "bedrock-2023-05-31", "max_tokens": 1024, "anthropic_beta": ["fine-grained-tool-streaming-2025-05-14"], "messages": [ { "role": "user", "content": "Can you write a long poem and make a file called poem.txt?" } ], "tools": [ { "name": "make_file", "description": "Write text to a file", "input_schema": { "type": "object", "properties": { "filename": { "type": "string", "description": "The filename to write text to" }, "lines_of_text": { "type": "array", "description": "An array of lines of text to write to the file" } }, "required": [ "filename", "lines_of_text" ] } } ] }
En este ejemplo, la transmisión detallada de herramientas permite a Claude transmitir las líneas de un poema largo a la llamada a la herramienta make_file sin necesidad de almacenar en búfer para validar si el parámetro es un JSON válido. lines_of_text Esto significa que puede ver el flujo de parámetros a medida que llega, sin tener que esperar a que todo el parámetro se almacene en búfer y se valide.
Con una transmisión de herramientas detallada, los fragmentos de uso de las herramientas comienzan a transmitirse más rápido y, a menudo, son más largos y contienen menos saltos de palabras. Esto se debe a las diferencias en el comportamiento de fragmentación.
Por ejemplo, sin una transmisión detallada (15 segundos de retraso):
Chunk 1: '{"' Chunk 2: 'query": "Ty' Chunk 3: 'peScri' Chunk 4: 'pt 5.0 5.1 ' Chunk 5: '5.2 5' Chunk 6: '.3' Chunk 8: ' new f' Chunk 9: 'eatur' ...
Con una transmisión pormenorizada (3 s de retraso):
Chunk 1: '{"query": "TypeScript 5.0 5.1 5.2 5.3' Chunk 2: ' new features comparison'
nota
Como la transmisión detallada envía parámetros sin almacenamiento en búfer ni validación de JSON, no hay garantía de que la transmisión resultante se complete en una cadena JSON válida. En concreto, si max_tokens se alcanza el motivo de la parada, la transmisión puede terminar a la mitad de un parámetro y puede estar incompleta. Por lo general, tendrá que escribir un soporte específico para saber cuándo max_tokens se alcanza.
Uso de computadora (Beta)
El uso del ordenador es una capacidad Anthropic Claude modelo (en versión beta) disponible con Claude 3.5 Sonnet v2, Claude 3.7 SonnetClaude Sonnet 4, y Claude Opus 4. Con Uso de computadora, Claude puede ayudarlo a automatizar tareas mediante acciones básicas de la GUI.
aviso
La función de uso del ordenador está disponible como un «servicio beta», tal como se define en las condiciones del AWS servicio. Está sujeto a su acuerdo con AWS él, a las condiciones del AWS servicio y al modelo de EULA aplicable. Tenga en cuenta que la API de Computer Use presenta riesgos únicos que son distintos de los de las características de la API estándar o de las interfaces de chat. Estos riesgos aumentan cuando se utiliza la API de Computer Use para interactuar con internet. Para minimizar los riesgos, considere tomar las siguientes precauciones:
-
Utilice la característica Uso de computadora en una máquina virtual o un contenedor específicos con privilegios mínimos para evitar ataques directos al sistema o accidentes.
-
Evitar dar a la API de Computer Use acceso a datos o cuentas confidenciales, para prevenir el robo de información.
-
Limitar el uso del ordenador y el acceso a APIs Internet a los dominios obligatorios para reducir la exposición a contenido malicioso.
-
Para garantizar una supervisión adecuada, asigne a una persona a las tareas delicadas (como la toma de decisiones que podría tener consecuencias significativas en el mundo real) y para cualquier cosa que requiera un consentimiento afirmativo (como aceptar cookies, ejecutar transacciones financieras o aceptar las condiciones del servicio).
Cualquier contenido que permita que Claude vea o acceda puede anular las instrucciones o provocar que Claude realice errores o acciones no deseadas. Es fundamental tomar las precauciones adecuadas, como aislar a Claude de las superficies sensibles, incluso para evitar los riesgos relacionados con una inyección de peticiones. Antes de habilitar o solicitar los permisos necesarios para activar las características Uso de computadora en sus propios productos, informe a los usuarios finales de los riesgos correspondientes y obtenga su consentimiento, según proceda.
La API de uso de computadoras ofrece varias herramientas de uso de computadoras predefinidas para su uso. A continuación, podrá crear una petición en la solicitud, como “envía un correo electrónico a Ben con las notas de mi última reunión” y una captura de pantalla (si es necesario). La respuesta contiene una lista de acciones de tool_use en formato JSON (por ejemplo, scroll_down, left_button_press, screenshot). El código ejecuta las acciones de la computadora y proporciona a Claude una captura de pantalla que muestra los resultados (cuando se solicita).
Desde el lanzamiento de la versión Claude 3.5 v2, el parámetro tools se ha actualizado para que acepte tipos de herramientas polimórficos; se agregó una tool.type propiedad para distinguirlos. typees opcional; si se omite, se asume que la herramienta es una herramienta personalizada (anteriormente, el único tipo de herramienta compatible). Para acceder al uso del ordenador, debe utilizar el anthropic_beta parámetro, con la enumeración correspondiente, cuyo valor depende de la versión del modelo que se utilice. Para obtener más información, consulte la siguiente tabla.
Solo las solicitudes realizadas con este parámetro y esta enumeración pueden utilizar las herramientas de uso del ordenador. Se puede especificar de la siguiente manera: "anthropic_beta":
["computer-use-2025-01-24"].
| Modelo | Cabecera beta |
|---|---|
|
Claude Opus4.1 Claude Opus 4 Claude Sonnet 4 Claude 3.7 Sonnet |
uso del ordenador-2025-01-24 |
| Claude 3.5 Sonnet v2 | uso de computadora-2024-10-22 |
Para obtener más información, consulte Uso de computadora (beta)
El siguiente es un ejemplo de respuesta donde se supone que la solicitud contiene una captura de pantalla de su escritorio con un icono de 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 } }
Anthropicherramientas definidas
Anthropicproporciona un conjunto de herramientas que permiten a determinados Claude modelos utilizar ordenadores de forma eficaz. Al especificar una herramienta Anthropic definida, los tool_schema campos description y no son necesarios ni están permitidos. AnthropicLas herramientas definidas vienen definidas porAnthropic, pero debe evaluar explícitamente los resultados de la herramienta y devolverlas tool_results aClaude. Como ocurre con cualquier herramienta, el modelo no ejecuta automáticamente la herramienta. Cada herramienta Anthropic definida tiene versiones optimizadas para modelos específicos Claude 3.5 Sonnet (nuevas) yClaude 3.7 Sonnet:
Modelo |
Herramienta |
Notas |
|---|---|---|
|
ClaudeClaude Opus4.1 ClaudeClaude Opus4 Claude Sonnet 4 |
|
Actualización a la |
|
Claude 3.7 Sonnet |
|
Incluye nuevas acciones para un control más preciso |
|
Claude 3.7 Sonnet |
|
Las mismas capacidades que la versión 20241022 |
|
Claude 3.5 Sonnet v2 |
|
Mismas capacidades que la versión 20241022 |
|
Claude 3.5 Sonnet v2 |
|
|
|
Claude 3.5 Sonnet v2 |
|
|
|
Claude 3.5 Sonnet v2 |
|
El type campo identifica la herramienta y sus parámetros con fines de validación, el name campo es el nombre de la herramienta expuesto al modelo.
Si desea solicitar al modelo que utilice una de estas herramientas, puede hacer referencia explícita a la herramienta mediante el name campo. El name campo debe ser único en la lista de herramientas; no se puede definir una herramienta con lo mismo name que una herramienta Anthropic definida en la misma llamada a la API.
Consideraciones de costo para el uso de la herramienta
El precio de las solicitudes de uso de herramientas se basa en los siguientes factores:
-
El número total de fichas de entrada enviadas al modelo (incluidas las incluidas en el parámetro de herramientas).
-
El número de tokens de salida generados.
El precio de las herramientas es el mismo que el de todas las demás solicitudes de Claude API, pero incluyen tokens adicionales por solicitud. Los tokens adicionales derivados del uso de la herramienta provienen de los siguientes:
-
El
toolsparámetro de las solicitudes de API. Por ejemplo, los nombres, las descripciones y los esquemas de las herramientas. -
Cualquier bloque
tool_usede contenido en las solicitudes y respuestas de la API. -
Cualquier bloque
tool_resultde contenido en las solicitudes de API.
Cuando se utilizan herramientas, los Anthropic modelos incluyen automáticamente un mensaje de sistema especial que permite el uso de las herramientas. El número de fichas de uso de herramientas necesarias para cada modelo se indica en la siguiente tabla. En esta tabla se excluyen las fichas adicionales descritas anteriormente. Tenga en cuenta que en esta tabla se supone que se proporciona al menos una herramienta. Si no se proporciona ninguna herramienta, si se selecciona ninguna herramienta, se utilizarán 0 símbolos de aviso del sistema adicionales.
| Modelo | Selección de herramienta | El sistema de uso de la herramienta solicita el recuento de fichas |
|---|---|---|
|
Claude Opus4.1 Claude Opus 4 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 |
auto o none |
346 |
|
Claude Opus4.1 Claude Opus 4 Claude Sonnet 4 Claude 3.7 Sonnet Claude 3.5 Sonnet v2 |
any o tool |
313 |
|
Claude 3.5 Sonnet |
auto o none |
294 |
|
Claude 3.5 Sonnet |
any o tool |
261 |
|
Claude 3 Opus |
auto o none |
530 |
|
Claude 3 Opus |
any o tool |
281 |
|
Claude 3 Sonnet |
auto o none |
159 |
|
Claude 3 Sonnet |
any o tool |
235 |
|
Claude 3 Haiku |
auto o none |
264 |
|
Claude 3 Haiku |
any o tool |
340 |
