플레이북을 사용하여 에이전트 빌드

플레이북을 사용하여 셔츠 주문 에이전트를 빌드하고 테스트합니다. 에이전트를 사용하여 매장 위치를 묻고, 영업시간을 확인하거나, 셔츠를 주문할 수 있습니다.

시작하기 전에

아직 설정하지 않았다면 설정 안내를 따르세요.

플레이북 정보

에이전트는 하나 이상의 플레이북으로 구성됩니다. 각 플레이북에는 명확하게 정의되고 제한된 범위가 있습니다. 다음 표에서는 플레이북의 데이터를 설명합니다.

X	항목
이름	플레이북을 식별하는 데 사용되는 이름입니다.
목표	목표는 플레이북이 달성해야 하는 사항에 대한 대략적인 설명입니다.
안내	안내는 플레이북의 목표를 달성하기 위해 취해야 하는 대략적인 단계입니다.
예시	예시는 최종 사용자와 에이전트 간의 샘플 대화입니다. 예시는 실제로 LLM에 대한 퓨샷 프롬프트 예시로 사용됩니다.

에이전트 만들기

에이전트를 만들려면 다음 안내를 따르세요.

1. https://conversational-agents.cloud.google.com/으로 이동합니다.
2. 아직 만들지 않았다면 프로젝트를 선택하거나 만듭니다.
3. 에이전트 만들기 를 클릭합니다.
4. 직접 빌드 를 클릭합니다.
5. 에이전트 이름으로 '셔츠 주문 - 플레이북'을 입력합니다.
6. 위치를 입력합니다.
7. 표준 시간대를 입력합니다.
8. 기본 언어를 입력합니다.
9. 대화 시작 옵션에서 플레이북 을 선택합니다.
10. 만들기 를 클릭합니다.
11. 사용자 인터페이스에서 기본 생성 플레이북 이라는 이름의 기본 플레이북으로 이동합니다.
12. 뒤로 를 클릭하여 플레이북 목록으로 돌아갑니다.

주문 플레이북 만들기

주문 플레이북은 셔츠 주문을 처리합니다.

플레이북을 만들려면 다음 안내를 따르세요.

1. 만들기 를 클릭합니다.
2. 작업 플레이북 옵션을 선택합니다.
3. 플레이북 이름 Order를 입력합니다.

4. 다음 목표를 입력합니다.

   You are a shirt store ordering assistant. Help customers purchase shirts.
   Help the customer choose a size and color.
   The shirts come in small, medium, and large.
   The shirts can be red, green, or blue.
   

5. 다음 요청 사항을 입력합니다.

   - If the customer has not provided a size, ask them to choose a size.
   - If the customer has not provided a color, ask them to choose a color.
   - Once the customer has selected a size and color for the shirt,
     repeat the selection to the customer, and ask them to confirm the selection.
   - Once the customer has confirmed their selection,
     let them know that the shirt is now ordered.
   - Do not provide prices or collect payment.
   - Do not collect the customer's name or address.
   

6. 저장 을 클릭합니다.

7. 뒤로 를 클릭하여 플레이북 목록으로 돌아갑니다.

정보 플레이북 만들기

정보 플레이북은 매장에 대한 질문을 처리합니다.

플레이북을 만들려면 다음 안내를 따르세요.

1. 만들기 를 클릭합니다.
2. 작업 플레이북 옵션을 선택합니다.
3. 플레이북 이름 Information을 입력합니다.

4. 다음 목표를 입력합니다.

   You provide information about a shirt store.
   The store is open between 8 AM and 6 PM every day.
   The store is located at 1007 Mountain Drive, Gotham City, NJ.
   

5. 다음 요청 사항을 입력합니다.

   - If the customer asks for the store location, provide them with the address.
   - If the customer asks for the store hours, provide them with the hours.
   

6. 저장 을 클릭합니다.

7. 뒤로 를 클릭하여 플레이북 목록으로 돌아갑니다.

기본 플레이북 업데이트

에이전트를 처음 만들면 기본 플레이북이 생성됩니다. 이 플레이북은 특정 목표가 있는 적절한 플레이북으로 대화를 유도합니다. 다음 안내에서 기본 플레이북이 다른 플레이북을 참조하는 방법을 확인할 수 있습니다.

플레이북을 업데이트하려면 다음 안내를 따르세요.

1. 별표로 표시된 기본 플레이북을 클릭합니다.

2. 다음 목표를 입력합니다.

   You are an assistant for a shirt store.
   Your name is "Samantha".
   Your job is to direct customers to other playbooks based on the customer's questions.
   

