Creación de equipos de agentes dirigidos por supervisores con IA seleccionada

Cree un equipo de agentes Select AI dirigido por el supervisor que envíe solicitudes de varios pasos a agentes de trabajadores especializados y devuelva una respuesta coordinada.

Un agente supervisor de Select AI es el objeto Select AI agent que controla un equipo de agentes dirigido por el supervisor en tiempo de ejecución. El objeto de agente de supervisor recibe la petición de datos de usuario, selecciona el par agente-tarea de trabajador que debe manejar cada subtarea, pasa el contexto necesario, espera el resultado de ese trabajador y continúa seleccionando el siguiente par agente-tarea hasta que pueda devolver una respuesta final.

La siguiente imagen ilustra el patrón de agente Seleccionar supervisor de IA. Descripción de select-ai-supervisor-agent-pattern.png

Cuándo utilizar un agente supervisor

Utilice el patrón de supervisor cuando el equipo deba determinar los trabajadores adecuados o la orden de ejecución en tiempo de ejecución. Un equipo dirigido por un supervisor puede ayudar cuando una solicitud requiere diferentes trabajadores, en diferentes órdenes, según la intención del usuario y los resultados intermedios. El supervisor decide a qué par agente-tarea del trabajador llamar a continuación, pasa una subtarea autónoma, espera el resultado y continúa hasta que puede producir una respuesta final coordinada.

Un agente supervisor es adecuado para:

Flujos de trabajo que abarcan distintos dominios empresariales o técnicos.
Solicitudes que requieren diferentes agentes, herramientas u orígenes de datos.
Equipos de agentes que necesitan un único punto de entrada para el enrutamiento y la coordinación de solicitudes.
Flujos de trabajo en los que el supervisor debe gestionar la secuencia de interacción y consolidar las respuestas de subagentes.

Acerca de los equipos de agentes de supervisión de IA

Comprenda cómo un equipo de agentes supervisores de Select AI coordina agentes de trabajadores, controla el enrutamiento de tareas, conserva el contexto y devuelve una respuesta final.

Un equipo de agente supervisor es un patrón de orquestación para un equipo de agente de Select AI. En ese equipo, se identifica un objeto de agente Select AI como supervisor definiendo su atributo supervisor en true y los nombres de equipo que el objeto en el atributo supervisor_agent. Los agentes de trabajadores mantienen responsabilidades centradas, como la consulta de cuentas, la recuperación de pagos, la generación de informes o la entrega de notificaciones. El objeto de agente de supervisor decide a qué trabajador llamar, prepara una solicitud independiente para ese trabajador y vuelve a agregar el resultado del trabajador al contexto de supervisor.

El proceso de subtarea es secuencial: una subtarea de trabajador debe finalizar antes de que el supervisor delegue la siguiente subtarea. El supervisor espera el resultado del trabajador, agrega el resultado al contexto del supervisor y, a continuación, decide si llama a otro trabajador, solicita más información, explica un fallo del trabajador o devuelve la respuesta final. Los agentes de trabajador utilizan hilos de conversación independientes, por lo que el supervisor debe incluir suficiente contexto en cada solicitud delegada.

La función agrega atributos relacionados con el supervisor a las API DBMS_CLOUD_AI_AGENT existentes. Utilice el atributo de agente supervisor para marcar un objeto de agente Select AI como supervisor. Utilice el atributo de equipo supervisor_agent para asignar un nombre al objeto de agente de supervisor de un equipo. Un equipo supervisado contiene un objeto de agente de supervisor y uno o más pares de agente y tarea de trabajador. El atributo de equipo agents muestra los pares agente-tarea de trabajador disponibles para delegación. Cada tarea de trabajador puede utilizar sus herramientas configuradas. El objeto de agente de supervisor se delega a pares de agente-tarea de trabajador; la herramienta de delegación mantenida por Oracle no es configurable por el usuario.

