Linee guida degli strumenti agente negli agenti AI generativa

Comprendere le proprietà e le responsabilità di un agente supervisore e dei suoi agenti collaboratori.

• L'agente supervisore e un agente collaboratore possono appartenere a tenancy diverse.

• Un agente collaboratore può essere un agente con qualsiasi tipo di strumento (ad esempio, strumento RAG) o una combinazione di tipi di strumento (ad esempio, RAG e strumenti di chiamata funzione), purché l'agente sia associato a un endpoint agente attivo.

• L'agente configurato come strumento Agente può funzionare in modo indipendente ed essere integrato in un agente supervisore.

• È possibile includere ulteriori strumenti (ad esempio RAG e SQL) nell'agente supervisore con agenti collaboratori.

• L'agente supervisore è responsabile di:

  • Gestione delle sessioni e routing delle query

  • Aggregazione di risposte da agenti o strumenti collaboratori

  • Gestione della cronologia chat globale

• Un agente collaboratore è responsabile di:

  • Gestione delle query relative alla specializzazione (ad esempio, HR)
  • Gestione di una cronologia chat localizzata legata alla sessione globale.

• Le metriche e la fatturazione vengono gestite separatamente per l'agente supervisore, gli agenti collaboratori e gli strumenti.

Un possibile scenario di flusso di dati che coinvolge risposte da più agenti collaboratori potrebbe essere descritto come segue:

1. Un utente invia una query all'agente supervisore in una sessione di chat. La query si estende su più specializzazioni.
2. L'agente supervisore suddivide la query e delega le subquery agli agenti collaboratori pertinenti in base alla logica di instradamento.
3. Ogni agente collaboratore elabora la propria subquery utilizzando il contesto della sessione. Gli agenti collaboratori restituiscono le risposte all'agente supervisore.
4. L'agente supervisore aggrega e formatta le risposte in un output consolidato e invia l'output all'utente.

Il flusso di lavoro per l'implementazione degli agenti collaboratori e di un agente supervisore è:

1. Comprendere e aggiungere i criteri IAM (Identity and Access Management) OCI necessari. Vedere Criteri IAM.
2. Creare gli agenti collaboratori utilizzando qualsiasi strumento. Per assistenza, vedere Creazione di un agente.
3. Assicurarsi che a ogni agente collaboratore sia associato un endpoint agente attivo e abilitato per la sessione. Per assistenza, vedere Ottenere i dettagli di un endpoint.
4. Creare l'agente supervisore. Utilizzare il tipo di strumento Agente per aggiungere gli agenti collaboratore. Per assistenza, vedere Creazione di uno strumento agente.
5. Assicurarsi che l'endpoint agente per l'agente supervisore sia abilitato per la sessione. Per assistenza, vedere Ottenere i dettagli di un endpoint.

Assicurarsi di concedere agli utenti l'accesso a tutte le risorse degli agenti di intelligenza artificiale generativa come descritto in Aggiunta di criteri prima di poter utilizzare il servizio.

Esaminare anche le sezioni seguenti.

Gruppo dinamico e criteri

È necessario aggiungere un gruppo dinamico con autorizzazione per gestire genai-agent-family.

1. Creare un gruppo dinamico e aggiungere la regola della corrispondenza seguente.

   ALL {resource.type='genaiagent'}

   Per assistenza, vedere Creazione di un gruppo dinamico.

2. Concedere l'autorizzazione al gruppo dinamico.

   • Scrivere il criterio riportato di seguito, che può essere utilizzato con il dominio di Identity predefinito:

     allow dynamic-group <dynamic-group-name> 
     to manage genai-agent-family in tenancy
     

   • Usare il criterio riportato di seguito con un dominio di Identity non predefinito, fornendo il nome di dominio Oracle Identity Cloud Service (IDCS) e il nome del gruppo dinamico.

     allow dynamic-group '<idcs-domain-name>/<dynamic-group-name>' 
     to manage genai-agent-family in tenancy
     

   Vedere Informazioni sui tipi di risorsa degli agenti AI generativa per assegnare le autorizzazioni in base AI singoli tipi di risorsa anziché al tipo di risorsa aggregata.

Accesso cross-tenancy

Per utilizzare un endpoint agente proveniente da un'altra tenancy, è necessario che determinati criteri siano impostati nella tenancy di destinazione e nella tenancy in cui si sta creando lo strumento Agente. Raccogliere le informazioni elencate di seguito.

• Nome e OCID della tenancy di destinazione. La tenancy di destinazione è la tenancy che dispone dell'endpoint dell'agente attivo che si desidera utilizzare.
• Il nome della tenancy e l'OCID in cui si sta creando uno strumento agente.
• Il nome e l'OCID del gruppo dinamico.

Scrivere le istruzioni dei criteri cross-tenancy riportate di seguito. Se applicabile, utilizzare il modulo '<idcs-domain-name>/<dynamic-group-name>' nella sintassi per l'uso in un dominio di Identity non predefinito.

Nella tenancy in cui si sta creando uno strumento agente, effettuare le operazioni riportate di seguito.

<target-tenancy> è la tenancy che dispone dell'endpoint dell'agente attivo che si desidera utilizzare.

Define tenancy <target-tenancy> as <target-tenancy-ocid>

Endorse dynamic-group <dynamic-group-name> to manage genai-agent-family in tenancy <target-tenancy>

Nella tenancy di destinazione:

<this-tenancy> è la tenancy in cui si sta creando uno strumento Agente.

Define tenancy <this-tenancy> as <this-tenancy-ocid>

Define dynamic-group <dynamic-group-name> as <dynamic-group-ocid>

Admit dynamic-group <dynamic-group-name> of tenancy <this-tenancy> to manage genai-agent-family in tenancy

Se hai bisogno di aiuto, consulta i criteri di accesso cross-tenancy nella documentazione di OCI IAM con i domini di Identity.

Uno strumento Agente supporta solo un agente con un endpoint agente per il quale è abilitata la sessione.

Quando la sessione è abilitata su un endpoint agente per mantenere il contesto di una sessione di chat, gli agenti di intelligenza artificiale generativa creano un ID sessione e mantengono la sessione agente per la conversazione interattiva. Durante la sessione, il contesto e la continuità sono mantenuti per fornire risposte coerenti e significative durante tutta la conversazione.

Per un agente collaboratore che deve essere configurato in un agente supervisore, assicurarsi che l'agente disponga solo di un endpoint agente basato sulla sessione. L'agente supervisore deve essere associato solo a un endpoint agente per il quale è abilitata la sessione.

Per impostazione predefinita, quando si utilizza la console per creare un agente e si sceglie di creare automaticamente l'endpoint dell'agente contemporaneamente, la sessione viene abilitata sull'endpoint dell'agente creato con l'agente. Per verificare, è possibile visualizzare i dettagli dell'endpoint nell'agente.

Se si crea manualmente un endpoint agente, assicurarsi che sia selezionata l'opzione Abilita sessione se l'endpoint deve essere configurato con uno strumento Agente.

Prima di creare uno strumento Agente, raccogliere le informazioni riportate di seguito.

• Il nome dell'agente da aggiungere come strumento.
• Il nome dell'endpoint dell'agente attivo basato sulla sessione per tale agente. Creare un endpoint agente se l'agente non dispone di un endpoint attivo che è possibile utilizzare. Per assistenza, vedere Creazione di un endpoint.
• Se l'endpoint dell'agente si trova in una tenancy diversa dalla tenancy in cui si sta creando lo strumento Agente, ottenere l'OCID dell'endpoint dell'agente. Per assistenza, vedere Ottenere i dettagli di un endpoint.