플레이북 매개변수

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

참고: 에이전트 빌더 콘솔에서는 여전히 플레이북을 에이전트라고 합니다. 이는 곧 콘솔에서 플레이북으로 업데이트될 예정입니다.

중요: 대화형 에이전트 (Dialogflow CX) 플레이북과 대화형 에이전트 (Dialogflow CX) 흐름과 플레이북 간의 매개변수 전달은 여기에 설명되어 있지만 현재는 액세스가 제한되어 있습니다. Dialogflow 에이전트 간 매개변수 전달은 공개적으로 사용 가능합니다.

플레이북은 명시적으로 정의된 매개변수를 사용하여 컨텍스트 정보를 허용하고 내보낼 수 있습니다. 매개변수는 사용자 선택, 작업 결과 등의 대화 정보를 저장하는 데 사용됩니다. 플레이북과 흐름 간에 이러한 매개변수 값을 전달할 수 있습니다.

매개변수 선언

사용자는 입력 매개변수와 출력 매개변수를 정의합니다.

Agent Builder 콘솔을 사용할 때는 에이전트 편집기 페이지에서 매개변수를 정의할 수 있습니다.

Dialogflow CX 콘솔을 사용할 때는 플레이북을 만든 후 매개변수 탭을 사용하여 플레이북별로 매개변수를 정의합니다.

매개변수에는 이름, 설명, 다음 유형 중 하나가 포함됩니다.

• 문자열
• 숫자
• 불리언
• 도구별 매개변수 유형

매개변수가 목록인지도 지정할 수 있습니다.

입력 매개변수

입력 매개변수를 통해 플레이북에서 흐름 및 기타 플레이북에서 전달된 값을 사용할 수 있습니다. 예를 들어 플레이북에서 사용자가 원하는 이름을 매개변수로 수신하여 사용자에게 개인적인 감사 인사를 전하는 데 이를 사용할 수 있습니다. 또는 플레이북에서 주문 식별자를 매개변수로 수신하여 도구로 주문 세부정보를 가져오는 데 사용할 수 있습니다.

입력 매개변수는 플레이북별로 정의되며 플레이북은 기본적으로 다른 Dialogflow CX 콘솔 매개변수 유형을 볼 수 없습니다. 흐름이 플레이북으로 전환되면 대상 플레이북에 동일한 이름의 입력 매개변수가 있는 경우 페이지 및 세션 매개변수가 플레이북에 전파됩니다. 전환 중에 흐름에서 플레이북으로 정보를 전달하려면 전환 전에 존재하는 세션 또는 페이지 매개변수와 동일한 이름으로 플레이북 입력 매개변수를 정의합니다.

참고: 기본 플레이북은 입력 매개변수를 허용하지 않습니다. 기본 플레이북은 사용자 대화의 진입점 역할을 하므로 입력 매개변수를 수신할 수 없습니다.

입력 매개변수 값이 작업에 미치는 영향을 제어하는 예시를 만듭니다. 예를 들어 에이전트가 사용자를 참조하는 방식에 입력 매개변수가 영향을 미쳐야 하는 경우 매개변수 값을 정의하는 예시를 만들고 예시 내의 발화 작업에 동일한 값을 사용합니다. 자세한 내용은 매개변수 전달을 참조하세요.

출력 매개변수

출력 매개변수를 사용하면 플레이북이 다른 흐름 또는 플레이북에서 사용할 수 있도록 정보를 내보낼 수 있습니다. 예를 들어 플레이북에서 사용자로부터 주문 번호를 수집하여 출력 매개변수를 통해 내보낼 수 있습니다. 또는 플레이북에서 도구를 사용하여 출력 매개변수를 통해 항공편을 예약하고 확인 번호를 내보낼 수 있습니다.

플레이북이 각 출력 매개변수의 값을 결정하는 방법을 제어하는 예시를 만듭니다. 예를 들어 확인 번호를 나타내는 출력 매개변수가 도구 사용의 출력에서 값을 도출해야 하는 경우 도구 사용의 출력이 플레이북 출력 매개변수의 값과 일치하는 예시를 만듭니다.

매개변수 전달

흐름과 달리 플레이북은 특정 구문을 사용한 매개변수 삽입을 지원하지 않습니다. 대신 플레이북은 지침 및 퓨삿 프롬프트 예시를 사용하여 매개변수 값을 사용할 방법과 매개변수 값을 지정할 때 값을 결정하는 방법을 결정합니다.

다음 플레이북을 사용하는 이벤트 티켓 판매용으로 설계된 에이전트가 있다고 생각해 보세요.

1. Ticket ordering이라는 플레이북은 Ticket sales API라는 도구를 사용하여 주문합니다.
   1. 이 플레이북은 유형이 number이고 이름이 event_id인 입력 매개변수를 수락합니다.
   2. Ticket sales API 도구에는 event_id가 포함된 요청이 필요합니다.
2. Event selection이라는 플레이북에서는 사용자의 이벤트 선택을 도운 후 티켓을 구매할 수 있도록 매개변수 event_id를 사용하여 Ticket ordering으로 라우팅합니다.

이 예시에서 event_id가 Event selection에서 Ticket ordering으로, 그리고 Ticket ordering에서 Ticket sales API로 안정적으로 전달되기 위해서는 여러 예시가 필요합니다.

Ticket ordering 플레이북에는 다음과 같은 여러 예시가 포함되어야 합니다.

• 입력 매개변수 event_id가 예시마다 다른 몇 가지 현실적인 값으로 지정됩니다.
• 입력 매개변수에 지정된 것과 동일한 현실적인 event_id 값을 포함하는 요청 본문에 도구 사용 작업을 포함합니다.

Event selection 플레이북에는 다음과 같은 여러 예시가 포함되어야 합니다.

• 사용자가 예시마다 다른 몇 가지 현실적인 event_id가 있는 이벤트를 선택하는 사용자 발화를 포함합니다.
• event_id 매개변수를 사용자 선택으로 결정된 것과 동일한 현실적인 event_id로 설정하는 Ticket ordering의 플레이북 호출을 포함합니다.

예시 추가 외에 지침, 목표 또는 도구 세부정보에 매개변수 사용 방법을 설명하는 구체적인 지침을 추가해 보세요. 예를 들어 플레이북 Ticket ordering에는 다음 지침이 포함되어 있습니다.

- Use parameter event_id to send a buy_tickets request with ${TOOL: Ticket sales API}

설명된 예시와 지침을 통해 Event selection 플레이북은 사용자의 선택에 따라 event_id를 올바르게 결정하고 이를 event_id라는 입력 매개변수로 Ticket ordering playbook에 전달합니다. 그런 다음 Ticket ordering은 요청 본문에서 동일한 event_id를 Ticket sales API에 전달합니다. 플레이북은 매개변수 사용 방법을 추론하는 데 도움이 되는 고유한 매개변수 값을 가진 예시를 사용합니다.