Risorse elencate o basate su template
Offra voci fisse insieme a pattern generati al momento.
Risorse elencate o basate su template è 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.
Due modi per offrire dati
MCP espone i dati in due modi: una risorsa elencata con un URI fisso oppure una risorsa parametrizzata con segnaposto. Sapere quale scegliere mantiene chiaro il server.
Elencata: enumerabile e limitata
Una risorsa elencata ha un URI concreto e compare in resources/list. La utilizzi quando esistono solo pochi elementi noti che il client può consultare.
@mcp.resource("config://app")
def app_config() -> str:
return read_config()Parametrizzata: infinita per modello
Una risorsa parametrizzata usa segnaposto tra parentesi graffe, quindi comprende innumerevoli URI. Non può essere elencata per intero, perché l'insieme non ha un limite prestabilito.
@mcp.resource("file://{path}")
def read_file(path: str) -> str:
return open(path).read()La differenza nell'elenco
I client chiamano resources/list per individuare le risorse fisse. I template compaiono invece in un elenco separato, descrivendo la struttura anziché voci concrete.
Esplorare o indirizzare
Può pensarla come una distinzione tra esplorare e indirizzare. Le risorse elencate sono come le voci di un menu da scorrere; i template sono come digitare un indirizzo che già si conosce.
Quando l'insieme è piccolo
Se i dati costituiscono un insieme ridotto e stabile, preferisca le risorse elencate. Il modello può vedere ogni opzione, rendendo ovvia la scelta giusta.
Quando l'insieme è enorme
Se gli elementi sono migliaia, è preferibile un template. Elencarli tutti sommergerebbe il client, quindi si pubblicizza lo schema e si lasciano compilare i valori.
weather://{city}/todayCombini liberamente entrambi
Un server reale spesso fa entrambe le cose: alcune voci elencate per i dati più comuni, più i template per la coda lunga. Coesistono senza problemi una accanto all'altra.
Faciliti l'individuazione
I template non possono enumerare gli elementi, ma può aggiungere una piccola risorsa indice elencata che rimanda agli URI più usati, offrendo al modello utili punti di partenza.
@mcp.resource("cities://index")
def cities() -> str:
return "london, paris, tokyo"La lettura è la stessa
Indipendentemente da come viene trovato un URI, il client lo legge nello stesso modo: con una chiamata resources/read. La differenza tra elencato e basato su template riguarda l'individuazione, non il recupero dei contenuti.
Perché è importante
Scegliere tra risorse elencate e basate su template influisce sulla facilità con cui un modello trova i dati. Scelga le risorse elencate per l'esplorazione e quelle basate su template per la scalabilità: il server resterà facile da usare. 🎯
Verifica rapida
Quale tipo di risorsa dovrebbe usare per migliaia di elementi?
Riepilogo
Ha imparato che le risorse elencate sono adatte a insiemi piccoli ed esplorabili, mentre quelle basate su template si adattano a raccolte enormi; inoltre, i due approcci si combinano bene. Prossimo argomento: notificare ai client gli aggiornamenti. 🚀
Impara Python con un tutor IA — gratis
Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.
- Corsi
- 30
- Lezioni
- 120
Domande Frequenti
La lezione «Risorse elencate o basate su template» è gratuita?
Sì — il testo completo di «Risorse elencate o basate su template» è 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 «Risorse elencate o basate su template»?
Offra voci fisse insieme a pattern generati al momento. 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 «Risorse elencate o basate su template»?
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
- URI parametrizzati delle risorse
- Creare il contenuto al momento della lettura
- Risorse elencate o basate su template
- Notificare ai client gli aggiornamenti