에이전트 앱 만들기

이 가이드에서는 간단한 셔츠 주문 에이전트 앱을 빌드하고 테스트하는 방법을 보여줍니다. 이 에이전트 앱과 상호작용할 때 매장 위치를 묻거나 매장 영업 시간을 확인하거나 셔츠를 주문할 수 있습니다.

시작하기 전에

이 가이드를 읽기 전에 다음을 수행해야 합니다.

  1. 아직 수행하지 않은 경우 Dialogflow 설치 안내를 따르세요.

에이전트 앱 정보

에이전트 앱은 하나 이상의 에이전트로 구성됩니다. 각 에이전트는 명확하게 정의되고 제한된 범위가 있습니다. 에이전트에는 다음과 같은 데이터가 있습니다.

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

애플리케이션 만들기

애플리케이션을 만들려면 다음 안내를 따르세요.

  1. 에이전트 빌더 콘솔로 이동합니다.

    에이전트 빌더 콘솔

  2. 콘솔 드롭다운에서 프로젝트를 선택합니다.

  3. API를 아직 활성화하지 않았으면 서비스 약관을 읽고 동의한 후 계속 및 API 활성화를 클릭합니다.

  4. 새 앱 만들기 또는 새 앱을 클릭합니다.

  5. 에이전트를 선택합니다.

  6. 앱 이름으로 'Shirt Ordering Assistant'를 입력합니다.

  7. 리전을 선택합니다.

  8. 만들기를 클릭합니다.

  9. 사용자 인터페이스에서 기본 에이전트라는 기본 에이전트로 이동합니다.

  10. 뒤로 버튼을 클릭하여 에이전트 목록을 확인합니다.

주문 에이전트 만들기

주문 에이전트가 셔츠 주문을 처리합니다. 이 에이전트를 만들려면 다음 안내를 따르세요.

  1. 만들기를 클릭합니다.
  2. 이름으로 Order을 입력합니다.
  3. 다음 목표를 입력합니다.

    You are a shirt store ordering agent. 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.
    
  4. 다음 요청 사항을 입력합니다.

    - 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.
    
  5. 저장을 클릭합니다.

    주문 에이전트 앱 스크린샷

  6. 뒤로 버튼을 클릭하여 에이전트 목록으로 돌아갑니다.

정보 에이전트 만들기

정보 에이전트는 매장에 대한 질문을 처리합니다. 이 에이전트를 만들려면 다음 안내를 따르세요.

  1. 만들기를 클릭합니다.
  2. 이름으로 Information을 입력합니다.
  3. 다음 목표를 입력합니다.

    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.
    
  4. 다음 요청 사항을 입력합니다.

    - 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.
    
  5. 저장을 클릭합니다.

  6. 뒤로 버튼을 클릭하여 에이전트 목록으로 돌아갑니다.

기본 에이전트 업데이트

애플리케이션을 처음 만들 때 기본 에이전트가 생성됩니다. 이 에이전트는 특정 목표를 가진 적절한 에이전트로 대화를 유도해야 합니다. 아래 안내에서 기본 에이전트가 다른 에이전트를 참조하는 방법을 확인할 수 있습니다. 이 에이전트를 업데이트하려면 다음 안내를 따르세요.

  1. 기본 에이전트를 클릭합니다. 이 에이전트는 별표로 강조 표시되어 있습니다.
  2. 다음 목표를 입력합니다.

    You are an agent for a shirt store.
    Your name is "Samantha".
    Your job is to direct customers to other agents based on the customer's questions.
    
  3. 다음 요청 사항을 입력합니다.

    - If the customer hasn't been greeted yet, greet the customer,
      introduce yourself, and ask the user how you can help.
    - If the customer wants information about the store,
      route them to ${AGENT: Information}
    - If the customer wants to purchase a shirt,
      route them to ${AGENT: Order}
    
  4. 저장을 클릭합니다.

  5. 뒤로 버튼을 클릭하여 에이전트 목록으로 돌아갑니다.

예시 제공

이 시점에서 에이전트가 작동합니다. 하지만 대답의 품질을 보장하려면 예시를 제공해야 합니다.

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

기본 에이전트와의 대화 예시는 간단합니다. 이 에이전트는 사용자를 다른 에이전트에게 안내하기만 하면 됩니다. 기본 에이전트와 대화하려면 다음 안내를 따르세요.

  1. 화면 오른쪽에 있을 수 있는 패널을 닫거나 취소합니다. 에이전트 대답 방식 확인을 위한 메시지 전송이 포함된 시뮬레이터 패널을 확인합니다.
  2. 기본 에이전트를 선택합니다.
  3. gemini-pro 모델을 선택합니다.
  4. 사용자 입력이라는 텍스트 상자에 Hello를 입력한 다음 Enter 키를 누릅니다.
  5. 에이전트가 인사말로 응답합니다.

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

  1. 인터페이스 오른쪽 상단에 있는 예시 저장 버튼을 클릭합니다.
  2. 예시 편집기 패널이 열립니다. 이 편집기를 사용하여 작업을 추가, 수정, 삭제, 재정렬할 수 있습니다.
  3. 예시 이름을 Greeting으로 지정합니다.
  4. 필요에 따라 에이전트 응답을 업데이트합니다.
  5. 저장을 클릭합니다.

    인사말 예시의 스크린샷

정보 에이전트에 위치 예시를 추가합니다.

  1. 화면 오른쪽에 있을 수 있는 패널을 닫거나 취소합니다. 필요한 경우 재설정 restart_alt 버튼을 사용하여 대화를 재설정합니다.
  2. 정보 에이전트를 선택합니다.
  3. gemini-pro 모델을 선택합니다.
  4. 메시지로 Where are you located?를 입력합니다.
  5. 에이전트가 위치를 응답합니다.
  6. 이 대화를 Location이라는 예시로 저장합니다. 기본 에이전트 예시만 사용자 작업으로 시작할 수 있으므로 'Where are you located'가 포함된 작업을 삭제해야 합니다.

정보 에이전트에 시간 예시를 추가합니다.

  1. 위 단계와 비슷하지만 What are your hours? 메시지를 입력하고 예시 이름을 Hours로 지정합니다.

주문 에이전트에 선택 예시를 추가합니다.

  1. 위 단계와 비슷하지만 예시 이름을 Selection으로 지정하고 주문 에이전트를 선택한 후 다음 메시지를 보냅니다.

    • I want to buy a shirt
    • Large
    • Green
    • Yes

    예시 항목 스크린샷

에이전트 앱 테스트

이제 에이전트 앱을 테스트할 수 있습니다. 시뮬레이터 패널을 열고 에이전트와 대화합니다. 위와 동일한 대화를 할 필요는 없습니다. 예를 들어 이 에이전트 앱에 구매 가능한 셔츠 색상을 물어볼 수 있습니다. 원하는 동작을 얻지 못한 경우 예를 미세 조정하고 새 예를 만들면 대답이 개선됩니다.

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

API와의 상호작용을 참조하세요.