Modifica quantità nel carrello

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Non essendoci annotazioni, la descrizione è l'unica fonte di trasparenza. Rivela il comportamento importante che 'quantità zero rimuove l'articolo', ma non dettaglia altri aspetti come autenticazione, gestione errori o impatto sulla sessione. Fornisce un minimo di trasparenza comportamentale.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Due frasi concise, con l'azione principale subito all'inizio e l'eccezione importante nella seconda frase. Nessuna parola superflua.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Lo strumento è semplice ma la descrizione non menziona prerequisiti (es. sessione attiva) o comportamento in caso di ASIN non presente nel carrello. Copre l'azione principale e il caso limite della quantità zero, ma non è completamente esaustivo.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

La descrizione dello schema ha copertura 0%, quindi la descrizione deve compensare. Aggiunge il significato che quantità zero ha un effetto particolare, ma non spiega ulteriormente il formato di ASIN o il range. Il contesto del nome e la frase principale rendono i parametri abbastanza chiari.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

La descrizione usa 'Aggiorna la quantità di un ASIN nel carrello' che indica chiaramente l'azione (aggiornare) e la risorsa (quantità di un ASIN nel carrello). Mette anche in evidenza il comportamento della quantità zero, che lo distingue da strumenti come add_to_cart e remove_from_cart.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Non viene fornita alcuna indicazione esplicita su quando usare questo strumento rispetto ai sibling come amazon_add_to_cart o amazon_remove_from_cart. Non si menzionano prerequisiti (es. sessione attiva) né esclusioni.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.