메가 에이전트

하위 에이전트라는 여러 Dialogflow 에이전트를 메가 에이전트라는 단일 에이전트로 결합할 수 있습니다. 메가 에이전트에 대해 인텐트 감지 요청을 수행하면 모든 하위 에이전트가 고려되며 하위 에이전트의 최상의 응답이 반환됩니다.

메가 에이전트를 사용하는 데는 다양한 이유가 있습니다.

  • 더 나은 거버넌스: 여러 팀이 에이전트를 빌드하는 경우 각 팀은 하나의 하위 에이전트를 담당하게 되므로 팀 간 변경 충돌이 간소화됩니다.
  • 추가 인텐트: 인텐트가 많은 에이전트의 경우 인텐트 수 제한에 도달할 수 있습니다. 이 경우 여러 개의 하위 에이전트와 하나의 메가 에이전트를 만들 수 있습니다.

제한사항

메가 에이전트에는 다음과 같은 제한사항이 적용됩니다.

  • 모든 에이전트와 마찬가지로 GCP 프로젝트당 하나의 에이전트만 만들 수 있으므로 각 하위 에이전트 및 메가 에이전트는 자체 GCP 프로젝트와 연결됩니다.
  • 메가 에이전트가 가질 수 있는 하위 에이전트의 수는 최대 10개입니다.
  • 메가 에이전트는 스몰 토크를 할 수 없습니다.
  • 하위 에이전트 인텐트 우선순위는 메가 에이전트로 요청을 보낼 때 인텐트 일치에 영향을 주지 않습니다.
  • 파트너 기본 제공 전화 통합(AudioCodes, Avaya, Genesys, SignalWire, Voximplant)이 지원되지 않습니다.

하위 에이전트 만들기

다른 에이전트와 마찬가지로 하위 에이전트를 만듭니다. 필요에 따라 인텐트, 컨텍스트, 항목 등을 추가하여 에이전트를 빌드합니다.

메가 에이전트를 만들기 또는 업데이트

Dialogflow 콘솔을 사용하여 메가 에이전트를 만들고 하위 에이전트에 연결할 수 있습니다.

Dialogflow는 대부분의 에이전트 설정을 메가 에이전트에서 가져오고 데이터를 메가 에이전트에 로깅합니다. 예:

웹 UI

1. 메가 에이전트 만들기

  1. Dialogflow 콘솔로 이동합니다.
  2. 왼쪽 사이드바 메뉴에서 에이전트 만들기를 클릭합니다. 이미 다른 에이전트가 있는 경우 에이전트 이름을 클릭하고 맨 아래로 스크롤하여 새 에이전트 만들기를 클릭합니다.
  3. 에이전트 이름, 기본 언어, 기본 시간대, GCP 프로젝트를 입력합니다.
  4. 에이전트 유형메가 에이전트로 설정합니다.
  5. 만들기 버튼을 클릭합니다.

2. 하위 에이전트 추가 및 관리

  1. 왼쪽 사이드바 메뉴에서 하위 에이전트를 클릭합니다.
  2. 메가 에이전트에 추가할 하위 에이전트를 선택합니다.
  3. 하위 에이전트 환경의 기본값은 초안이지만 필요에 따라 업데이트할 수 있습니다.
  4. 하위 에이전트와 연결된 기술 자료를 사용하려면 필드를 제외됨에서 포함됨으로 변경합니다.
  5. 저장을 클릭합니다.

역할 설정

