Contratti di output degli agenti e output specifici per ramo
I contratti di output degli agenti definiscono ciò che un agente deve produrre al termine dell'esecuzione. Ogni agente ha un singolo output di fallback oppure un insieme di output specifici per ramo. Il motore applica il contratto al termine dell'esecuzione e questa non va a buon fine se l'agente produce un tipo di output errato per il ramo selezionato.
Tipi di output
Il motore degli agenti supporta tre tipi di output:
Tipo | Cosa deve fornire l'agente |
|---|---|
risposta | Una risposta esclusivamente in chat. L'agente non deve creare né caricare un documento. |
documento | Un documento generato o caricato. L'agente deve produrre un file di documento. |
tabella | Una tabella strutturata o una cartella di lavoro. L'agente deve produrre l'output tabellare. |
Output di fallback e output specifici per ramo
Quando ogni ramo terminale di un agente produce lo stesso risultato, configura un singolo output di fallback. Quando rami diversi producono risultati diversi, usa invece output specifici per ramo.
Output di fallback — un contratto di output applicato a ogni ramo terminale.
Output specifici per ramo — un contratto di output per ogni ramo, in modo che il risultato corrisponda al percorso del ramo seguito.
Durante un'esecuzione dovrebbe completarsi esattamente un ramo di output. Se l'agente produce il tipo errato per il ramo selezionato, l'esecuzione non va a buon fine e viene restituito un errore esplicito.
Applicazione del contratto
Il motore controlla l'output al termine di ogni esecuzione. Tra gli errori comuni relativi al contratto figurano:
Produrre un documento quando il contratto del ramo prevede una risposta.
Terminare l'esecuzione senza produrre l'output documentale richiesto.
Terminare l'esecuzione senza produrre alcun output richiesto.
Quando non è configurato alcun contratto di output, la pagina dei dettagli dell'agente mostra il messaggio: "Non è impostato alcun contratto di output esplicito."
Come configurare gli output specifici per ramo
Nel generatore di agenti, apri la sezione dell'output.
Aggiungi un blocco di output per ogni ramo che richiede un risultato distinto.
Seleziona il tipo di output per ogni blocco: risposta, documento o tabella.
Collega ogni blocco di output al ramo di destinazione.
Testa l'agente per verificare che ogni ramo produca il tipo di output corretto.
Quando è impostato un output specifico per ramo, il motore controlla il contratto solo per il ramo selezionato. I rami non selezionati vengono ignorati e i relativi contratti di output non vengono applicati.
Cosa leggere dopo
Panoramica degli agenti per creare ed eseguire gli agenti
Riprendere un'esecuzione dell'agente in attesa di input umano per riprendere le esecuzioni sospese dalla chat
Playbook per applicare in modo coerente standard rigorosi