Directrices de la herramienta de agentes en agentes de IA generativa

Comprender las propiedades y responsabilidades de un agente supervisor y sus agentes colaboradores.

• El agente supervisor y un agente colaborador pueden pertenecer a distintos arrendamientos.

• Un agente colaborador puede ser un agente con cualquier tipo de herramienta (como la herramienta RAG) o una combinación de tipos de herramienta (como las herramientas de llamada RAG y Function), siempre que el agente esté asociado a un punto final de agente activo.

• El agente que está configurado como herramienta de agente puede funcionar de forma independiente y estar integrado en un agente supervisor.

• Se pueden incluir herramientas adicionales (como RAG y SQL) en el agente supervisor con agentes colaboradores.

• El agente supervisor es responsable de:

  • Gestión de sesiones y enrutamiento de consultas

  • Agregación de respuestas de agentes o herramientas de colaboradores

  • Mantenimiento de un historial de chat global

• Un agente colaborador es responsable de:

  • Gestión de consultas relevantes para su especialización (por ejemplo, RR. HH.)
  • Mantenimiento de un historial de chat localizado vinculado a la sesión global.

• Las métricas y la facturación se gestionan por separado para el agente supervisor, los agentes colaboradores y las herramientas.

Un posible escenario de flujo de datos que implique respuestas de varios agentes colaboradores se puede describir de la siguiente manera:

1. Un usuario envía una consulta al agente supervisor en una sesión de chat. La consulta abarca más de una especialización.
2. El agente de supervisor divide la consulta y delega las subconsultas a los agentes de colaborador relevantes en función de la lógica de enrutamiento.
3. Cada agente colaborador procesa su subconsulta utilizando su contexto de sesión. Los agentes colaboradores devuelven sus respuestas al agente supervisor.
4. El agente supervisor agrega y formatea las respuestas en una salida consolidada y envía la salida al usuario.

El flujo de trabajo para implementar agentes colaboradores y un agente supervisor es:

1. Comprender y agregar las políticas de OCI Identity and Access Management (IAM) necesarias. Consulte Políticas de IAM.
2. Cree los agentes colaboradores con cualquier herramienta. Si necesita ayuda, consulte Creación de un agente.
3. Asegúrese de que cada agente colaborador tiene un punto final de agente asociado que está activo y activado para la sesión. Si necesita ayuda, consulte Obtención de detalles de un punto final.
4. Cree el agente supervisor. Utilice el tipo Herramienta de agente para agregar los agentes colaboradores. Si necesita ayuda, consulte Creación de una herramienta de agente.
5. Asegúrese de que el punto final del agente para el agente supervisor está activado para la sesión. Si necesita ayuda, consulte Obtención de detalles de un punto final.

Asegúrese de otorgar a los usuarios acceso a todos los recursos de agentes de IA generativa, como se describe en Adición de políticas antes de que pueda utilizar el servicio.

Revise también las siguientes secciones.

Grupo dinámico y política

Debe agregar un grupo dinámico con permiso para gestionar genai-agent-family.

1. Cree un grupo dinámico y agregue la siguiente regla de coincidencia.

   ALL {resource.type='genaiagent'}

   Si necesita ayuda, consulte Creación de un grupo dinámico.

2. Permita el grupo dinámico.

   • Escriba la siguiente política, que se puede utilizar con el dominio de identidad por defecto:

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

   • Utilice la siguiente política con un dominio de identidad que no sea por defecto, proporcionando el nombre de dominio de Oracle Identity Cloud Service (IDCS) y el nombre de grupo dinámico:

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

   Consulte Acerca de los tipos de recursos de agentes de IA generativa para asignar permisos basados en tipos de recursos individuales en lugar del tipo de recurso agregado.

Acceso entre arrendamientos

Para utilizar un punto final de agente que sea de otro arrendamiento, se deben configurar determinadas políticas en el arrendamiento de destino y en el arrendamiento en el que está creando la herramienta Agente. Recopile la siguiente información:

• El nombre del arrendamiento de destino y el OCID. El arrendamiento de destino es el arrendamiento que tiene el punto final de agente activo que desea utilizar.
• El nombre de arrendamiento y el OCID en los que está creando una herramienta de agente.
• Nombre del grupo dinámico y OCID.

Escriba las siguientes sentencias de política entre arrendamientos. Si corresponde, utilice el formato '<idcs-domain-name>/<dynamic-group-name>' en la sintaxis para el uso en un dominio de identidad que no sea por defecto.

En el arrendamiento en el que está creando una herramienta Agent:

<target-tenancy> es el arrendamiento que tiene el punto final de agente activo que desea utilizar.

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

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

En el arrendamiento de destino:

<this-tenancy> es el arrendamiento en el que está creando una herramienta de 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

Si necesita ayuda, consulte Políticas de acceso entre arrendamientos en la documentación de OCI IAM con dominios de identidad.

Una herramienta de agente solo soporta un agente con un punto final de agente que tiene activada la sesión.

Cuando la sesión está activada en un punto final de agente para mantener el contexto de una sesión de chat, los agentes de IA generativa crean un ID de sesión y mantienen la sesión de agente para la conversación interactiva. Durante la sesión, el contexto y la continuidad se mantienen para proporcionar respuestas coherentes y significativas a lo largo de la conversación.

Para un agente colaborador que se va a configurar en un agente supervisor, asegúrese de que el agente solo tiene un punto final de agente basado en sesión. El agente de supervisor también debe estar asociado solo a un punto final de agente que tenga activada la sesión.

Por defecto, cuando utiliza la consola para crear un agente y decide crear automáticamente el punto final del agente al mismo tiempo, la sesión se activa en el punto final del agente que se crea con el agente. Para verificarlo, puede ver los detalles del punto final en el agente.

Si crea un punto final de agente manualmente, asegúrese de que Activar sesión está seleccionado si el punto final se va a configurar con una herramienta de agente.

Antes de crear una herramienta Agent, recopile la siguiente información:

• Nombre del agente que se va a agregar como herramienta.
• Nombre del punto final de agente activo basado en sesión para ese agente. Cree un punto final de agente si el agente no tiene un punto final activo que pueda utilizar. Si necesita ayuda, consulte Creación de un punto final.
• Si el punto final del agente está en un arrendamiento diferente del arrendamiento en el que está creando la herramienta Agente, obtenga el OCID del punto final del agente. Si necesita ayuda, consulte Obtención de detalles de un punto final.