Padrão do Agente Supervisor

Crie uma equipe de agentes Select AI liderada por supervisor que roteie solicitações de várias etapas para agentes de trabalhadores especializados e retorne uma resposta coordenada.

Um agente do supervisor Selecionar AI é o objeto Selecionar AI agent que controla uma equipe de agente liderada pelo supervisor no runtime. O objeto do agente supervisor recebe o prompt do usuário, seleciona o par agente-tarefa do colaborador que deve tratar cada subtarefa, passa pelo contexto necessário, aguarda esse resultado do colaborador e continua a selecionar o próximo par agente-tarefa até que possa retornar uma resposta final.

A imagem a seguir ilustra o padrão Selecionar agente supervisor AI.

Descrição da ilustração select-ai-supervisor-agentic-pattern.png

Quando Usar um Agente Supervisor

Use o padrão de supervisor quando a equipe precisar determinar os colaboradores ou a ordem de execução apropriados no tempo de execução. Uma equipe liderada pelo supervisor pode ajudar quando uma solicitação requer diferentes colaboradores, em diferentes ordens, dependendo da intenção do usuário e dos resultados intermediários. O supervisor decide qual par de agentes/tarefas do colaborador chamar a seguir, passa por uma subtarefa independente, aguarda o resultado e continua até que possa produzir uma resposta final coordenada.

Um agente supervisor é adequado para:

• Fluxos de trabalho que abrangem domínios técnicos ou comerciais distintos.
• Solicitações que exigem agentes, ferramentas ou origens de dados diferentes.
• Equipes de agentes que exigem um único ponto de entrada para rotear e coordenar solicitações.
• Fluxos de trabalho nos quais o supervisor deve gerenciar a sequência de interação e consolidar respostas do subagente.

Sobre Selecionar Equipes do Agente do Supervisor de IA

Entenda como uma equipe de supervisor do Select AI coordena os agentes do colaborador, controla o roteamento de tarefas, preserva o contexto e retorna uma resposta final.

Uma equipe de agente do supervisor é um padrão de orquestração para uma equipe de agente Selecionar AI. Nessa equipe, um objeto do agente Selecionar AI é identificado como o supervisor, definindo seu atributo supervisor como true e os nomes da equipe que o objeto no atributo supervisor_agent. Os agentes colaboradores mantêm responsabilidades focadas, como pesquisa de conta, recuperação de pagamento, geração de relatórios ou entrega de notificações. O objeto do agente do supervisor decide qual colaborador chamar, prepara uma solicitação independente para esse colaborador e adiciona o resultado do colaborador de volta ao contexto do supervisor.

O processamento da subtarefa é sequencial: uma subtarefa de colaborador deve ser concluída antes que o supervisor delegue a próxima subtarefa. O supervisor aguarda o resultado do colaborador, adiciona o resultado ao contexto do supervisor e decide se deve chamar outro colaborador, solicitar mais informações, explicar uma falha do colaborador ou retornar a resposta final. Os agentes de trabalho usam threads de conversa separados, de modo que o supervisor deve incluir contexto suficiente em cada solicitação delegada.

O recurso adiciona atributos relacionados ao supervisor a APIs DBMS_CLOUD_AI_AGENT existentes. Use o atributo do agente supervisor para marcar um objeto de agente Selecionar AI como o supervisor. Use o atributo de equipe supervisor_agent para nomear esse objeto de agente do supervisor para uma equipe. Uma equipe supervisionada contém um objeto do agente supervisor e um ou mais pares de agente-tarefa do colaborador. O atributo da equipe agents lista os pares agente-tarefa do colaborador disponíveis para delegação. Cada tarefa do colaborador pode usar suas ferramentas configuradas. O objeto do agente do supervisor delega a pares agente-tarefa do colaborador; a ferramenta de delegação mantida pela Oracle não é configurável pelo usuário.

Consulte Exemplo: Criar e Executar uma Equipe de Supervisor de Suporte ao Cliente para obter um exemplo completo de uso de um agente supervisor.

Selecionar Arquitetura do Agente do Supervisor de IA

Uma equipe supervisionada do agente Select AI é executada como uma única equipe com um objeto do agente supervisor e um ou mais pares de agente-tarefa do colaborador. A definição da equipe nomeia o objeto do agente do supervisor em supervisor_agent; a lista de colaboradores nomeia os pares agente-tarefa para os quais o supervisor pode delegar. As ferramentas são configuradas nas tarefas do colaborador, não na equipe.

