Agenti
Preferenze dell'agente
Ogni impostazione nel pannello del builder dell’agente: dettagli, modello, istruzioni, trigger, limiti di generazione, output strutturato e il blocco di benvenuto.
Il pannello delle impostazioni a destra del builder dell’agente ha tre schede: Preferenze, Avanzate e Cronologia. Questa pagina copre le prime due. La memoria e la cronologia della chat sono su una pagina dedicata, gli strumenti su un’altra, e la Cronologia è in condividi e pubblica.
Ogni sezione è una fascia comprimibile con la propria icona e un riepilogo di una riga del suo valore attuale. Le modifiche vengono salvate come bozza circa un secondo dopo che smetti di digitare. Usa i pulsanti annulla e ripristina nella barra in alto, oppure Ctrl+Z e Ctrl+Shift+Z (⌘ su Mac), per scorrere le tue modifiche. La cronologia di annullamento dura finché la pagina del builder è aperta.
Scheda Preferenze#
Dettagli#
Questa sezione è piegata quando apri il builder. Contiene i fatti sull’agente, non il modo in cui risponde.
- Nome. Fino a 100 caratteri. Il nome viene salvato quando premi Invio o lasci il campo.
- Descrizione. Mostrata nell’elenco Agenti, nella scheda della libreria e nel benvenuto della chat.
- Categoria. La categoria in cui è archiviato l’agente.
- Segnaposto input chat. Il testo grigio nella casella di chat vuota.
- Disabilita input di testo. Disattiva la casella di testo della chat.
- Descrizione dettagliata. Un testo più lungo, scritto in Markdown.
Modello e istruzioni#
- Modello. Il modello linguistico con cui ragiona l’agente. Il valore predefinito seleziona il modello che il tuo workspace ha contrassegnato come predefinito.
- Sforzo di ragionamento. Compare solo per i modelli che lo supportano. I valori disponibili dipendono dal modello. Il valore predefinito è nessuno.
- Deep agent. Un interruttore. Dà all’agente un file system, uno strumento di pianificazione e un sub-agente di supporto a cui può delegare il lavoro. Usalo per attività lunghe e a più passaggi; un agente semplice risponde più velocemente.
- Messaggio di sistema. Le istruzioni. Indica chi è l’agente, cosa può fare e come deve rispondere. Il valore predefinito è “Sei un assistente utile.”
- Mostra avanzamento. Mostra nella chat l’avanzamento dell’agente e le chiamate agli strumenti mentre lavora. È attivo per impostazione predefinita.
Se passi a un modello che non accetta lo sforzo di ragionamento scelto, il builder lo reimposta su nessuno, oppure sul primo valore consentito dal modello.
App#
Gli strumenti che l’agente può chiamare. Vedi strumenti dell’agente.
Trigger#
Chat è sempre attivo: copre la chat di test, i chatbot e l’API. Clicca Aggiungi trigger per lasciare che qualcos’altro avvii l’agente, come un messaggio Slack, una pianificazione o un webhook. Ogni trigger ha un badge di stato:
- Attivo: il trigger è in funzione.
- Pubblica per attivare: la bozza ha un trigger che la versione pubblicata non ha. I webhook e le pianificazioni si registrano quando pubblichi.
- Connetti: il trigger richiede un account che non hai collegato. Clicca per collegarlo. Vedi collegare gli account.
L’ingranaggio apre le impostazioni del trigger. Il menu con i tre punti lo rimuove. I trigger disponibili sono elencati nel riferimento degli step.
Scheda Avanzate#
Generazione#
- Temperatura. Valori più alti rendono le risposte più casuali, valori più bassi più deterministiche. Il valore predefinito è 0,7 e l’intervallo va da 0 a 2, ma alcuni modelli lo limitano a un valore inferiore (i modelli Anthropic si fermano a 1). È nascosta per i modelli di ragionamento, che la ignorano.
- Token massimi di output. La risposta singola più lunga. Il valore predefinito è 3000.
- Iterazioni massime. Quanti cicli di ragionamento e chiamate agli strumenti l’agente può eseguire. Il valore predefinito è 20 e il massimo è 250.
Output strutturato#
Attivalo per far rispondere l’agente in JSON con una struttura che definisci tu. In Schema di output elenchi ogni campo di output con un nome, un tipo (string, int, float, bool, list o dict) e una descrizione.
All’apertura della chat#
Blocchi che la chat mostra prima della prima domanda, come un messaggio di benvenuto, pulsanti o card. Clicca Aggiungi blocco e scegline uno dall’elenco. Trascina i blocchi per riordinarli e rimuovine uno dalla sua riga. Apri un blocco per modificarne il contenuto. Senza blocchi, la chat si apre vuota.
Cronologia chat#
Vedi memoria e cronologia chat.
La scheda Avanzate segue lo step
La scheda Avanzate è costruita dalla definizione dello step AI Agent stesso. Se lo step acquisisce un’impostazione, questa appare qui senza modifiche a questa pagina. Il riferimento di AI Agent le elenca tutte.
Se qualcosa va storto#
Se non riesci a modificare nulla, potresti aver aperto l’agente in modalità Visualizza come utente o il tuo ruolo potrebbe non avere i diritti di modifica. Clicca il pulsante a matita Modifica agente nella barra in alto. Se il pannello indica che i nodi del flow non corrispondono più al modulo dell’agente, vedi convertire in workflow.