Consulte Ejemplo: creación y ejecución de un equipo de supervisor de soporte al cliente para obtener un ejemplo completo de uso de un agente de supervisor.

Seleccionar arquitectura de agente de supervisor de IA

Un equipo de agente de Select AI supervisado se ejecuta como un único equipo con un objeto de agente de supervisor y uno o más pares de agente y tarea de trabajador. La definición de equipo nombra el objeto de agente de supervisor en supervisor_agent; la lista de trabajadores nombra los pares de agente y tarea a los que el supervisor puede delegar. Las herramientas se configuran en las tareas del trabajador, no en el equipo.

En un equipo dirigido por un supervisor, el proceso sigue definido como secuencial, pero el orden de trabajador configurado no es el plan de flujo de trabajo. El supervisor selecciona dinámicamente un par agente-tarea de trabajador a la vez, espera el resultado y, a continuación, decide si se necesita otro trabajador.

El objeto de agente de supervisor utiliza internamente una herramienta de delegación mantenida por Oracle para delegar a un par de agente-tarea de trabajador. La herramienta de delegación forma parte del modelo de ejecución del supervisor y no aparece como un atributo de equipo configurable por el usuario.

El supervisor es propietario de la solicitud general y se ejecuta en su propio thread de conversación. Cada agente de trabajador se ejecuta en un hilo de conversación independiente. Un trabajador no hereda el contexto completo del supervisor. El supervisor debe crear una petición de subtarea independiente para cada trabajador. El trabajador devuelve solo el resultado final al supervisor. El supervisor agrega el resultado devuelto a su propio contexto y decide la siguiente acción.

Descripción de imagen siguiente

Fase	Entrada	Procesando	Salida
Envío de solicitud	Solicitud de idioma natural del usuario enviada al equipo	El equipo supervisado activa primero al agente supervisor.	Se inicia el thread de conversación del supervisor para la solicitud.
Bucle de razonamiento de supervisor	Solicitud de usuario y contexto de supervisor actual	El supervisor decide si tiene suficiente información para responder o si debe delegar una subtarea.	Respuesta final o una solicitud de trabajador delegado.
Delegación de tareas	Par agente-tarea de trabajador seleccionado y contexto de subtarea independiente	El supervisor llama a la herramienta de delegación mantenida por Oracle para el par agente-tarea de trabajador seleccionado y espera.	La tarea de trabajador se inicia en su propio thread de conversación.
Procesamiento de tareas	Subtarea delegada y configuración de tarea de trabajador	El trabajador utiliza las herramientas configuradas en su tarea. Si necesita la entrada del usuario, el equipo espera la respuesta del usuario.	Resultado de trabajador, resultado de fallo de trabajador o solicitud de entrada humana.
Continuación del supervisor	Resultado de trabajador devuelto, resultado de fallo o respuesta del usuario	El supervisor agrega el resultado devuelto a su contexto y continúa con el razonamiento. El fallo sigue la misma ruta de devolución que el éxito; el supervisor decide si reintentar, llamar a otro trabajador, solicitar más información, explicar el fallo o devolver la respuesta final.

Comportamiento de tiempo de ejecución en equipos con supervisión

Descubra cómo los equipos dirigidos por supervisores hacen una pausa para la entrada de los usuarios, gestionan los fallos de los trabajadores y pasan el contexto autónomo entre las conversaciones de supervisor y trabajador.

Gestión de entradas humanas

Cuando un trabajador solicita información humana, todo el equipo dirigido por el supervisor se detiene mientras espera la respuesta del usuario. El usuario continúa en la misma conversación para proporcionar la información solicitada.

Una vez que el usuario responde, el trabajador reanuda, completa la tarea y devuelve el resultado al supervisor. A continuación, el supervisor decide si delega otra subtarea o devuelve la respuesta final.

Gestión de fallos

Los fallos de trabajador siguen la misma ruta de devolución que los resultados correctos. El supervisor recibe el resultado del fallo y decide la siguiente acción, como reintentar la tarea, llamar a otro par agente-tarea de trabajador, solicitar una entrada adicional o devolver una respuesta final.

