Crie equipes de agentes orientadas por supervisor com o Select AI

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 de select-ai-supervisor-agent-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 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 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.

A descrição da imagem é exibida

Fase	Entrada	Processamento	Saída
Envio da solicitação	Solicitação de idioma natural do usuário enviada à equipe	A equipe supervisionada ativa o agente supervisor primeiro.	O thread da conversa do supervisor é iniciado para a solicitação.
Loop de raciocínio do supervisor	Solicitação do usuário e contexto do supervisor atual	O supervisor decide se tem informações suficientes para responder ou deve delegar uma subtarefa.	Resposta final ou uma solicitação de colaborador delegado.
Delegação de tarefa	Par de agente-tarefa do colaborador selecionado e contexto de subtarefa independente	O supervisor chama a ferramenta de delegação mantida pela Oracle para o par de agente-tarefa do colaborador selecionado e aguarda.	A tarefa do colaborador é iniciada em seu próprio thread de conversa.
Processamento da tarefa	Configuração de subtarefa delegada e tarefa do colaborador	O colaborador usa as ferramentas configuradas em sua tarefa. Se precisar de entrada do usuário, a equipe aguardará a resposta do usuário.	Resultado do colaborador, resultado da falha do colaborador ou uma solicitação de entrada humana.
Continuidade do supervisor	Resultado do colaborador retornado, resultado da falha ou resposta do usuário	O supervisor adiciona o resultado retornado ao contexto e continua o raciocínio. O fracasso segue o mesmo caminho de retorno que o sucesso; o supervisor decide se quer tentar novamente, ligar para outro colaborador, solicitar mais informações, explicar o fracasso ou retornar a resposta final.

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.

Como Usar as Equipes Selecionar Agente do Supervisor de IA

Crie o agente para servir como supervisor e designá-lo como supervisor, crie agentes colaboradores, adicione o supervisor aos atributos da equipe e execute prompts de usuário para a equipe.

Conceda os privilégios necessários. O usuário do banco de dados deve ter o privilégio EXECUTE em DBMS_CLOUD_AI_AGENT, acesso às credenciais necessárias e as ACLs de rede necessárias para chamadas do provedor externo. Consulte Pré-requisitos para Usar o Select AI Agent para obter mais informações.
Crie as ferramentas que os agentes de trabalho usam, como funções PL/SQL para tarefas de pesquisa, atualização, notificação ou geração de relatórios. Consulte Pacote DBMS_CLOUD_AI_AGENT e Exemplos de Uso do Select AI Agent para obter mais informações.
Criar agentes e tarefas do colaborador. Mantenha cada função de colaborador específica para que o supervisor possa selecionar o colaborador certo para cada subtarefa. Consulte CREATE_TASK Procedures e CREATE_AGENT Procedure.
Crie um agente do supervisor com o atributo supervisor definido como true. Consulte CREATE_AGENT Atributos.
Crie a equipe com supervisor_agent definido como o nome do agente do supervisor e agents definido como os pares agente-tarefa do colaborador. Consulte CREATE_TEAM Procedure.
Defina a equipe para a sessão e envie prompts de linguagem natural com a estrutura Selecionar Agente AI. Consulte Função SET_TEAM.
Revise as exibições de histórico para confirmar o roteamento do colaborador, os resultados retornados, as falhas do colaborador e os estados de espera de entrada humana. Se uma tarefa do colaborador solicitar entrada humana, a equipe fará uma pausa até que o usuário responda. Toda a equipe liderada pelo supervisor faz uma pausa durante esse tempo. Continue a mesma conversa para fornecer a entrada solicitada. Depois que o usuário responde, o colaborador retoma, conclui a tarefa e retorna o resultado ao supervisor. O supervisor então decide a próxima ação. Consulte DBMS_CLOUD_AI_AGENT Views.

Não inclua o supervisor selecionado no array do colaborador agents. O supervisor controla a equipe, enquanto a matriz lista apenas os pares de agente/tarefa do colaborador disponíveis para delegação. Uma tarefa de colaborador pode usar suas próprias ferramentas configuradas; o atributo de equipe não lista nomes de ferramentas.

Observação: as equipes lideradas pelo supervisor processam as subtarefas do colaborador sequencialmente. O supervisor aguarda o resultado de cada trabalhador antes de delegar outra subtarefa. A execução paralela do worker não faz parte desta versão.

Configurações Permitidas da Equipe do Agente do Supervisor

Revise as configurações e orientações suportadas para definir supervisores, pares de agente-tarefa do colaborador, ferramentas e processamento em uma equipe de agente Select AI.

Configuração	Permitido?	Orientação
`supervisor_agent` nomeia um agente criado com o `supervisor` definido como `true`	Sim	Use esse padrão para equipes supervisionadas.
O supervisor selecionado também é listado no array `agents` do colaborador	Não	Um agente designado como supervisor não pode ser incluído na matriz do colaborador. A validação de design rejeita agentes ativados pelo supervisor no array `agents`.
O mesmo agente do colaborador está atribuído a mais de uma tarefa	Sim	O mesmo agente pode executar várias tarefas atribuindo o mesmo agente a nomes de tarefas diferentes.
As ferramentas são listadas no array `agents` da equipe	Não	Defina ferramentas em tarefas com o `CREATE_TASK`. O atributo da equipe lista pares agente-tarefa do colaborador, não nomes de ferramentas.
`supervisor_agent` nomeia um agente que não tem `"supervisor": true`	Não	Selecione um agente com `supervisor` definido como `true`. Se o agente nomeado não for um supervisor, a criação ou validação da equipe falhará; verifique os detalhes do erro do banco de dados retornado.
Mais de um supervisor está definido para uma equipe	Não	Uma equipe apoia exatamente um supervisor. Defina um único agente com `"supervisor": true` e faça referência a ele em `supervisor_agent`.
Um supervisor delega para outra equipe liderada pelo supervisor	Não	A delegação de supervisor para supervisor não é suportada nesta versão. Um supervisor só pode delegar a agentes do colaborador na mesma equipe.
Um agente designado como supervisor em uma equipe pode ser usado como colaborador em outra equipe	Sim	Você pode reutilizar o mesmo agente supervisor em várias equipes com diferentes funções (supervisor ou colaborador). Defina a função por meio da configuração da equipe.

