플레이북은 생성형 에이전트의 기본 구성요소입니다. 생성형 에이전트에는 일반적으로 여러 플레이북이 있으며 각 플레이북은 특정 태스크를 처리하도록 정의됩니다. 플레이북 데이터는 LLM에 제공되므로, 질문에 답변하고 태스크를 수행하는 데 필요한 정보가 포함됩니다. 각 플레이북은 정보를 제공하거나, 외부 서비스에 쿼리를 전송하거나, 하위 태스크 처리를 위해 대화 처리를 흐름 또는 다른 플레이북으로 연기할 수 있습니다.
제한사항
다음과 같은 제한사항이 적용됩니다.
- 플레이북을 사용하는 상담사는 기본 시작 흐름의 기본 시작 인텐트 경로에서 호출 컴패니언 SMS 전송을 지원하지 않지만 표준 흐름에서 호출 컴패니언 SMS 옵션을 사용 설정할 수 있습니다.
언어 지원
언어 참조의 플레이북 열을 참고하세요.
플레이북으로 표시된 언어는 gemini-2.0-flash 및 gemini-1.5-flash-002 모델을 사용하여 품질이 테스트되었습니다.
영어가 아닌 언어를 사용할 때는 예시를 타겟 언어로 정의하고 안내는 영어로 남겨야 합니다. 특정 언어 및 사용 사례의 경우 대상 언어로 안내를 추가로 제공하면 약간 더 나은 응답을 얻을 수 있습니다.
모델 지원
다음 위치에서 플레이북에 사용되는 LLM 모델을 선택할 수 있습니다.
상담사 수준에서 LLM 모델을 선택합니다.
- 대화형 에이전트 콘솔 에이전트 설정 -> 생성형 AI -> 플레이북에서 사용 가능한 모든 모델의 드롭다운에서 표시 이름으로 모델을 선택합니다.
- API를 사용하여 상담사 설정을 업데이트하는 경우 GenerativeSettings.llm_model_settings.model 필드에 모델 이름을 지정합니다 (GenerativeSettings 참고).
요청 수준에서 모델 선택 재정의
- 대화형 에이전트 콘솔 시뮬레이터에서 플레이북을 테스트할 때 드롭다운에서 표시 이름으로 모델을 선택합니다.
- API를 통해 상담사를 테스트하는 경우 DetectIntentRequest.query_params.llm_model_settings.model 필드에 모델 이름을 지정합니다 (DetectIntentRequest 참고).
| 모델 이름 | 모델 표시 이름 | 모델 사양 | 출시 단계 | 사용 가능한 지역 |
|---|---|---|---|---|
| gemini-pro | gemini-1.0-pro-001 | Gemini 1.0 Pro | GA | 모든 플레이북 리전 |
| gemini-1.5-flash | gemini-1.5-flash-001 | Gemini 1.5 Flash | GA | 모든 플레이북 리전 |
| gemini-1.5-flash-002 | gemini-1.5-flash-002 | Gemini 1.5 Flash 002 | 공개 미리보기 | 모든 플레이북 리전 |
| gemini-2.0-flash-001 | gemini-2.0-flash-001 | Gemini 2.0 Flash | 공개 미리보기 | Vertex AI에서 지원하는 EU, 미국의 멀티 리전 및 단일 리전 |
모델 지원 중단 날짜는 Vertex AI의 지원 중단 날짜와 일치합니다. 자세한 내용은 모델 버전을 참고하세요.
리전 지원
플레이북은 다음 리전에서 지원됩니다.
globalasia-south1asia-southeast1asia-northeast1australia-southeast1eu(멀티 리전)europe-west1europe-west2europe-west3northamerica-northeast1us(멀티 리전)us-central1us-east1us-west1
플레이북 데이터
플레이북은 다음 데이터로 구성됩니다.
- 플레이북 이름: 개발자와 LLM이 플레이북에서 처리하는 태스크를 이해하는 데 도움이 되는 자연어로 된 간결한 이름입니다.
- 목표: 플레이북이 수행해야 하는 작업에 대한 대략적인 설명
- 지침: 목표를 달성하기 위해 수행해야 하는 프로세스 단계 정의
- 예시: LLM의 사실상 퓨샷 프롬프트 예시인 샘플 대화
- 파라미터: 사용자 입력, 사용자 시스템 정보, 작업 결과 등과 같은 대화 정보를 저장하는 데 사용됩니다.
플레이북 유형
플레이북을 만들 때는 원하는 플레이북 유형(작업 플레이북 또는 루틴 플레이북)을 선택합니다.
태스크 플레이북
작업 플레이북은 원래 유형의 플레이북입니다. 복잡한 작업을 재사용 가능한 더 작은 하위 작업으로 분할하는 데 사용됩니다. 이러한 함수는 각 단계가 입력 및 출력 매개변수를 통해 통신하는 구성 대화 단계를 모델링하는 데 사용됩니다.
다음은 태스크 플레이북 (호출자)이 다른 태스크 플레이북 (호출 대상)을 호출하는 것을 보여줍니다.
- 호출자가 호출 대상을 시작합니다.
- 호출자가 호출 대상에 필요한 입력 매개변수를 제공합니다.
- 호출 대상은 이 정보를 처리하고 지정된 함수를 실행하고 출력 매개변수를 반환합니다.
- 호출자가 호출 대상에서 매개변수를 수신합니다.
모든 루틴 또는 태스크 플레이북은 다른 태스크 플레이북을 호출할 수 있지만 태스크 플레이북은 다른 루틴 플레이북을 호출할 수 없습니다.
루틴 플레이북
루틴 플레이북은 새로운 유형의 플레이북입니다. 각 단계가 완전하고 독립적인 순차적 대화 단계를 모델링하는 데 사용됩니다. 태스크 플레이북을 호출하여 더 큰 태스크를 더 작은 하위 태스크로 분해하고 다른 루틴 플레이북 또는 흐름으로 전환할 수 있습니다.
다음은 루틴 플레이북 (A), 다른 루틴 플레이북 (B)으로 전환, 흐름 (C)으로 전환을 보여줍니다.
- 루틴 플레이북 A는 시작 시 세션 매개변수를 읽고 종료 직전에 세션 매개변수를 쓸 수 있습니다.
- 루틴 플레이북 A가 종료되고 루틴 플레이북 B로 전환됩니다.
- 루틴 플레이북 B는 시작 시 세션 매개변수를 읽고 종료 직전에 세션 매개변수를 쓸 수 있습니다.
- 루틴 플레이북 B가 종료되고 흐름 C로 전환됩니다.
- Flow C는 세션 매개변수를 읽고 쓸 수 있습니다.
루틴 플레이북이 다른 루틴 플레이북 또는 흐름으로 전환되지 않으면 세션이 마지막으로 활성 상태였던 흐름으로 돌아가거나 활성 상태인 흐름이 없는 경우 종료됩니다.
루틴 플레이북에는 다음과 같은 매개변수 관리 동작이 있습니다.
- 루틴 플레이북이 입력되면 입력 매개변수에 동일한 이름의 세션 매개변수와 동일한 값이 할당됩니다.
- 루틴 플레이북이 종료되면 출력 매개변수의 값을 생성하고 동일한 이름의 세션 매개변수에 할당합니다.
기본 플레이북
대화형 에이전트 콘솔을 사용하여 생성형 에이전트를 만들면 기본 생성형 플레이북이 자동으로 생성됩니다.
기본 플레이북은 대화 시작점이므로 다른 플레이북과 몇 가지 중요한 차이점이 있습니다.
- 기본 플레이북은 이전 대화 차례에 대한 요약을 받지 않습니다.
- 기본 플레이북은 입력 매개변수를 정의하거나 수신할 수 없습니다.
플레이북 가져오기 및 내보내기
대화형 에이전트 콘솔을 사용하여 플레이북을 만든 후 이러한 플레이북을 내보내 다른 에이전트에서 사용할 수 있습니다. 플레이북을 내보내려면 다음 단계를 따르세요.
- 플레이북 목록으로 이동합니다.
- 내보내려는 플레이북의 내보내기 버튼을 클릭합니다.
- 내보내기 옵션을 선택합니다.
- 내보내기를 클릭합니다.
이전에 내보낸 플레이북을 가져오려면 다음 단계를 따르세요.
- 플레이북 목록으로 이동합니다.
- 가져오기를 클릭합니다.
- 가져오기 옵션을 선택합니다.
- 가져오기를 클릭합니다.