Modelo de Transferencia de Contexto

Cada trabajador opera en su propio hilo de conversación y no hereda el contexto completo del supervisor. El supervisor debe proporcionar una petición de subtarea independiente que incluya toda la información necesaria para que el trabajador complete la tarea.

Casos de uso para agente de supervisor

Aplicar equipos Select AI dirigidos por supervisores cuando una solicitud puede requerir varios agentes especializados, enrutamiento condicional o una respuesta temporal.

Responda a una solicitud de soporte al cliente que necesite detalles de la cuenta, historial de pagos y una respuesta combinada final.
Enrutar una petición de datos de análisis de datos al trabajador adecuado en función del origen de datos y, a continuación, combinar los resultados del trabajador en una respuesta.
Pida a un trabajador que haga una pausa para la confirmación humana antes de enviar una notificación o completar una acción de negocio.
Utilice un equipo de supervisor para las peticiones que a veces requieren un trabajador y a veces varios trabajadores en secuencia.
Realice un seguimiento de las transferencias de trabajadores y los resultados devueltos para la auditoría, las pruebas y la resolución de problemas.

Ventajas

Utilice equipos dirigidos por supervisores para enviar solicitudes de varios pasos, mantener centrados a los agentes de trabajadores y registrar rutas de delegación para la actividad de marco de agente de selección de IA.

Enrutamiento dinámico de tareas: el supervisor selecciona el siguiente trabajador en función de la solicitud actual y el contexto devuelto.
Diseño de trabajador centrado: cada trabajador maneja un área de tarea delimitada, que mantiene las peticiones de datos y las asignaciones de herramientas más fáciles de mantener.
Control de contexto: el supervisor solo transfiere el contexto necesario para cada subtarea de trabajador.
Rastreo: las vistas del historial de tareas y del equipo pueden mostrar la ruta de delegación y los resultados del trabajador devueltos.
Crecimiento incremental del equipo: agregue nuevos agentes de trabajadores para nuevas tareas sin rediseñar a todos los trabajadores existentes.

Cómo utilizar los equipos de agentes de supervisión de IA seleccionados

Cree el agente para que actúe como supervisor y lo designe como supervisor, cree agentes de trabajador, agregue el supervisor a los atributos del equipo y ejecute peticiones de datos de usuario para el equipo.

Otorgue los privilegios necesarios. El usuario de la base de datos debe tener el privilegio EXECUTE en DBMS_CLOUD_AI_AGENT, acceso a las credenciales necesarias y las ACL de red necesarias para las llamadas de proveedor externo. Consulte Requisitos para utilizar Select AI Agent para obtener más información.
Cree las herramientas que utilizan los agentes de trabajador, como las funciones PL/SQL para tareas de consulta, actualización, notificación o generación de informes. Consulte DBMS_CLOUD_AI_AGENT Package y Ejemplos de uso de Select AI Agent para obtener más información.
Cree agentes de trabajador y tareas. Mantenga cada rol de trabajador específico para que el supervisor pueda seleccionar el trabajador adecuado para cada subtarea. Consulte Procedimiento CREATE_TASK y Procedimiento CREATE_AGENT.
Cree un agente de supervisor con el atributo supervisor definido en true. Consulte CREATE_AGENT Attributes.
Cree el equipo con supervisor_agent definido en el nombre del agente de supervisor y agents definido en los pares de agente y tarea de trabajador. Consulte CREATE_TEAM Procedure.
Defina el equipo para la sesión y envíe peticiones de datos en lenguaje natural con el marco Select AI Agent. Consulte SET_TEAM Function.
Revise las vistas del historial para confirmar el enrutamiento del trabajador, los resultados devueltos, los fallos del trabajador y los estados de espera de entrada humana. Si una tarea de trabajador solicita la entrada humana, el equipo se detiene hasta que el usuario responde. Todo el equipo dirigido por el supervisor se detiene durante este tiempo. Continúe con la misma conversación para proporcionar la entrada solicitada. Una vez que el usuario responde, el trabajador reanuda, completa la tarea y devuelve el resultado al supervisor. El supervisor decide la siguiente acción. Consulte DBMS_CLOUD_AI_AGENT Vistas.