메가 에이전트를 사용하는 방법에 따라 하위 에이전트 프로젝트에서 특정 역할을 가진 구성원을 설정해야 합니다.그러면 메가 에이전트가 하위 에이전트를 호출할 수 있는 권한을 갖습니다. 역할을 설정하는 방법은 다음과 같습니다.

  1. 평소처럼 메가 에이전트 및 하위 에이전트 GCP 프로젝트를 만들고 각 프로젝트에 대해 'Dialogflow API'를 사용 설정했는지 확인합니다.
  2. API를 사용하여 메가 에이전트와 상호작용하려면 메가 에이전트 API 호출에 사용하는 서비스 계정은 모든 하위 에이전트 프로젝트의 구성원이어야 하며 적용된 역할에는 인텐트 감지 권한이 있어야 합니다. 프로젝트 소유자, 프로젝트 편집자, Dialogflow API 관리자, Dialogflow API 클라이언트의 역할이 이 액세스를 제공합니다. 이 서비스 계정의 이메일 주소를 가져오려면 다음 안내를 따르세요.
    1. IAM 서비스 계정 페이지로 이동합니다.
    2. 메가 에이전트의 프로젝트를 선택합니다.
    3. API 호출을 위해 이미 만든 서비스 계정을 선택하거나 원하는 역할이 있는 새 서비스 계정을 추가합니다. 설정 안내에 따라 새 서비스 계정을 만들고 비공개 키를 다운로드합니다.
    4. 선택한 서비스 계정 이메일 주소를 기록해 둡니다. 아래에 이 주소가 필요합니다.
  3. Dialogflow 시뮬레이터에서 메가 에이전트와 상호작용할 계획이면 자동 생성된 dialogflow-alphanum@project-id.iam.gserviceaccount.com 서비스 계정은 모든 하위 에이전트 프로젝트의 구성원이어야 하며 적용된 역할에는 인텐트 감지 권한이 있어야 합니다. 프로젝트 소유자, 프로젝트 편집자, Dialogflow API 관리자, Dialogflow API 클라이언트의 역할이 이 액세스를 제공합니다. 이 서비스 계정의 이메일 주소를 가져오려면 다음 안내를 따르세요.
    1. Dialogflow 콘솔로 이동합니다.
    2. 메가 에이전트를 선택합니다.
    3. 에이전트 이름 옆에 있는 설정 버튼을 클릭합니다.
    4. 일반 탭의 서비스 계정을 참조하세요. 서비스 계정 이메일 주소를 기록해 둡니다. 아래에 이 주소가 필요합니다.
  4. 메가 에이전트에 통합을 사용하려는 경우 메가 에이전트 프로젝트에 대해 자동 생성된 service-project-num@gcp-sa-dialogflow.iam.gserviceaccount.com서비스 계정이 모든 하위 에이전트 프로젝트의 구성원이어야 하며 적용된 역할에는 인텐트 호출을 감지할 수 있는 권한이 있어야 합니다. 프로젝트 소유자, 프로젝트 편집자, Dialogflow API 관리자, Dialogflow API 클라이언트의 역할이 이러한 액세스를 제공합니다. 이 서비스 계정의 이메일 주소를 가져오려면 다음 안내를 따르세요.

    1. IAM 서비스 계정 페이지로 이동합니다.
    2. 메가 에이전트의 프로젝트를 선택합니다.
    3. 다음 패턴과 일치하는 서비스 계정을 찾습니다:
      service-project-num@gcp-sa-dialogflow.iam.gserviceaccount.com.
    4. 선택한 서비스 계정 이메일 주소를 기록해 둡니다. 아래에 이 주소가 필요합니다.
  5. 각 하위 에이전트 프로젝트에 대해 위에서 수집한 메가 에이전트 서비스 계정을 하위 에이전트 프로젝트의 구성원으로 추가합니다.

    1. IAM 기본 페이지로 이동합니다.
    2. 하위 에이전트의 프로젝트를 선택합니다.
    3. 메가 에이전트의 서비스 계정 이메일 주소를 프로젝트의 구성원으로 추가하고 원하는 역할을 부여합니다.

인텐트 감지

인텐트를 감지하려면 다른 인텐트 감지 요청과 같이 요청을 호출하고 메가 에이전트의 프로젝트 ID를 사용합니다. Dialogflow에서는 모든 하위 에이전트가 고려되며 하위 에이전트의 최상의 응답이 반환됩니다.

예를 들어 다음과 같은 하위 에이전트를 살펴보겠습니다.

하위 에이전트 인텐트 학습 문구
주문 도서 'I want to buy a book(책을 구입하고 싶습니다.)'
'Add a book to my cart(장바구니에 책 추가)'
모자 'I want to purchase a hat(모자를 구매하고 싶어요.)'
'I want a hat(모자를 사고 싶어요.)'
계정 잔액 'What is my balance?(잔액이 얼마인가요?)'
'How much is left in my account?(계정에 얼마가 남아 있나요?)'
주소 'I want to change my address(주소를 변경하고 싶습니다.)'
'I have a new address(주소가 변경되었습니다.)'

최종 사용자가 'I want to purchase a hat please(모자를 구매하고 싶습니다.)'라고 말하면 메가 에이전트에 전송된 인텐트 감지 요청에 Orders 에이전트의 Hats 인텐트와 일치되는 결과가 나옵니다.

인텐트 감지 요청에 하나 이상의 하위 에이전트를 지정하려면 QueryParameterssubAgents 필드를 설정합니다. 예를 들어 이 요청에 대한 REST JSON은 다음과 비슷합니다.

{
  "queryInput": {
    "text": {
      "text": "reserve a meeting room for six people",
      "languageCode": "en-US"
    }
  },
  "queryParams": {
    "subAgents": [
       {"project": "projects/sub-agent-1-project-id"},
       {"project": "projects/sub-agent-2-project-id"}
    ]
  }
}

이벤트 호출

웹훅 서비스에서 이벤트를 호출하려면 트리거할 인텐트의 하위 에이전트를 지정할 수 있습니다. 다음의 이벤트 이름 형식을 사용합니다.

sub-agent-project-id.event-name

예를 들어 하위 에이전트 프로젝트 ID가 123이고 원하는 인텐트의 이벤트 이름이 alarm인 경우 123.alarm을 이벤트 이름으로 사용합니다.

이벤트에 하위 에이전트를 지정하지 않으면 이전에 일치된 인텐트가 포함된 하위 에이전트로 이벤트가 다시 전송됩니다.

출력 컨텍스트 설정

웹훅 서비스의 출력 컨텍스트를 설정하려면 컨텍스트가 속하는 하위 에이전트를 지정할 수 있습니다. 다음 형식을 사용합니다.

projects/mega_agent_project_id/agent/sessions/session_id/contexts/sub_agent_project_id.context_name

예를 들어 세션이 projects/mega_agent_project_id/agent/sessions/session_id이고 프로젝트 ID가 sub_project_1인 하위 에이전트의 컨텍스트 이름을 music_context로 설정하려면 다음 이름을 출력 컨텍스트로 설정할 수 있습니다.

projects/mega_agent_project_id/agent/sessions/session_id/contexts/sub_project_1.music_context

컨텍스트 이름에 하위 에이전트 프리픽스를 지정하지 않으면 시스템이 이를 메가 에이전트의 컨텍스트로 간주합니다.