Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]
Un sub-agente è un agente specializzato che costruisci direttamente all'interno del tuo agente principale per gestire un'intenzione mirata, come la fatturazione o il supporto tecnico. A differenza di un agente connesso, un sotto-agente condivide la sua configurazione, distribuzione e gestione del ciclo di vita dell'applicazione (ALM) con l'agente principale a cui appartiene.
Sotto-agenti vs. agenti connessi
Usa un sub-agente quando non hai bisogno di configurazioni, autenticazioni, distribuzione o pubblicazioni separate per un agente specializzato. Usa un agente connesso quando l'agente specialista ha bisogno di un proprio ALM, titolarità o team, oppure quando vuoi riutilizzarlo tra più agenti principali.
| Comparison | Subagente | Agente connesso |
|---|---|---|
| Configurazione e distribuzione | Condiviso con l'agente principale | Indipendente |
| Proprietà | Uguale all'agente principale | Può essere di proprietà di un team diverso |
| Riutilizzo condiviso tra agenti principali | No | Yes |
| Source | Creato direttamente nell'agente principale | Attualmente solo agenti Azure AI Foundry |
| Rimozione | Elimina il sotto-agente | Rimuovi (mantiene la connessione) o elimina definitivamente |
Campi dei sottoagenti
Quando crei un sotto-agente, configura i seguenti campi:
- Nome: Fino a 42 caratteri.
- Descrizione: Fino a 1.024 caratteri. L'orchestrazione dell'agente principale utilizza la descrizione per decidere quando instradare una conversazione a questo sotto-agente. Scrivi una descrizione specifica e che non si sovrapponga agli altri tuoi sub-agenti.
- Istruzioni: Fino a 20.000 caratteri. Definisci il ruolo del sottoagente, il tono e eventuali regole o linee guida che deve seguire.
- Competenze, strumenti e conoscenze: configura allo stesso modo in cui faresti per un agente primario, limitandoti a ciò che questo sotto-agente deve gestire per il proprio intento.
- Variabili di input e output: Passare i dati tra l'agente principale e il sotto-agente.
Come funziona il routing verso un sottoagente
L'orchestrazione dell'agente principale valuta ogni messaggio utente in base al nome, alla descrizione e alle istruzioni di ogni sotto-agente, insieme alle istruzioni dell'agente principale. Utilizza questa valutazione per decidere se gestire la richiesta direttamente o instradarla a un sottoagente.
Tip
Evita nomi o descrizioni simili tra sottoagenti, competenze, argomenti e strumenti. Le descrizioni sovrapposte rendono più difficile per l'orchestratore instradare correttamente le richieste. Scrivi indicazioni esplicite di routing nelle istruzioni dell'agente principale quando hai sotto-agenti che altrimenti potrebbero essere ambigui.
Buone pratiche per lavorare con i sub-agent
Il framework Customer Conversation harness funziona meglio quando i sub-agenti sono indipendenti, quasi come diversi reparti in un contact center. I subagenti indipendenti aiutano a instradare il contesto giusto verso i percorsi di escalation corretti, come diverse code di contact center.
- La descrizione e le istruzioni dell'agente principale non devono essere scambiate per quelle di nessuno dei suoi sottoagenti. Assegna a ciascun agente un ruolo distinto così che l'orchestratore possa distinguerli.
- I sotto-agenti dovrebbero generalmente essere mutuamente esclusivi, ciascuno con un ruolo chiaramente definito. Dai a un sottoagente un set personale di strumenti e conoscenze affinché possa rispondere bene a un particolare tipo di domanda da solo.
- Per far agire i sotto-agenti in modo più fluido insieme, usa
/nelle istruzioni di un agente per fare riferimento agli altri sotto-agenti per nome. Ad esempio, nelle istruzioni dell'agente principale: "Se un utente vuole pagare la propria carta di credito utilizzando un conto corrente della stessa banca, chiedi all'/CheckingAccountAgent di prima confermare il saldo, poi di far effettuare il pagamento al /CreditCardAgent." - L'agente principale instrada il traffico tra i sottoagenti. Pensalo come il cervello dell'instradamento.
La tabella seguente mostra a cosa ogni tipo di agente può fare riferimento:
| Riferimento incrociato | Tools | Topics | Events | Subagenti | Variables |
|---|---|---|---|---|---|
| Agente principale | Yes | Yes | Yes | Yes | Yes |
| Subagente | Yes | Yes | Yes | No | Yes |
| Agente connesso | No | No | No | No | No |
Tip
Per preservare al meglio il contesto discusso all'interno di un argomento quando il controllo ritorna all'orchestrazione generativa, salva l'output dell'argomento come variabile.