Em uma equipe liderada pelo supervisor, o processo ainda é definido como sequencial, mas a ordem do colaborador configurada não é o plano de workflow. O supervisor seleciona dinamicamente um par de agente/tarefa do colaborador de cada vez, aguarda o resultado e, em seguida, decide se outro colaborador é necessário.

O objeto do agente supervisor usa uma ferramenta de delegação mantida pela Oracle internamente para delegar a um par de agente-tarefa do colaborador. A ferramenta de delegação faz parte do modelo de execução do supervisor e não é listada como um atributo de equipe configurável pelo usuário.

O supervisor possui a solicitação geral e é executado em seu próprio thread de conversa. Cada agente de trabalho é executado em um thread de conversa separado. Um colaborador não herda o contexto de supervisor completo. O supervisor deve criar uma solicitação de subtarefa independente para cada colaborador. O colaborador retorna apenas o resultado final ao supervisor. O supervisor adiciona o resultado retornado ao seu próprio contexto e decide a próxima ação.

Descrição da ilustração select-ai-supervisor-agent-workflow.png

Comportamento de Tempo de Execução em Equipes Orientadas por Supervisor

Saiba como as equipes lideradas pelo supervisor fazem uma pausa para a entrada do usuário, lidam com falhas do colaborador e passam por um contexto independente entre as conversas do supervisor e do colaborador.

Tratamento de Entrada Humana

Quando um colaborador solicita uma entrada humana, toda a equipe liderada pelo supervisor faz uma pausa enquanto aguarda a resposta do usuário. O usuário continua na mesma conversa para fornecer as informações solicitadas.

Depois que o usuário responde, o colaborador retoma, conclui a tarefa e retorna o resultado ao supervisor. Em seguida, o supervisor decide se delega outra subtarefa ou retorna a resposta final.

Tratamento de Falhas

As falhas do colaborador seguem o mesmo caminho de retorno dos resultados bem-sucedidos. O supervisor recebe o resultado da falha e decide a próxima ação, como tentar novamente a tarefa, chamar outro par de agentes/tarefas do colaborador, solicitar entrada adicional ou retornar uma resposta final.

Modelo de Aprovação de Contexto

Cada colaborador opera em seu próprio thread de conversa e não herda o contexto de supervisor completo. O supervisor deve fornecer uma solicitação de subtarefa independente que inclua todas as informações necessárias para que o colaborador conclua a tarefa.

Casos de Uso para Agente Supervisor

Selecione equipes de IA quando uma solicitação pode exigir vários agentes especializados, roteamento condicional ou uma resposta preparada.

• Responda a uma solicitação de suporte ao cliente que precise de detalhes da conta, histórico de pagamento e uma resposta combinada final.
• Encaminhe um prompt de análise de dados para o colaborador certo com base na origem de dados e, em seguida, combine os resultados do colaborador em uma resposta.
• Peça a um colaborador que faça uma pausa na confirmação humana antes de enviar uma notificação ou concluir uma ação de negócios.
• Use uma equipe de supervisor para solicitações que, às vezes, exigem um colaborador e, às vezes, vários colaboradores em sequência.
• Rastreie as transferências de colaboradores e os resultados retornados para auditoria, teste e solução de problemas.

Benefícios

Use equipes lideradas por supervisores para rotear solicitações em várias etapas, manter os agentes do colaborador focados e registrar caminhos de delegação para a atividade de estrutura Selecionar agente de IA.

• Roteamento de tarefas dinâmico: O supervisor seleciona o próximo colaborador com base na solicitação atual e no contexto retornado.
• Design de colaborador focado: cada colaborador lida com uma área de tarefa limitada, que mantém prompts e mapeamentos de ferramentas mais fáceis de manter.
• Controle de contexto: O supervisor passa apenas o contexto necessário para cada subtarefa do colaborador.
• Rastreabilidade: As exibições de histórico da equipe e da tarefa podem mostrar o caminho de delegação e os resultados retornados do colaborador.
• Crescimento incremental da equipe: adicione novos agentes para novas tarefas sem reprojetar todos os colaboradores existentes.