Observação:

A estrutura não impõe um número máximo de giros de conversa. Para uma execução de tarefa, a estrutura limita repetições para chamadas de ferramenta com falha a 10 tentativas por tarefa.
O quadro não introduz novos pontos de vista para o acompanhamento. Você pode revisar o histórico de execução de equipe, tarefa e ferramenta usando as exibições existentes do histórico da estrutura Selecionar Agente AI. Consulte DBMS_CLOUD_AI_AGENT Visualizações de Histórico para obter mais informações.

Solucionando Problemas de Equipes Conduzidas pelo Supervisor

Identifique possíveis causas e correções para configuração de equipe, delegação, contexto, notificação e problemas de entrada humana conduzidos pelo supervisor do Select AI.

Falha na Criação da Equipe

Problema: falha na criação da equipe.

Provável Causa: supervisor_agent não nomeia um agente com "supervisor": true.

Corrigir: Recrie o agente com o atributo de supervisor e, em seguida, crie a equipe novamente.

O Supervisor Chama o Trabalhador Errado

Problema: O supervisor chama o colaborador errado.

Provável Causa: As descrições das tarefas do colaborador são muito vagas ou sobrepostas.

Corrigir: Torne as instruções da tarefa mais específicas e mutuamente exclusivas. O supervisor seleciona pares agente-tarefa do colaborador com base em nomes de agentes, nomes de tarefas, descrições e instruções de tarefas.

Use estas diretrizes ao definir tarefas do trabalhador:

Defina um limite de domínio claro para cada colaborador.
Use nomes de tarefa específicos, como ACCOUNT_MANAGEMENT_TASK ou PAYMENT_LOOKUP_TASK.
Evite sobrepor instruções entre colaboradores.
Incluir parâmetros de entrada esperados na instrução da tarefa.
Especifique quando o colaborador deve solicitar uma entrada humana.
Definir o formato do resultado retornado ao supervisor.

Um Colaborador Não Tem Contexto

Problema: Um colaborador não tem contexto.

Provável Causa: O supervisor não passou detalhes suficientes na subtarefa delegada.

Corrigir: Adicione instruções ao supervisor para enviar subtarefas independentes. Defina uma função de supervisor clara para orientar o comportamento de delegação.

Exemplo:

{
  "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."
}

E-mail não enviado

Problema: O e-mail não é enviado.

Provável Causa: A configuração de credencial, ACL de rede, remetente ou destinatário está ausente ou incorreta.

Corrigir: Verifique as definições de credencial SMTP, ACL, remetente e destinatário.

O Prompt Aguarda Entrada do Usuário

Problema: O prompt aguarda a entrada do usuário.

Provável Causa: um supervisor ou colaborador solicitou confirmação humana.

Corrigir: Continue a mesma conversa com as informações solicitadas.

Comparar Padrões Sequenciais de Workflow e Supervisor

Selecione o padrão de equipe-agente Selecionar IA apropriado com base em como a equipe deve selecionar colaboradores e coordenar tarefas.

Selecione o padrão de workflow sequencial quando a equipe tiver que executar pares de agente-tarefa configurados em uma ordem conhecida. Selecione o padrão do supervisor quando a equipe precisar selecionar trabalhadores em tempo de execução com base na solicitação, nos resultados intermediários, nas falhas ou nas solicitações de mais informações.

Característica	Padrão de Fluxo de Trabalho Sequencial	Padrão do Supervisor
Executar Plano	Corrigido. O array `agents` define a ordem do workflow.	Variável. O supervisor seleciona o próximo colaborador no tempo de execução.
Ponto de entrada	O primeiro par de agente-tarefa configurado.	O agente supervisor.
Seleção de tarefa	A equipe executa pares de agente-tarefa configurados na ordem.	O supervisor chama um ou mais colaboradores conforme necessário.
Passagem de contexto	As dependências da tarefa passam a saída da tarefa anterior para tarefas downstream.	O supervisor envia a cada trabalhador uma subtarefa independente.
Mais adequado para	Pipelines previsíveis com estágios conhecidos.	Solicitações variáveis que precisam de roteamento ou coordenação condicional.
Execuções paralelas	Não suportado. As tarefas são executadas uma de cada vez.	Não suportado. As subtarefas do colaborador são executadas uma de cada vez.

A tabela a seguir fornece diferenças entre o padrão Sequencial e o padrão de Supervisor que podem ajudá-lo a decidir seu workflow.

Padrão Sequencial	Padrão do Supervisor
Fluxo de trabalho fixo	Orquestração Dinâmica
Cada etapa é executada em ordem	Somente as etapas necessárias são executadas
Bom para tubulações lineares	Bom para ramificar solicitações empresariais
Menos lógica de decisão	Menos lógica de roteamento manual, mais julgamento de tempo de execução