No incluya el supervisor seleccionado de la matriz del trabajador agents. El supervisor controla el equipo, mientras que la lectura de datos muestra sólo los pares agente-tarea del trabajador disponibles para la delegación. Una tarea de trabajador puede utilizar sus propias herramientas configuradas; el atributo de equipo no muestra los nombres de las herramientas.

Nota: Los equipos dirigidos por supervisores procesan las subtareas de trabajador de forma secuencial. El supervisor espera el resultado de cada trabajador antes de delegar otra subtarea. La ejecución de trabajador en paralelo no forma parte de esta versión.

Configuraciones de equipo de agente de supervisor permitidas

Revise las configuraciones y la orientación admitidas para definir supervisores, pares de agentes y tareas de trabajador, herramientas y procesamiento en un equipo de agentes de Select AI.

Configuración	¿Se permite?	Orientación
`supervisor_agent` nombra a un agente creado con `supervisor` definido en `true`	Sí	Utilice este patrón para los equipos supervisados.
El supervisor seleccionado también se muestra en la matriz `agents` del trabajador	No	Un agente designado como supervisor no se puede incluir en la matriz de trabajadores. La validación de diseño rechaza los agentes activados para supervisor en la matriz `agents`.
El mismo agente de trabajador está asignado a más de una tarea	Sí	El mismo agente puede realizar varias tareas asignando el mismo agente a diferentes nombres de tareas.
Las herramientas se muestran en la matriz `agents` del equipo	No	Defina herramientas en las tareas con `CREATE_TASK`. El atributo de equipo muestra los pares agente-tarea de trabajador, no los nombres de herramienta.
`supervisor_agent` nombra a un agente que no tiene `"supervisor": true`	No	Seleccione un agente con `supervisor` definido en `true`. Si el agente con nombre no es un supervisor, falla la creación o validación del equipo; compruebe los detalles del error de la base de datos devuelta.
Se ha definido más de un supervisor para un equipo	No	Un equipo apoya exactamente a un supervisor. Defina un único agente con `"supervisor": true` y haga referencia a él en `supervisor_agent`.
Un supervisor delega a otro equipo dirigido por un supervisor	No	La delegación de supervisor a supervisor no se admite en esta versión. Un supervisor solo puede delegar a agentes de trabajadores del mismo equipo.
Un agente designado como supervisor en un equipo se puede utilizar como trabajador en otro equipo	Sí	Puede reutilizar el mismo agente de supervisor en varios equipos con diferentes roles (supervisor o trabajador). Defina el rol mediante la configuración del equipo.

Nota:

El marco no aplica un número máximo de turnos de conversación. Para una ejecución de tarea, el marco limita los reintentos de llamadas fallidas a 10 intentos por tarea.
El marco no introduce nuevos puntos de vista para el seguimiento. Puede revisar el historial de ejecución de equipos, tareas y herramientas mediante las vistas existentes del historial de marco Seleccionar agente de IA. Consulte DBMS_CLOUD_AI_AGENT Vistas de historial para obtener más información.

Solución de problemas de equipos con supervisión

Identifique las posibles causas y correcciones de los problemas comunes de configuración, delegación, contexto, notificación e introducción humana del equipo dirigido por el supervisor de Select AI.

Fallo de creación de equipo

Problema: la creación del equipo falla.

Causa probable: supervisor_agent no nombra a un agente con "supervisor": true.

Corregir: vuelva a crear el agente con el atributo de supervisor y, a continuación, vuelva a crear el equipo.

El supervisor llama al trabajador equivocado

Problema: el supervisor llama al trabajador incorrecto.

