Select AI로 감독자 주도 에이전트 팀 구축
다중 단계 요청을 전문화된 작업자 상담원에게 경로 지정하고 하나의 조정된 응답을 반환하는 상위자 주도 Select AI 상담원 팀을 생성합니다.
Select AI 상위자 에이전트는 런타임 시 상위자 주도 에이전트 팀을 제어하는 Select AI agent 객체입니다. 감독자 에이전트 객체는 사용자 프롬프트를 수신하고, 각 하위 작업을 처리해야 하는 작업자 에이전트-태스크 쌍을 선택하고, 필요한 컨텍스트를 전달하고, 해당 작업자 결과를 기다린 후 최종 답변을 반환할 때까지 다음 에이전트-태스크 쌍을 계속 선택합니다.
다음 이미지는 Select AI 상위자 에이전트 패턴을 보여줍니다. 
감독자 에이전트 사용 시기
팀이 런타임 시 적절한 근로자 또는 실행 순서를 결정해야 하는 경우 상위자 패턴을 사용합니다. 감독자 주도 팀은 사용자의 의도와 중간 결과에 따라 서로 다른 주문의 다른 근로자가 요청에 필요한 경우 도움을 줄 수 있습니다. 상위자는 다음에 호출할 근로자 에이전트-태스크 쌍을 결정하고, 자체 포함된 하위 태스크를 전달하고, 결과를 대기하고, 조정된 최종 답변 하나를 생성할 수 있을 때까지 계속합니다.
감독자 에이전트는 다음에 적합합니다.
- 고유한 비즈니스 또는 기술 도메인에 걸쳐 있는 워크플로우입니다.
- 다른 에이전트, 도구 또는 데이터 소스가 필요한 요청입니다.
- 요청 경로 지정 및 조정을 위해 단일 진입점이 필요한 상담원 팀입니다.
- 상위자가 상호 작용 순서를 관리하고 하위 에이전트 응답을 통합해야 하는 워크플로우입니다.
AI 상위자 에이전트 팀 선택 정보
Select AI 감독자 에이전트 팀이 작업자 에이전트를 조정하고, 작업 경로 지정을 제어하고, 컨텍스트를 보존하고, 하나의 최종 응답을 반환하는 방법을 이해할 수 있습니다.
상위자 에이전트 팀은 Select AI 에이전트 팀에 대한 통합관리 패턴입니다. 해당 팀에서 하나의 Select AI 에이전트 객체는 supervisor 속성을 true로 설정하고 supervisor_agent 속성에서 객체하는 팀 이름을 통해 상위자로 식별됩니다. 근로자 상담원은 계정 조회, 지급 검색, 보고서 생성 또는 통지 전달과 같은 집중적인 책임을 유지합니다. 상위자 에이전트 객체는 호출할 근로자를 결정하고, 해당 근로자에 대한 자체 포함 요청을 준비하고, 근로자 결과를 상위자 컨텍스트에 다시 추가합니다.
하위 태스크 처리는 순차적입니다. 상위자가 다음 하위 태스크를 위임하기 전에 한 작업자 하위 태스크가 완료되어야 합니다. 감독자는 근로자 결과를 기다린 후 감독자 컨텍스트에 결과를 추가한 다음 다른 근로자를 호출할지, 추가 정보를 요청할지, 근로자 실패를 설명할지 또는 최종 답변을 반환할지 결정합니다. 작업자 에이전트는 별도의 대화 스레드를 사용하므로 감독자는 각 위임된 요청에 충분한 컨텍스트를 포함해야 합니다.
이 기능은 기존 DBMS_CLOUD_AI_AGENT API에 상위자 관련 속성을 추가합니다. supervisor 에이전트 속성을 사용하여 Select AI 에이전트 객체를 상위자로 표시합니다. supervisor_agent team 속성을 사용하여 팀의 상위자 에이전트 객체 이름을 지정합니다. 감독되는 팀에는 하나의 감독자 에이전트 객체와 하나 이상의 작업자 에이전트-태스크 쌍이 포함됩니다. agents 팀 속성은 위임에 사용할 수 있는 근로자 에이전트-태스크 쌍을 나열합니다. 각 작업자 작업은 구성된 도구를 사용할 수 있습니다. 상위자 에이전트 객체는 작업자 에이전트-작업 쌍에 위임됩니다. Oracle 유지 관리 위임 툴은 사용자가 구성할 수 없습니다.
상위자 에이전트 사용의 엔드투엔드 예는 예제: 고객 지원 상위자 팀 빌드 및 실행을 참조하십시오.
AI 상위자 에이전트 구조 선택
감독되는 Select AI 에이전트 팀은 하나의 감독자 에이전트 객체와 하나 이상의 작업자 에이전트-태스크 쌍이 있는 단일 팀으로 실행됩니다. 팀 정의는 상위자 에이전트 객체의 이름을 supervisor_agent로 지정하고, 작업자 목록은 상위자가 위임할 수 있는 에이전트-태스크 쌍의 이름을 지정합니다. 도구는 팀이 아닌 작업자 작업에 대해 구성됩니다.
상위자 주도 팀에서 프로세스는 계속 순차적으로 설정되지만 구성된 근로자 주문은 워크플로우 계획이 아닙니다. 감독자는 한 번에 하나의 작업자 에이전트-태스크 쌍을 동적으로 선택하고 결과를 기다린 후 다른 작업자가 필요한지 여부를 결정합니다.
상위자 에이전트 객체는 내부적으로 Oracle 유지 관리 위임 도구를 사용하여 작업자 에이전트-작업 쌍에 위임합니다. 위임 도구는 감독자 실행 모델의 일부이며 사용자가 구성할 수 있는 팀 속성으로 나열되지 않습니다.
감독자는 전체 요청을 소유하고 자체 대화 스레드에서 실행됩니다. 각 작업자 에이전트는 별도의 대화 스레드에서 실행됩니다. 근로자는 전체 감독자 컨텍스트를 상속하지 않습니다. 상위자는 각 근로자에 대해 자체 포함된 하위 태스크 요청을 생성해야 합니다. 근로자는 최종 결과만 상위자에게 반환합니다. 감독자는 반환된 결과를 자체 컨텍스트에 추가하고 다음 작업을 결정합니다.
| 단계 | 입력 | 처리 중 | 출력 |
|---|---|---|---|
| 요청 제출 | 사용자 자연어 요청이 팀에 제출되었습니다. | 감독 팀은 먼저 감독자 에이전트를 활성화합니다. | 요청에 대한 상위자 대화 스레드가 시작됩니다. |
| 감독자 추론 루프 | 사용자 요청 및 현재 상위자 컨텍스트 | 상위자가 응답할 충분한 정보가 있는지 또는 하위 태스크를 위임해야 하는지 여부를 결정합니다. | 최종 답변 또는 한 명의 위임된 근로자 요청입니다. |
| 태스크 위임 | 선택된 근로자 에이전트-태스크 쌍 및 자체 포함 하위 태스크 컨텍스트 | 상위자가 선택한 근로자 에이전트-태스크 쌍에 대해 Oracle 유지 관리 위임 툴을 호출하고 기다립니다. | 근로자 태스크가 자체 대화 스레드에서 시작됩니다. |
| 태스크 처리 중 | 위임된 하위 태스크 및 근로자 태스크 구성 | 작업자는 해당 작업에 구성된 도구를 사용합니다. 사용자 입력이 필요한 경우 팀은 사용자 응답을 기다립니다. | 근로자 결과, 근로자 실패 결과 또는 사용자 입력 요청입니다. |
| 감독자 지속 | 반환된 작업자 결과, 실패 결과 또는 사용자 응답 | 상위자가 반환된 결과를 컨텍스트에 추가하고 추론을 계속합니다. 실패는 성공과 동일한 반환 경로를 따릅니다. 상위자는 재시도할지, 다른 작업자에게 전화할지, 추가 정보를 요청할지, 실패를 설명할지 또는 최종 답변을 반환할지 결정합니다. |
상위자 주도 팀의 런타임 동작
감독자 주도 팀이 사용자 입력을 위해 일시 중지하고, 작업자 실패를 처리하고, 감독자와 작업자 대화 간에 자체 포함된 컨텍스트를 전달하는 방법을 알아봅니다.
사용자 입력 처리
근로자가 사용자 입력을 요청하면 전체 감독자 주도 팀이 사용자 응답을 기다리는 동안 일시 중지됩니다. 사용자는 요청된 정보를 제공하기 위해 동일한 대화를 계속합니다.
사용자가 응답하면 작업자가 작업을 재개하고 완료한 다음 그 결과를 상위자에게 반환합니다. 그런 다음 감독자는 다른 하위 태스크를 위임할지 아니면 최종 답변을 반환할지 결정합니다.
오류 처리
작업자 실패는 성공한 결과와 동일한 반환 경로를 따릅니다. 감독자는 실패 결과를 수신하고 태스크 재시도, 다른 작업자 에이전트-태스크 쌍 호출, 추가 입력 요청 또는 최종 답변 반환과 같은 다음 작업을 결정합니다.
컨텍스트 전달 모델
각 작업자는 자체 대화 스레드에서 작동하며 전체 감독자 컨텍스트를 상속하지 않습니다. 상위자는 근로자가 태스크를 완료하는 데 필요한 모든 정보가 포함된 자체 포함 하위 태스크 요청을 제공해야 합니다.
상위자 에이전트 사용 사례
한 요청에 여러 전문 상담원, 조건부 라우팅 또는 스테이징된 응답이 필요할 수 있는 경우 상위자 주도 Select AI 팀을 적용합니다.
- 계정 세부정보, 지불 이력 및 결합된 최종 응답이 필요한 고객 지원 요청에 응답합니다.
- 데이터 소스에 따라 적합한 작업자에게 데이터 분석 프롬프트를 라우팅한 다음 작업자 결과를 하나의 답변으로 결합합니다.
- 근로자에게 통지를 전송하거나 업무 조치를 완료하기 전에 사용자 확인을 일시 중지하도록 요청합니다.
- 때로는 한 명의 근로자가 필요하고 때로는 여러 명의 근로자가 순서대로 필요한 요청에 대해 한 명의 상위자 팀을 사용합니다.
- 감사, 테스트 및 문제 해결을 위해 작업자 핸드오프 및 반환된 결과를 추적합니다.
이점
감독자 주도 팀을 사용하여 다단계 요청을 라우팅하고, 작업자 에이전트에 집중하고, Select AI 에이전트 프레임워크 활동에 대한 위임 경로를 기록할 수 있습니다.
- 동적 태스크 경로 지정: 상위자가 현재 요청 및 반환된 컨텍스트를 기반으로 다음 근로자를 선택합니다.
- 중점 작업자 설계: 각 작업자는 제한된 작업 영역을 처리하므로 프롬프트 및 도구 매핑을 보다 쉽게 유지 관리할 수 있습니다.
- 컨텍스트 제어: 감독자는 각 작업자 하위 태스크에 필요한 컨텍스트만 전달합니다.
- 추적 가능성: 팀 및 태스크 기록 뷰에 위임 경로 및 반환된 근로자 결과가 표시될 수 있습니다.
- 증분 팀 성장: 모든 기존 근로자를 재설계하지 않고도 새로운 작업에 새 근로자 에이전트를 추가할 수 있습니다.
Select AI 감독자 에이전트 팀을 사용하는 방법
감독자 역할을 하고 감독자로 지정하고, 근로자 에이전트를 생성하고, 감독자를 팀 속성에 추가하고, 팀에 대해 사용자 프롬프트를 실행할 에이전트를 생성합니다.
- 필요한 권한을 부여합니다. 데이터베이스 사용자는
DBMS_CLOUD_AI_AGENT에 대한EXECUTE권한, 필요한 인증서에 대한 액세스 권한 및 외부 제공자 호출에 필요한 네트워크 ACL이 있어야 합니다. 자세한 내용은 선택된 AI 에이전트 사용에 대한 필요 조건을 참조하십시오. - 조회, 갱신, 통지 또는 보고 작업을 위한 PL/SQL 함수와 같이 작업자 에이전트가 사용하는 도구를 생성합니다. 자세한 내용은 DBMS_CLOUD_AI_AGENT 패키지 및 선택한 AI 에이전트 사용의 예를 참조하십시오.
- 근로자 상담원 및 태스크를 생성합니다. 상위자가 각 하위 태스크에 대해 적합한 근로자를 선택할 수 있도록 각 근로자 역할을 특정으로 유지합니다. CREATE_TASK 프로시저 및 CREATE_AGENT 프로시저를 참조하십시오.
supervisor속성이true로 설정된 상위자 에이전트를 생성합니다. CREATE_AGENT 속성을 참조하십시오.supervisor_agent가 상위자 에이전트 이름으로 설정되고agents가 근로자 에이전트-태스크 쌍으로 설정된 팀을 생성합니다. CREATE_TEAM 절차를 참조하십시오.- 세션에 대한 팀을 설정하고 Select AI Agent 프레임워크를 사용하여 자연어 프롬프트를 제출합니다. SET_TEAM 함수를 참조하십시오.
- 내역 뷰를 검토하여 작업자 경로 지정, 반환된 결과, 작업자 실패 및 사용자 입력 대기 상태를 확인합니다. 작업자 태스크가 사용자 입력을 요청하는 경우 사용자가 응답할 때까지 팀이 일시 중지됩니다. 이 시간 동안 전체 감독자 주도 팀이 일시 중지됩니다. 동일한 대화를 계속하여 요청된 입력을 제공합니다. 사용자가 응답하면 작업자가 작업을 재개하고 완료한 다음 그 결과를 상위자에게 반환합니다. 그런 다음 감독자가 다음 작업을 결정합니다. DBMS_CLOUD_AI_AGENT 뷰를 참조하십시오.
워커 agents 배열에서 선택한 상위자를 포함하지 마십시오. 감독자는 팀을 제어하고 배열은 위임에 사용할 수 있는 작업자 에이전트-태스크 쌍만 나열합니다. 작업자 작업은 자체 구성된 도구를 사용할 수 있으며 팀 속성은 도구 이름을 나열하지 않습니다.
주: 감독자 주도 팀은 작업자 하위 태스크를 순차적으로 처리합니다. 감독자는 다른 하위 태스크를 위임하기 전에 각 근로자 결과를 기다립니다. 병렬 워커 실행은 이 릴리스의 일부가 아닙니다.
허용된 감독자 에이전트 팀 구성
Select AI 에이전트 팀에서 감독자, 작업자 에이전트-태스크 쌍, 도구 및 처리를 정의하기 위해 지원되는 구성 및 지침을 검토합니다.
| 구성 | 허용 여부 | 가이드 |
|---|---|---|
supervisor_agent는 supervisor가 true로 설정된 상태로 생성된 에이전트 이름을 지정합니다. |
예 | 감독된 팀에 이 패턴을 사용합니다. |
선택한 상위자도 워커 agents 배열에 나열됩니다. |
아니요 | 상위자로 지정된 에이전트는 워커 배열에 포함될 수 없습니다. 설계 검증은 agents 배열의 감독자 지원 에이전트를 거부합니다. |
| 동일한 근로자 에이전트가 둘 이상의 태스크에 지정되었습니다. | 예 | 동일한 에이전트가 다른 작업 이름에 동일한 에이전트를 할당하여 여러 작업을 수행할 수 있습니다. |
도구는 팀 agents 어레이에 나열되어 있습니다. |
아니요 | CREATE_TASK를 사용하여 작업에 대한 도구를 정의합니다. 팀 속성은 도구 이름이 아닌 근로자 에이전트-태스크 쌍을 나열합니다. |
supervisor_agent는 "supervisor": true가 없는 에이전트의 이름을 지정합니다. |
아니요 | supervisor가 true로 설정된 에이전트를 선택합니다. 명명된 에이전트가 감독자가 아닌 경우 팀 생성 또는 검증이 실패하고 반환된 데이터베이스 오류 세부 정보를 확인합니다. |
| 팀에 대해 둘 이상의 상위자가 정의되었습니다. | 아니요 | 한 팀은 정확히 한 명의 감독자를 지원합니다. "supervisor": true로 단일 에이전트를 정의하고 supervisor_agent에서 참조합니다. |
| 다른 감독자 주도 팀에 대한 감독자 위임자 | 아니요 | 감독자-감독자 위임은 이 릴리스에서 지원되지 않습니다. 상위자는 동일한 팀의 근로자 에이전트에게만 위임할 수 있습니다. |
| 한 팀에서 감독자로 지정된 에이전트를 다른 팀에서 근로자로 사용할 수 있습니다. | 예 | 역할이 서로 다른 여러 팀(감독자 또는 근로자)에서 동일한 감독자 에이전트를 재사용할 수 있습니다. 팀 구성을 통해 역할을 정의합니다. |
참고:
- 프레임워크는 최대 대화 회전 수를 강제로 적용하지 않습니다. 작업 실행의 경우 프레임워크는 실패한 도구 호출에 대한 재시도를 작업당 10회 시도로 제한합니다.
- 프레임워크에서는 모니터링을 위한 새 뷰를 도입하지 않습니다. 기존 Select AI Agent 프레임워크 내역 뷰를 사용하여 팀, 작업 및 도구 실행 내역을 검토할 수 있습니다. 자세한 내용은 DBMS_CLOUD_AI_AGENT 내역 뷰를 참조하십시오.
감독자 주도 팀 문제 해결
Select AI 감독자가 주도하는 일반적인 팀 구성, 위임, 컨텍스트, 알림 및 사용자 입력 문제에 대한 원인 및 수정 사항을 식별합니다.
팀 생성 실패
문제: 팀 생성이 실패합니다.
좋은 원인: supervisor_agent는 "supervisor": true를 사용하여 에이전트의 이름을 지정하지 않습니다.
수정: 감독자 속성을 사용하여 에이전트를 재생성한 다음 팀을 다시 생성합니다.
감독자가 잘못된 근로자를 호출합니다.
문제: 상위자가 잘못된 근로자를 호출합니다.
정확한 원인: 근로자 태스크 설명이 너무 모호하거나 겹칩니다.
수정: 작업 지침을 보다 구체적이고 상호 배타적으로 만듭니다. 감독자는 에이전트 이름, 작업 이름, 설명 및 작업 지침에 따라 작업자 에이전트-작업 쌍을 선택합니다.
근로자 태스크를 정의할 때 다음 지침을 사용합니다.
- 각 워커에 대해 명확한 도메인 경계를 정의합니다.
ACCOUNT_MANAGEMENT_TASK또는PAYMENT_LOOKUP_TASK과 같은 특정 작업 이름을 사용합니다.- 작업자 간에 겹치는 지시를 피하십시오.
- 태스크 지침에 예상 입력 매개변수를 포함합니다.
- 근로자가 사용자 입력을 요청해야 하는 시기를 지정합니다.
- 상위자에게 반환된 결과의 형식을 정의합니다.
근로자의 컨텍스트 부재
문제: 작업자에 컨텍스트가 없습니다.
정확한 원인: 감독자가 위임된 하위 태스크에 충분한 세부정보를 전달하지 않았습니다.
수정: 감독자에게 자체 포함된 하위 태스크를 전송하도록 지시하는 지침을 추가합니다. 위임 동작을 안내하는 명확한 감독자 역할을 정의합니다.
예:
{
"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."
}전자메일이 전송되지 않음
문제: 전자메일이 전송되지 않습니다.
가능한 원인: 인증서, 네트워크 ACL, 발신자 또는 수신자 구성이 누락되었거나 올바르지 않습니다.
수정: SMTP 자격 증명, ACL, 발신자 및 수신자 설정을 확인합니다.
사용자 입력에 대한 프롬프트 대기
문제: 프롬프트가 사용자 입력을 기다립니다.
정확한 원인: 감독자 또는 근로자가 직접 확인을 요청했습니다.
수정: 요청된 정보와 동일한 대화를 계속합니다.
순차 워크플로우와 상위자 패턴 비교
팀이 근로자를 선택하고 태스크를 조정하는 방법에 따라 적절한 AI 에이전트 팀 선택 패턴을 선택합니다.
팀이 구성된 에이전트-태스크 쌍을 알려진 순서로 실행해야 하는 경우 순차적 워크플로우 패턴을 선택합니다. 팀이 요청, 중간 결과, 실패 또는 추가 정보 요청을 기반으로 런타임에 근로자를 선택해야 하는 경우 상위자 패턴을 선택합니다.
| 특성 | 순차 워크플로우 패턴 | 상위자 패턴 |
|---|---|---|
| 계획 실행 | 고정. agents 배열은 워크플로우 순서를 정의합니다. |
변수입니다. 상위자가 런타임 시 다음 워커를 선택합니다. |
| 시작점 | 첫번째로 구성된 에이전트-작업 쌍입니다. | 감독자 에이전트입니다. |
| 태스크 선택 | 팀은 구성된 에이전트-작업 쌍을 순서대로 실행합니다. | 감독자는 필요에 따라 한 명 이상의 근로자를 호출합니다. |
| 컨텍스트 전달 | 태스크 종속관계가 이전 태스크 출력을 다운스트림 태스크로 전달합니다. | 감독자는 각 근로자에게 자체 포함된 하위 태스크를 전송합니다. |
| 최적 대상 | 알려진 단계가 있는 예측 가능한 파이프라인입니다. | 조건부 경로 지정 또는 조정이 필요한 변수 요청입니다. |
| 병렬 실행 | 지원되지 않음. 작업은 한 번에 하나씩 실행됩니다. | 지원되지 않음. 작업자 하위 작업은 한 번에 하나씩 실행됩니다. |
다음 테이블에서는 워크플로우를 결정하는 데 도움이 되는 순차 패턴과 관리책임자 패턴 간의 차이를 제공합니다.
| 순차 패턴 | 상위자 패턴 |
|---|---|
| 고정 워크플로우 | 동적 통합관리 |
| 모든 단계는 순서대로 실행됩니다. | 필요한 단계만 실행 |
| 선형 파이프라인에 적합 | 엔터프라이즈 요청 분기에 적합 |
| 의사결정 논리 감소 | 수동 라우팅 논리 감소, 런타임 판단 증가 |