Invocare strumenti dal codice
Chiami uno strumento del server e ne legga il risultato.
Invocare strumenti dal codice è una lezione MCP Academy gratuita su CoddyKit. Questa è la lezione 3 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento MCP Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso MCP Academy include 4 lezioni in totale.
Dall'elenco all'azione
La rilevazione ha mostrato cosa è disponibile. Ora si invoca effettivamente uno strumento, inviando gli argomenti e leggendo il risultato restituito al proprio codice.
Chiamare per nome
Usi session.call_tool() con il nome dello strumento e un dizionario di argomenti. I nomi devono corrispondere all'inputSchema rilevato.
result = await session.call_tool(
"add",
{"a": 2, "b": 3},
)Gli argomenti devono essere validi
Il dizionario arguments deve rispettare l'inputSchema dello strumento. Inviando una struttura errata, il server rifiuterà la chiamata.
await session.call_tool("greet", {"name": "Ada"})Leggere il contenuto
Il risultato contiene un elenco di blocchi content. La maggior parte degli strumenti restituisce testo, quindi si legge il testo dal primo blocco.
print(result.content[0].text)Controllare gli errori
Quando uno strumento non riesce, il risultato imposta isError su true invece di sollevare un'eccezione. Lo si controlli affinché il client possa reagire correttamente.
if result.isError:
print("tool failed")Anche l'output strutturato
Gli strumenti più recenti possono restituire anche structuredContent, un oggetto tipizzato insieme al testo, quando il server definisce uno schema di output.
print(result.structuredContent)Passare argomenti reali
Gli argomenti possono provenire dal programma, da un utente o da un modello. Il client li inoltra semplicemente come dict alla strumento indicato.
args = {"city": "Paris"}
await session.call_tool("weather", args)È comunque asincrono
Come ogni chiamata di rete, call_tool deve essere attesa. await sospende l'esecuzione finché il server non termina il lavoro e il risultato non viene restituito.
Una chiamata, un risultato
Ogni invocazione è una coppia richiesta-risposta. La sessione associa la risposta alla richiesta tramite l'ID, evitando che i risultati si confondano.
Gestire gli strumenti lenti
Alcuni strumenti richiedono tempo. Un client robusto imposta un timeout, così uno strumento bloccato non congela l'intero programma.
Lei coordina tutto
Chiamare gli strumenti dal codice significa che il programma decide l'ordine, combina i risultati e trasforma l'output grezzo in qualcosa di utile per l'utente.
Controllo rapido
Come si esegue uno strumento rilevato dal codice del client?
Riepilogo: effettuare la chiamata
Ha invocato gli strumenti dall'inizio alla fine: chiamarli per nome con argomenti validi, leggere i blocchi di contenuto e controllare isError prima di considerare attendibile l'output.
Domande Frequenti
La lezione «Invocare strumenti dal codice» è gratuita?
Sì — il testo completo di «Invocare strumenti dal codice» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso MCP Academy, passa a CoddyKit PRO. Il corso MCP Academy include 4 lezioni in totale.
Cosa imparerò in «Invocare strumenti dal codice»?
Chiami uno strumento del server e ne legga il risultato. Eserciti MCP Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.
Ho bisogno di esperienza per iniziare MCP Academy?
Non è richiesta alcuna esperienza precedente. MCP Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 3 di 4.
Quanto tempo richiede la lezione «Invocare strumenti dal codice»?
La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.
Posso scrivere ed eseguire codice in questa lezione MCP Academy?
Sì. Ogni lezione MCP Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.
Tutte le lezioni di questo corso
- Aprire una sessione client
- Individuare strumenti e risorse
- Invocare strumenti dal codice
- Instradare le chiamate agli strumenti tramite un LLM