Seleziona le tue preferenze relative ai cookie

Utilizziamo cookie essenziali e strumenti simili necessari per fornire il nostro sito e i nostri servizi. Utilizziamo i cookie prestazionali per raccogliere statistiche anonime in modo da poter capire come i clienti utilizzano il nostro sito e apportare miglioramenti. I cookie essenziali non possono essere disattivati, ma puoi fare clic su \"Personalizza\" o \"Rifiuta\" per rifiutare i cookie prestazionali.

Se sei d'accordo, AWS e le terze parti approvate utilizzeranno i cookie anche per fornire utili funzionalità del sito, ricordare le tue preferenze e visualizzare contenuti pertinenti, inclusa la pubblicità pertinente. Per continuare senza accettare questi cookie, fai clic su \"Continua\" o \"Rifiuta\". Per effettuare scelte più dettagliate o saperne di più, fai clic su \"Personalizza\".

Scelta di uno strumento

Modalità Focus
Scelta di uno strumento - Amazon Nova

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

I modelli Amazon Nova supportano la funzionalità di scelta degli strumenti. La scelta dello strumento ti consente, in qualità di sviluppatore, di controllare il modo in cui viene chiamato uno strumento. Sono supportate tre opzioni di parametro per la scelta dello strumento: toolany, eauto.

  • Strumento: lo strumento specificato verrà chiamato una sola volta.

  • Qualsiasi: uno degli strumenti forniti verrà chiamato almeno una volta.

  • Automatico: il modello deciderà se richiamare uno strumento e, se necessario, verranno richiamati più strumenti.

Tool

L'utilizzo tool come strumento di scelta consente di controllare lo strumento specifico richiamato dal modello. L'esempio seguente evidenzia questo aspetto con un caso d'uso di output strutturato in cui è necessario che la risposta sia formattata in modo coerente.

tool_config = { "toolChoice": { "tool": { "name" : "extract_recipe"} }, "tools": [ { "toolSpec": { "name": "extract_recipe", "description": "Extract recipe for cooking instructions", "inputSchema": { "json": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the recipe" }, "description": { "type": "string", "description": "Brief description of the dish" }, "ingredients": { "type": "array", "items": { "type": "string", "description": "Name of ingredient" } } }, "required": ["name", "description", "ingredients"] } } } } ] }
Any

L'utilizzo any come strumento di scelta consente di garantire che venga chiamato almeno uno strumento ogni volta. Sebbene la decisione su quale utensile richiamare sia lasciata al modello, verrà sempre restituito un utensile. L'esempio seguente evidenzia l'utilizzo di toolchoice any per un caso d'uso di un endpoint di selezione delle API. Questo è un esempio di quando è utile richiedere al modello di restituire uno strumento specifico.

tool_config = { "toolChoice": { "any": {} }, "tools": [ { "toolSpec": { "name": "get_all_products", "description": "API to retrieve multiple products with filtering and pagination options", "inputSchema": { "json": { "type": "object", "properties": { "sort_by": { "type": "string", "description": "Field to sort results by. One of: price, name, created_date, popularity", "default": "created_date" }, "sort_order": { "type": "string", "description": "Order of sorting (ascending or descending). One of: asc, desc", "default": "desc" }, }, "required": [] } } } }, { "toolSpec": { "name": "get_products_by_id", "description": "API to retrieve retail products based on search criteria", "inputSchema": { "json": { "type": "object", "properties": { "product_id": { "type": "string", "description": "Unique identifier of the product" }, }, "required": ["product_id"] } } } } ] }
Auto

L'utilizzo auto come strumento di scelta è la funzionalità predefinita del supporto utensili e consente al modello di decidere quando chiamare uno strumento e quanti strumenti chiamare. Questo è il comportamento se non includete la scelta dello strumento nella richiesta.

Nota

Il comportamento predefinito delle chiamate agli strumenti di Amazon Nova consiste nell'utilizzare la catena di pensiero per la selezione degli strumenti. Quando si utilizza il comportamento o la scelta dello strumento di defaultauto, nei <thinking>tag verrà visualizzato anche l'output del processo di pensiero.

L'esempio seguente evidenzia un caso d'uso di un chatbot in cui potresti voler consentire al modello di cercare su Internet informazioni recenti o di rispondere direttamente all'utente. Questa scelta di strumenti offre flessibilità e lascerà il ragionamento al modello.

tool_config = { "toolChoice": { "auto": {} }, "tools": [ { "toolSpec": { "name": "search", "description": "API that provides access to the internet", "inputSchema": { "json": { "type": "object", "properties": { "query": { "type": "string", "description": "Query to search by", }, }, "required": ["query"] } } } } ] }

L'utilizzo tool come strumento di scelta consente di controllare lo strumento specifico richiamato dal modello. L'esempio seguente evidenzia questo aspetto con un caso d'uso di output strutturato in cui è necessario che la risposta sia formattata in modo coerente.

tool_config = { "toolChoice": { "tool": { "name" : "extract_recipe"} }, "tools": [ { "toolSpec": { "name": "extract_recipe", "description": "Extract recipe for cooking instructions", "inputSchema": { "json": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the recipe" }, "description": { "type": "string", "description": "Brief description of the dish" }, "ingredients": { "type": "array", "items": { "type": "string", "description": "Name of ingredient" } } }, "required": ["name", "description", "ingredients"] } } } } ] }
PrivacyCondizioni del sitoPreferenze cookie
© 2025, Amazon Web Services, Inc. o società affiliate. Tutti i diritti riservati.