Panoramica dei sottooperatori (Conversazione con il cliente) (anteprima)

[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.