Lezione gratuita

Function calling e dispatch del server

Function calling e dispatch del server — Strumenti e agenti OpenAI senza esecuzioni a pagamento. Definire una funzione Responses; Dispatch senza eval; L'output non amplia i poteri. Esercitazione pratica: Pratica: Function calling e dispatch del server.

Versione demo. I materiali sono in fase di revisione editoriale.

Argomenti trattati

  • Definire una funzione Responses
  • Dispatch senza eval
  • L'output non amplia i poteri

Definire una funzione Responses

Una funzione Responses colloca type:function, name, parameters e strict allo stesso livello. Non copiare automaticamente wrapper annidati di altre API. Lo schema ammette solo ID safety o backup e rifiuta campi extra. I campi dichiarati sono obbligatori; union con null supportate possono rappresentare opzioni quando appropriate. Non esporre credenziali nascoste o percorsi arbitrari. La definizione descrive capacità ma non le esegue: il dispatcher controlla se e come gli argomenti raggiungono il codice.

// tools.mjs
export const readNoteTool = {
  type: 'function', name: 'read_note',
  description: 'Read one fictional public lab note.', strict: true,
  parameters: {
    type: 'object', properties: { noteId: { type: 'string', enum: ['safety', 'backup'] } },
    required: ['noteId'], additionalProperties: false
  }
};

Dispatch senza eval

Aggiungi dispatchRead a tools.mjs. Verifica nome e struttura prima della ricerca esplicita. Uno strumento sconosciuto non diventa una funzione JavaScript cercata dinamicamente. JSON.parse produce un valore, non fiducia. Fixture delete_file, comando aggiuntivo o ../../key devono fallire senza file o rete. Le note sono regole didattiche, non prove dello stato reale del server, dei permessi o di un backup completato. Non usare eval per trasformare l'output del modello in codice.

const notes = {
  safety: 'Educational rule: model ports stay private.',
  backup: 'Educational rule: verify recovery on a separate copy.'
};
export function dispatchRead(name, args) {
  if (name !== 'read_note') throw new Error('tool_not_allowed');
  if (!args || Array.isArray(args) || typeof args !== 'object'
      || Object.keys(args).join(',') !== 'noteId'
      || typeof args.noteId !== 'string' || !Object.hasOwn(notes, args.noteId)) throw new Error('invalid_arguments');
  return { noteId: args.noteId, text: notes[args.noteId] };
}

L'output non amplia i poteri

Anche un prompt che dichiara tutto autorizzato non cambia la lista del dispatcher. Richieste di altre note subiscono gli stessi controlli. Aggiungere pubblicazione, email o shell richiede un nuovo contratto e revisione, non un ramo scelto dal modello. Limita anche il contesto restituito: sola lettura non autorizza a divulgare ogni record. Il catalogo piccolo e pubblico rende gli invarianti verificabili manualmente e con test negativi senza costi d'inferenza o account reali.

Esercitazione pratica

Pratica: Function calling e dispatch del server

Vai alla lezione

Programma del corso

  1. Architettura e budget API
  2. Function calling e dispatch del server
  3. Ciclo strumenti e call_id
  4. Risposte strutturate e regole applicative
  5. Approvazione e confini degli effetti
  6. Errori, valutazioni e harness finale