Restituire risultati utili
Restituisca testo che il modello e l'utente possano utilizzare.
Restituire risultati utili è 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.
Il risultato torna al modello
Qualunque cosa lo strumento restituisca viene fornita all'IA come contesto, influenzando così la risposta successiva del modello all'utente. 🔁
Restituire una stringa
Il risultato utile più semplice è una stringa ordinaria. FastMCP la include come contenuto testuale che il modello legge direttamente.
@mcp.tool()
def greet(name: str) -> str:
return "Hello, " + nameRenda il testo autoesplicativo
Il modello non dispone di altro contesto, quindi il Suo testo deve spiegarsi da solo. Restituisca "Il totale è 42", non soltanto "42".
I numeri vengono convertiti in stringhe
Se restituisce un int o un float, FastMCP lo converte automaticamente in testo, ma aggiungere un'etichetta rende il valore più chiaro per il modello.
@mcp.tool()
def add(a: int, b: int) -> int:
return a + bRestituire dati strutturati
Restituisca un dict o una list e FastMCP li serializzerà in JSON, fornendo al modello campi chiari e analizzabili invece di prosa generica.
@mcp.tool()
def stats() -> dict:
return {"users": 12, "active": 9}Mantenga concisi i risultati
Ogni token restituito consuma parte del contesto disponibile per il modello, quindi riduca il risultato a ciò che risponde effettivamente alla richiesta. Meno rumore, risposte più precise.
Formattare per facilitare la lettura
Quando un risultato ha più parti, un po' di struttura è utile. Brevi righe con etichette sono preferibili a un'unica frase lunga che il modello deve districare.
Restituire gli errori come testo
Quando qualcosa non funziona, restituire un messaggio chiaro consente al modello di spiegare il problema e tentare una correzione, invece di tirare a indovinare.
if not city:
return "Error: city is required."Non restituisca segreti
Il risultato raggiunge il modello e spesso anche l'utente, quindi non includa mai segreti come chiavi API o password non elaborate in ciò che restituisce.
Le strutture coerenti sono utili
Restituisca la stessa struttura a ogni chiamata, così il modello impara cosa aspettarsi. Le variazioni strutturali generano risposte interpretate in modo errato.
Mantenga la promessa dello strumento
Il Suo risultato deve fornire esattamente ciò che la descrizione promette. Se ha indicato che restituisce il prezzo, restituisca il prezzo, non un rapporto completo.
Controllo rapido
Cosa succede quando lo strumento restituisce un dict Python?
Riepilogo
Il Suo risultato diventa parte del contesto del modello: restituisca testo o JSON chiaro, conciso e autoesplicativo, mantenga coerenti le strutture e non divulghi mai segreti. ✅
Domande Frequenti
La lezione «Restituire risultati utili» è gratuita?
Sì — il testo completo di «Restituire risultati utili» è 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 «Restituire risultati utili»?
Restituisca testo che il modello e l'utente possano utilizzare. 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 «Restituire risultati utili»?
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
- Dare un buon nome e una buona descrizione a uno strumento
- Dichiarare i parametri con le annotazioni di tipo
- Restituire risultati utili
- Uno strumento calcolatrice dall'inizio alla fine