3. 다음 요청 사항을 입력합니다.

   - If the customer hasn't been greeted yet, greet the customer,
     introduce yourself, and ask how you can help.
   - If the customer wants information about the store,
     route them to ${PLAYBOOK: Information}
   - If the customer wants to purchase a shirt,
     route them to ${PLAYBOOK: Order}
   

4. 저장 을 클릭합니다.

5. 아직 예시가 없으므로 플레이북 참조가 강조표시됩니다. 다음 섹션에서 이를 추가합니다.

6. 뒤로 를 클릭하여 플레이북 목록으로 돌아갑니다.

예시 제공

플레이북은 작동하지만 예시를 제공하면 양질의 대답을 보장할 수 있습니다.

플레이북이 열려 있으면 예시 탭에서 예시를 제공할 수 있지만 에이전트와 대화하고 이 대화를 예시로 저장하는 것이 더 쉬울 때가 많습니다.

기본 플레이북 대화는 짧습니다. 이 플레이북은 대화를 다른 플레이북으로 전달해야 합니다.

기본 플레이북과 대화하려면 다음 안내를 따르세요.

1. 화면 오른쪽에 표시될 수 있는 패널을 닫거나 취소합니다.
2. 상단 행 탐색에서 시뮬레이터 버튼을 탭합니다.
3. 리소스의 경우 기본 플레이북을 선택합니다.
4. 기본 모델을 사용하거나 다른 모델을 선택합니다.
5. 사용자 입력 필드에 Hello를 입력한 다음 Enter 키를 누릅니다.
6. 플레이북이 인사말로 대답합니다.

이 대화를 예시로 저장하려면 다음 안내를 따르세요.

1. 호출 목록에서 기본 플레이북을 선택합니다.
2. 예시로 저장 을 클릭합니다.
3. 예시 편집기 패널에서 작업을 추가, 수정, 삭제 또는 재정렬합니다.
4. 예시 이름으로 Greeting을 입력합니다.
5. 필요에 따라 플레이북 대답을 업데이트합니다.
6. 출력 정보가 있는 종료 예시 섹션의 요약 필드에 The user is greeted.를 입력합니다.
7. 저장 을 클릭합니다.

정보 플레이북에 위치 예를 추가합니다.

1. 화면 오른쪽에 있는 패널을 닫거나 취소합니다.
2. 필요한 경우 재설정 restart_alt 버튼을 사용하여 대화를 재설정합니다.
3. 시뮬레이터 시작 리소스 메뉴에서 정보 플레이북을 선택합니다.
4. Where are you located?를 입력하고 Enter 키를 누릅니다.
5. 호출 메뉴에서 정보 플레이북을 선택합니다.
6. 예시로 저장 을 클릭합니다.
7. 예시 이름으로 Location을 입력합니다.
8. 기본 플레이북 예시만 사용자 작업으로 시작할 수 있으므로 Where are you located?가 포함된 작업을 삭제합니다.
9. 이전 대화 요약 섹션을 펼치고 The customer asked "Where are you located?"를 입력 정보가 있는 시작 예시 필드에 입력합니다.
10. 플레이북 실행 요약 섹션을 펼치고 The store is located at 1007 Mountain Drive, Gotham City, NJ.를 출력 정보가 있는 종료 예시 필드에 입력합니다.
11. 저장 을 클릭합니다.

정보 플레이북에 시간 예를 추가합니다.

1. 시뮬레이터에서 정보 플레이북을 선택합니다.
2. What are your hours? 메시지를 입력합니다.
3. 대화를 Hours라는 이름의 예시로 저장합니다.

다음 단계에 따라 주문 플레이북에 선택 예를 추가합니다.

1. 예시 이름을 Selection으로 지정합니다.
2. 주문 플레이북을 선택합니다.
3. 다음 메시지를 보냅니다.
   • I want to buy a shirt
   • Large
   • Green
   • Yes

에이전트 테스트

이제 에이전트를 테스트할 수 있습니다. 시뮬레이터 패널을 열고 에이전트와 대화합니다. 앞서 설명한 대화와 다른 대화를 할 수 있습니다. 예를 들어 이 에이전트에 구매 가능한 셔츠 색상을 물어볼 수 있습니다. 필요한 결과를 얻지 못하는 경우 예시를 구체화하거나 추가하면 대답이 개선됩니다.

API를 사용하여 에이전트와 상호작용

API와의 상호작용에 대한 자세한 내용은 API와의 상호작용을 참조하세요.