Procedure

Istruzioni specifiche per attività che il tuo agente carica quando sono pertinenti

Panoramica

Una procedura contiene istruzioni per un’attività specifica. Ogni procedura ha un trigger che descrive quando si applica e un contenuto che descrive cosa fare. Quando una conversazione corrisponde al trigger, l’agente carica la procedura.

Usa le procedure quando il tuo agente deve gestire molte attività distinte. Un esempio è un agente di assistenza clienti, in cui ogni procedura copre un tipo di richiesta: rimborsi, verifica dell’identità, recupero dell’account o risoluzione dei problemi di connessione.

Scheda Procedure nella dashboard
dell'agente

Tipi di procedure

Esistono due tipi di procedure:

Le procedure in formato libero sono scritte come istruzioni in linguaggio naturale che l’agente interpreta e adatta alla situazione.
Le procedure strutturate sono un elenco ordinato di passaggi tipizzati che l’agente esegue sempre nello stesso modo.

Puoi usare entrambi i tipi sullo stesso agente. L’agente seleziona la procedura pertinente in base al trigger, indipendentemente dal tipo.

Le procedure possono richiamarsi tra loro. Una procedura in formato libero richiama un’altra procedura con un riferimento inline, mentre una procedura strutturata richiama un’altra procedura strutturata con un passaggio Sottoprocedura. Un modello comune consiste nel mantenere la gestione aperta in una procedura in formato libero e delegare a una strutturata le parti che devono essere eseguite sempre nello stesso modo.

Un agente può avere procedure, un workflow oppure entrambi. Quando sono presenti entrambi, ogni procedura è disponibile da ogni punto del workflow; una procedura non può essere limitata a nodi specifici del workflow. La maggior parte degli agenti si basa su un approccio o sull’altro, ma i due possono essere combinati.

Quando usare le procedure

Ogni agente ha un prompt di sistema. Le procedure e i workflow sono due modi per aggiungere struttura e un agente può usare entrambi. Scegli un punto di partenza in base a quanto può variare la conversazione.

Esigenza	Usa	Perché
Semplice agente proof of concept	Solo prompt di sistema	È il modo più rapido per iniziare e iterare, ma un singolo prompt diventa difficile da gestire quando l’ambito dell’agente cresce.
Attività in cui l’agente può adattare formulazione e ordine	Procedura in formato libero	Mantiene l’intera conversazione nel contesto di un unico LLM, così l’agente adatta formulazione e ordine e può gestire svolte impreviste. Usa una porzione maggiore della finestra di contesto.
Attività i cui passaggi devono essere eseguiti sempre nello stesso modo	Procedura strutturata	Ogni passaggio viene eseguito nell’ordine impostato, sempre nello stesso modo, e puoi definirlo come breve elenco di passaggi.
Controllo completo su ramificazioni complesse e casi limite	Workflow	Viene eseguito come un grafo di sottoagenti che progetti e colleghi tu, con controllo completo sulle ramificazioni e sul modello usato in ogni passaggio.

Le procedure in formato libero sono la scelta predefinita. Sono le più rapide da scrivere, si leggono come un documento quindi possono essere gestite da team non tecnici e l’agente può recuperare quando una conversazione devia dal copione. Scegli una procedura strutturata quando il costo di un passaggio saltato o eseguito in un ordine diverso è elevato, ad esempio per l’autenticazione, l’escalation o una transazione finanziaria. Scegli un workflow quando ti serve una logica di instradamento o il controllo del modello per singolo passaggio che nessuno dei due tipi di procedura offre.

Gestire le procedure

La dashboard è il metodo consigliato per creare procedure. Usa la CLI o l’API per gestire le procedure a livello di codice o integrarle negli strumenti di deployment.

Crea dalla dashboard

Gestisci dalla CLI

Gestisci tramite l'API

Apri il tuo agente nella dashboard, quindi seleziona Procedure. Usa + per creare una procedura in formato libero o strutturata. Puoi raggruppare le procedure in cartelle dallo stesso menu. Consulta le Procedure in formato libero e le Procedure strutturate per indicazioni sulla creazione.

Limitazioni

Il contenuto di una procedura è limitato a 50.000 caratteri.
L’agente mantiene nel contesto le cinque procedure avviate più di recente. Quando in una conversazione ne sono state avviate di più, il contenuto, gli strumenti inline e i documenti della knowledge base delle procedure in formato libero meno recenti escono dal prompt. Mantieni le procedure mirate e usa le sottoprocedure affinché poche siano attive contemporaneamente.
Non puoi modificare il tipo di una procedura dopo averla creata. Per passare dal formato libero a quello strutturato o viceversa, crea una nuova procedura e aggiorna tutti i riferimenti a essa.
Le procedure appartengono a un solo agente. Non possono essere condivise tra agenti né archiviate come risorse a livello di workspace.
La duplicazione di un agente ne copia le procedure anziché condividerle. Le copie ricevono nuovi ID procedura, quindi i riferimenti nell’agente duplicato devono usare tali nuovi ID.
Le procedure non possono essere limitate a nodi specifici del workflow. Quando un agente ha entrambi, ogni procedura è disponibile da ogni nodo.
Le procedure strutturate non possono fare riferimento a documenti della knowledge base.