Aggiungere un agente figlio

Un agente figlio è un agente leggero che esiste nel contesto dell'agente principale. Gli agenti figlio consentono di raggruppare logicamente strumenti, istruzioni e Knowledge Base in agenti secondari chiaramente definiti all'interno di un agente più grande. Sono ideali per singoli casi d'uso che rispondono a una singola finalità o completano una singola attività. Questo articolo descrive come creare e gestire un agente figlio.

Creare un agente figlio

1. Passa alla pagina Agenti per l'agente principale e seleziona Aggiungi un agente.

2. Seleziona Nuovo agente figlio.

3. Immetti un nome distintivo per il nuovo agente figlio.

4. Determina quando usare l'agente. Per impostazione predefinita, gli agenti rispondono agli utenti o ai trigger in base alla relativa descrizione.

   • Se desideri usare il comportamento predefinito (l'agente sceglie - In base alla descrizione), immetti una breve descrizione dello scopo dell'agente.
   • In caso contrario, espandi l'elenco in Quando verrà usato? e seleziona il comportamento desiderato. Per altre informazioni sui comportamenti supportati, vedi Determinare quando usare l'agente.

5. Immetti le istruzioni chiare che desideri che l'agente segua se richiamato. Per fare riferimento a strumenti, variabili o aggiungere formule Power Fx nelle istruzioni, immetti una barra (/) e seleziona l'opzione desiderata dal menu visualizzato.

   Importante

   Quando si fa riferimento agli strumenti esistenti nelle istruzioni, decidi se lo strumento deve essere accessibile direttamente dall'agente principale o solo quando viene chiamato in modo esplicito all'interno delle istruzioni. La limitazione dell'utilizzo di uno strumento ai riferimenti espliciti alle istruzioni consente di evitare confusione quando esistono strumenti o agenti simili. Ad esempio, se hai un agente "Controlla saldo conto" e uno strumento simile "Ottieni saldo conto", limita lo strumento per essere chiamato solo dall'agente per evitare sovrapposizioni. Per limitare la disponibilità di uno strumento solo quando viene fatto riferimento da un altro agente, deseleziona la proprietà Consenti all'agente di decidere in modo dinamico quando usare lo strumento nella sezione Dettagli aggiuntivi della pagina dei dettagli dello strumento.

6. Facoltativamente, aggiungi la Knowledge Base e gli strumenti che possono essere usati solo da questo agente figlio:

   • Nella sezione Knowledge Base seleziona Aggiungi e procedi nello stesso modo di quando si aggiunge la Knowledge Base all'agente principale.
   • Nella sezione Knowledge Base seleziona Aggiungi e procedi nello stesso modo di quando si aggiungono strumenti all'agente principale.

7. Se non vuoi che l'agente sia ancora attivo, disattiva Abilitato. Puoi rendere l'agente figlio attivo in un secondo momento.

8. Seleziona Salva.

Gestire gli input e gli output

Per impostazione predefinita, un agente figlio riceve un'attività in linguaggio naturale da eseguire dall'agente principale quando l'agente lo chiama. Quindi, quando completa l'attività, restituisce un riepilogo del linguaggio naturale di ciò che è accaduto durante l'esecuzione. In alcuni casi, è consigliabile specificare valori di input e output più espliciti per l'agente.

Per gestire gli input

1. Vai ai dettagli dell'agente figlio.

2. Scorri verso il basso alla sezione Input.

3. Per aggiungere un input, seleziona Aggiungi input. Definisci un nome visualizzato e una descrizione che consentono all'agente di comprendere lo scopo dell'input in modo che possa riempire l'input con un valore pertinente quando si chiama l'agente.

4. Seleziona un tipo di dati.

5. Facoltativamente, seleziona Rendi obbligatorio questo input per richiedere che l'input abbia un valore prima che l'agente possa essere chiamato.

6. Seleziona Salva.

Nota

Facoltativamente, è possibile espandere la sezione Avanzate e configurare altre impostazioni per l'input, inclusa la scelta Richiesta utente obbligatoria. Se l'impostazione è abilitata, l'agente chiede esplicitamente all'utente finale un valore per l'input, se non è possibile trovarne uno dal contesto disponibile. Vedi altri dettagli sulle altre impostazioni per gli input.

Per gestire l'elenco degli output

1. Vai ai dettagli dell'agente figlio.

2. Scorri verso il basso alla sezione Output.

3. Per visualizzare l'elenco corrente degli output, espandi la sezione Avanzate all'interno della sezione Output.

4. Per aggiungere un output, seleziona Aggiungi output. Definisci un nome visualizzato e una descrizione che consentono all'agente di comprendere lo scopo dell'output in modo che possa riempire l'input con un valore pertinente quando restituisce i valori all'agente chiamante.

5. Seleziona un tipo di dati.

6. Seleziona Salva.

All'interno della sezione Output puoi anche scegliere di inviare un messaggio all'utente subito dopo il completamento dell'agente figlio. Per inviare il messaggio, modifica la selezione Dopo l'esecuzione.

Determinare quando usare l'agente

Per impostazione predefinita, gli agenti figlio rispondono a una query utente in base alla relativa descrizione. È anche possibile configurare gli agenti figlio per intercettare altri eventi e rispondere a tali eventi in Quando verrà usato?.

Evento	Descrizione
Viene ricevuto un messaggio	Chiamato quando viene ricevuta un'attività di messaggio, il tipo di attività più comune. Ricevuto quando un utente digita o dice qualcosa all'agente. Per impostazione predefinita, l'agente risponde a tutti i messaggi. Per limitare la risposta dell'agente a un tipo specifico di messaggio, usa l'elenco Tipo di attività in Dettagli aggiuntivi.
Si verifica un evento client personalizzato	Chiamato quando un'attività di evento viene ricevuta. Per impostazione predefinita, l'agente risponde a tutti gli eventi. Per limitare la risposta dell'agente a un evento specifico, usa la proprietà Nome evento in Dettagli aggiuntivi.
Viene eseguita un'attività	Chiamato quando si riceve un'attività di qualsiasi tipo. Per limitare la risposta dell'agente a un tipo specifico di attività, usa l'elenco Tipo di attività in Dettagli aggiuntivi.
La conversazione cambia	Chiamato quando viene ricevuta un'attività di aggiornamento della conversazione. Ad esempio, Teams invia un'attività di questo tipo quando un utente partecipa a una conversazione.
Viene richiamato	Chiamato quando un'attività di chiamata viene ricevuta. Ricevuta più comunemente dal canale di Teams, ad esempio, di un utente che interagisce con un messaggio o un'estensione di ricerca in Teams.
Viene reindirizzato a	Chiamato quando l'agente viene invocato esplicitamente all'interno di un argomento.
L'utente è inattivo da un po' di tempo	Chiamato quando l'utente non ha interagito con l'agente principale dopo un periodo di tempo configurato. Seleziona la soglia di inattività desiderata nell'elenco Durata inattività in Dettagli aggiuntivi.
Viene completato un piano	Chiamato quando l'agente principale termina l'esecuzione di tutti i passaggi pianificati per rispondere a una query utente o a un trigger autonomo.
Sta per essere inviata una risposta generata dall'IA	Chiamato quando l'agente principale genera una risposta per un utente dopo aver chiamato uno o più argomenti, strumenti o origini della Knowledge Base. Usa la Response.FormattedText variabile di sistema per visualizzare la risposta generata. Imposta la variabile ContinueResponse su false se desideri impedire l'invio della risposta di orchestrazione, ovvero se modifichi il messaggio e invii il tuo messaggio tramite un nodo Messaggio.

Altri dettagli

A seconda della selezione per Quando verrà usato?, potrebbero essere disponibili altre proprietà. Le seguenti proprietà sono sempre disponibili.

Condizione

Specifica le condizioni che devono essere soddisfatte affinché l'agente venga chiamato. Ad esempio, è possibile che l'agente venga chiamato solo se il canale usato da un dipendente è Microsoft Teams.

Se hai bisogno di condizioni più complesse, puoi passare all'editor di formule Power Fx: seleziona Builder, quindi seleziona Formula.

Priorità

È possibile attivare più di un agente per una singola attività in arrivo, ad esempio un messaggio. Per impostazione predefinita, l'opzione selezionata per Quando verrà usata? determina l'ordine in cui gli agenti vengono attivati.

Gli agenti e gli argomenti figlio condividono lo stesso insieme di eventi o trigger a cui possono rispondere. Se un agente e un argomento sono configurati per rispondere allo stesso evento, ad esempio l'inattività dell'utente, usa la proprietà della priorità per determinare quale deve essere prima.

Ordine di esecuzione:

1. Viene eseguita un'attività
2. Viene ricevuto un messaggio / Si verifica un evento client personalizzato / La conversazione cambia / Viene richiamato
3. L'agente sceglie

Se è necessario chiamare più agenti o argomenti in base allo stesso tipo di evento, vengono chiamati nell'ordine di creazione (prima meno recente).

È possibile impostare la proprietà Priorità in modo esplicito. Un numero inferiore indica una priorità più alta.