Output strutturato e chiamata degli strumenti
I dati strutturati aiutano il software a leggere una risposta, ma sia la struttura che il significato richiedono la convalida.
Cosa imparerai
- Spiegare: il modello propone, lo strumento esegue
- Applica l'idea in un esempio: output strutturato e chiamata di strumenti
- Riconoscere i limiti e verificare il risultato dell'esercizio
I dati strutturati aiutano il software a leggere una risposta, ma sia la struttura che il significato richiedono la convalida.
Puoi seguire questo corso senza un account o una programmazione. Gli esempi utilizzano dati sintetici e i risultati dell’intelligenza artificiale devono essere verificati.
Come funziona, passo dopo passo
Il modello propone, lo strumento esegue
La chiamata allo strumento produce una richiesta di chiamata con un nome e argomenti. L'applicazione convalida lo schema, le autorizzazioni e i limiti prima dell'esecuzione. Il risultato ritorna al contesto per il passaggio successivo. Ad esempio, get_product_stock accetta uno SKU e restituisce una quantità; la sua descrizione dovrebbe spiegare che non effettua prenotazioni di prodotti. Distinguere risultati vuoti, errori di convalida, accessi mancanti e timeout. Un JSON valido non dimostra che gli argomenti siano corretti o che l'azione sia autorizzata. Per gli effetti esterni, considerare anche l'esecuzione duplicata.
Un'istruzione è un contratto
Un buon prompt specifica l'attività, i dati disponibili, il formato di output e i criteri di successo. Separare il ruolo dai dati e includere un esempio per i casi ambigui. “Sii preciso” è più debole di “indicare solo la scadenza nella polizza fornita; se manca, chiedere chiarimenti”. Pochi scatti significa pochi esempi risolti, non un elenco infinito. Il contenuto del documento rimane dati anche quando contiene comandi. I delimitatori aiutano, ma il software deve applicare autorizzazioni e convalida anziché fare affidamento sul prompt.
Controllare l'accesso prima dell'uso
Le autorizzazioni devono essere applicate dai server e dal livello dati. Non lasciare che sia il modello a decidere se un utente può vedere un documento. Filtra le fonti prima che entrino nel contesto, non dopo aver generato la risposta. Utilizza credenziali di accesso minimo, tienile lontane da prompt, screenshot e codice del browser e ruota le chiavi esposte. Una lista consentita di domini widget non sostituisce l'autenticazione API. L'autenticazione ti identifica; l'autorizzazione determina le operazioni e i dati che puoi utilizzare. Prova anche l'accesso negato.
Lo schema esplicativo
Seguire le frecce continue per il flusso principale. Le frecce blu tratteggiate forniscono dati o contesto; le frecce rosa tratteggiate mostrano feedback o risultati restituiti. Colori e forme distinguono modelli, negozi, decisioni e risultati. Su schermi piccoli, scorri in orizzontale per seguire l’intero schema.
Un esempio completo
Un classificatore restituisce categoria e needs_review. JSON con Category="refund_now" è sintatticamente valido ma viola le categorie consentite e non autorizza un rimborso.
{"category":"returns","needs_review":false}
Provalo tu stesso
- Definire uno schema e testare una categoria sconosciuta e un campo mancante.
- Registrare l'input, la fonte e il risultato atteso prima di eseguire l'esperimento. Utilizzare solo i dati fittizi nell'esempio.
- Seguire le fasi del diagramma. Ad ogni passaggio registrare quali informazioni vengono ricevute e prodotte; non confondere il risultato intermedio con il risultato finale.
- Ripetere dopo aver rimosso le informazioni necessarie o reso ambiguo l'input. Controlla se il sistema chiarisce, ferma o inventa una risposta.
- Confrontare con la soluzione spiegata. Conserva la configurazione, la data, il risultato e una spiegazione delle differenze. Cambia una cosa e riprova.
Una soluzione spiegata
Il validatore accetta solo consegna, resi o prodotto e un valore booleano; le azioni rimangono separate. Un esercizio riuscito ti consente di mostrare la connessione tra input, fasi e risultato. Quando mancano le informazioni, una risposta cauta è più utile dei dettagli inventati. Confrontare non solo stile: verificare anche condizioni, fonti e operazioni.
Quando è utile e quali sono i suoi limiti
JSON sintatticamente corretto non è semanticamente corretto. Scegli questo approccio quando migliora un bisogno misurato. Mantieni una linea di base semplice e confronta i risultati utilizzando input identici. Un esempio di successo non stabilisce l’affidabilità in ogni situazione.
Verifica ciò che hai imparato
Chi esegue una chiamata proposta dal modello?
L'applicazione o il servizio host dopo la convalida. Il modello non ottiene automaticamente l'accesso illimitato.
Un prompt può sostituire il controllo degli accessi?
No. Un'istruzione non costituisce un limite di autorizzazione.
Quale risultato dovrebbe produrre questo esercizio?
Il validatore accetta solo consegna, resi o prodotto e un valore booleano; le azioni rimangono separate.
Termini da ricordare
- Chiamata dello strumento: una richiesta strutturata per utilizzare una funzionalità esterna.
- Pochi colpi: Esempi risolti forniti nel contesto.
- Autorizzare/Autorizzazione: verifica del diritto di accesso a un'operazione o risorsa.
Fonti e il prossimo passo
Per preparare: P04 — Come scegliere un modello di IA adatto