Causa probable: las descripciones de las tareas del trabajador son demasiado vagas o se superponen.

Corregir: haga que las instrucciones de la tarea sean más específicas y se excluyan mutuamente. El supervisor selecciona pares de agente y tarea de trabajador en función de los nombres de agente, los nombres de tarea, las descripciones y las instrucciones de tarea.

Utilice estas directrices al definir tareas de trabajador:

Defina un límite de dominio claro para cada trabajador.
Utilice nombres de tarea específicos, como ACCOUNT_MANAGEMENT_TASK o PAYMENT_LOOKUP_TASK.
Evite la superposición de instrucciones entre los trabajadores.
Incluya los parámetros de entrada esperados en la instrucción de tarea.
Especifique cuándo debe solicitar el trabajador la entrada humana.
Definición del formato del resultado devuelto al supervisor.

Un trabajador carece de contexto

Problema: un trabajador carece de contexto.

Causa probable: el supervisor no pasó los detalles suficientes en la subtarea delegada.

Corrección: agregue instrucciones que indiquen al supervisor que envíe subtareas independientes. Defina un rol de supervisor claro para guiar el comportamiento de la delegación.

Por ejemplo:

{
  "profile_name": "<AI_PROFILE_NAME>",
  "supervisor": true,
  "role": "You orchestrate requests. Choose the appropriate worker agent-task pair for each subtask. Send self-contained requests with all required context. Return one concise final answer."
}

El correo electrónico no se envía

Problema: el correo electrónico no se envía.

Causa probable: falta la configuración de la credencial, la ACL de red, el remitente o el destinatario o es incorrecta.

Corregir: verifique la configuración de credenciales SMTP, ACL, remitente y destinatario.

La petición de datos espera la entrada del usuario

Problema: la petición de datos espera la entrada del usuario.

Causa probable: un supervisor o trabajador solicitó la confirmación humana.

Corregir: continúe la misma conversación con la información solicitada.

Comparación de Patrones de Supervisor y Flujo de Trabajo Secuencial

Seleccione el patrón de selección de equipo de agente de IA adecuado en función de cómo el equipo debe seleccionar trabajadores y coordinar tareas.

Seleccione el patrón de flujo de trabajo secuencial cuando el equipo debe ejecutar pares de agente y tarea configurados en un orden conocido. Seleccione el modelo de supervisor cuando el equipo debe seleccionar trabajadores en tiempo de ejecución en función de la petición, los resultados intermedios, los fallos o las peticiones de más información.

Característica	Patrón de flujo de trabajo secuencial	Patrón de supervisor
Ejecutar plan	Fijo. La matriz `agents` define el orden del flujo de trabajo.	Variable. El supervisor selecciona al siguiente trabajador en tiempo de ejecución.
Punto de entrada	El primer par agente-tarea configurado.	El agente supervisor.
Selección de tareas	El equipo ejecuta pares de agente y tarea configurados en orden.	El supervisor llama a uno o más trabajadores según sea necesario.
Transferencia de contexto	Las dependencias de tareas transfieren la salida de la tarea anterior a las tareas descendentes.	El supervisor envía a cada trabajador una subtarea independiente.
Ideal para	Pipelines predecibles con etapas conocidas.	Solicitudes variables que necesitan coordinación o enrutamiento condicional.
Ejecuciones paralelas	No admitido. Las tareas se ejecutan de una en una.	No admitido. Las subtareas de trabajador se ejecutan de una en una.

En la siguiente tabla se proporcionan diferencias entre el patrón secuencial y el patrón de supervisor que pueden ayudarle a decidir el flujo de trabajo.

Patrón secuencial	Patrón de supervisor
Flujo de trabajo fijo	Orquestación dinámica
Cada paso se ejecuta en orden	Solo se ejecutan los pasos necesarios
Bueno para tuberías lineales	Bueno para bifurcar solicitudes empresariales
Menos lógica de decisión	Menos lógica de enrutamiento manual, más juicio en tiempo de ejecución