AI Assistant 구성

Amplitude에서 AI Assistant와 리소스 센터를 구성하려면 Assistant를 활성화하고, 콘텐츠 소스를 연결하고, 맞춤형 답변을 생성하고, 대체 방법과 커뮤니케이션 스타일을 설정하고, 워크플로우와 도구를 구축하고, 위젯을 스타일링하십시오. Amplitude 관리자와 빌더가 이 구성을 처리합니다.

AI Assistant를 활성화하고 표시되는 위치를 선택하십시오

구성에는 일반적으로 다음이 포함됩니다.

1. 조직에 AI Assistant를 활성화하십시오.

   조직과 프로젝트에 대해 AI Assistant를 활성화했는지 확인하십시오. 여기에는 다음이 포함될 수 있습니다.

   • Amplitude 플랜에 AI Assistant가 포함되어 있어야 합니다.
   • _AI Assistant > 설정 > AI Assistant_에서 AI Assistant 활성화하기.

2. 위젯 실행기를 구성합니다.

   지원/AI Assistant 또는 리소스 센터 구성 영역에서:

   • 미리 구축된 실행기, 사용자 지정 요소 또는 사용자 지정 코드를 선택하여 실행기가 표시되는 위치를 결정합니다. 예를 들어 모든 페이지의 오른쪽 하단에 있거나 특정 화면에서만 가능합니다.
   • 다음을 기준으로 타겟팅 로직을 지정합니다.
     • 사용자 속성(예: 역할 또는 계획)입니다.
     • Amplitude에서 정의된 코호트입니다.
     • URL 또는 경로 규칙.

3. 활성화할 영역을 선택합니다.

   위젯 구성에서:

   • **채팅(AI Assistant)**을 켜거나 끕니다.
   • 리소스 센터를 켜거나 끕니다.
   • 위젯이 열릴 때 사용자가 기본적으로 채팅에 접속할지 아니면 리소스 센터에 접속할지 결정합니다.

콘텐츠 소스 연결

AI Assistant는 사용자가 제공하는 콘텐츠만큼이나 유용합니다. 콘텐츠 및 소스(Content & Sources)와 리소스 센터를 통해 해당 콘텐츠를 관리합니다.

콘텐츠 소스 추가

소스의 예로는 다음과 같습니다.

• 공개 문서 또는 헬프 센터.
• 내부 지식 기반입니다.
• 제품 마케팅 페이지.
• 사용 방법 콘텐츠가 포함된 블로그입니다.

소스를 연결하려면:

1. _AI Assistant > 콘텐츠 > 소스_로 이동합니다.
2. 소스 추가를 클릭하고 유형(예: "도움말 센터", "Web", 또는 "Docs site")을 선택합니다.
3. 기본 URL, 필요한 경우 자격 증명 또는 사이트 맵과 같은 필수 세부 정보를 제공합니다.
4. 동기화 빈도를 구성합니다(자동 또는 주문형).
5. 저장하고 초기 동기화를 실행합니다.

각 소스는 많은 콘텐츠 항목(개별 기사, 페이지 또는 문서)을 수집합니다. Amplitude는 두 가지 모두에 대해 이를 인덱싱합니다:

• 리소스 센터(검색 및 개인화 추천).
• AI Assistant(문서 검색 도구를 통해).

플랜 제한에 따라 연결할 수 있는 소스 수와 각 소스에 대한 문서 수가 제한될 수 있습니다. 제한에 도달한 경우 Amplitude 플랜을 확인하십시오.

리소스 센터 개인화 추천 선별하기

리소스 센터 구성을 사용하여 다양한 컨텍스트에 맞는 권장 사항 집합을 구축할 수 있습니다.

• 페이지 또는 기능별.
• 사용자 세그먼트별.
• 글로벌 기본값입니다.

다음을 포함할 수 있습니다.

• 기사 및 문서.
• 가이드 및 설문조사 콘텐츠(투어, 체크리스트, 설문조사).
• 링크 또는 기타 리소스.

AI Assistant는 다음을 수행할 수 있습니다.

• 응답에서 사용자를 이러한 항목에 연결합니다.
• 워크플로의 일부로 가이드 또는 설문조사를 트리거합니다.

사용자 지정 답변 생성

사용자 지정 답변을 사용하면 문서의 특정 빈틈을 메우거나 중요한 주제에 대해 정확한 표현을 적용할 수 있습니다.

일반적인 활용 사례:

• “귀사의 SLA는 무엇입니까?”
• “Business 플랜과 엔터프라이즈 플랜의 차이점은 무엇입니까?”
• "내 구독을 어떻게 취소합니까?"

답을 생성하려면 다음을 수행하십시오.

1. _AI Assistant > 콘텐츠 > Answers_로 이동합니다.
2. 새로 만들기를 클릭합니다.
3. 다음을 설정합니다.
   • 상태: Draft 또는 Published. AI Assistant가 답변을 사용할 수 있는지 여부를 제어합니다.
   • 제목: 답변의 제목 또는 간단한 설명입니다.
   • 답변: AI Assistant가 사용하기를 원하는 텍스트입니다.
   • 답변은 그대로(verbatim)입니다: AI Assistant에게 텍스트를 해석하는 대신 사용자가 제공한 그대로 사용하도록 지시합니다. 이 기능은 사용자가 환불에 대해 질문할 때와 같이 전달하고 싶은 구체적이거나 중요한 주제가 있을 때 유용합니다.
4. 생성을 클릭합니다.

Amplitude는 응답을 인덱스화하여 AI Assistant가 이를 사용할 수 있도록 합니다. 답변은 리소스 센터에 독립형 문서로 표시되지 않습니다. 이는 AI Assistant의 응답을 지원하기 위해 특별히 존재합니다.

폴백 및 핸드오프 구성

AI Assistant가 질문에 자신 있게 답변할 수 없는 경우, 추측하는 대신 자연스럽게 대체 동작을 수행합니다.

대체 기능을 구성하려면 다음과 같이 하십시오.

1. _AI Assistant > Behavior > Fallbacks_로 이동합니다.
2. 다음 각 시나리오에 대한 대체 기능을 구성하십시오.
   • AI Assistant는 사용자의 질문에 대한 답변을 찾을 수 없습니다.
   • 사용자가 부정적인 피드백을 제공합니다.
   • 사용자가 사람으로 에스컬레이션하기를 요청합니다.

각 폴백에는 다음이 포함됩니다.

• 타겟팅을 통해 사용자의 여러 코호트나 세그먼트에 대해 다양한 대체 옵션을 구성할 수 있습니다.
• 사용자가 정의한 예비 메시지입니다. 예를 들어 다음과 같습니다. "이 질문에 대해 정확하게 답변할 수 있을지 확신할 수 없습니다. 다른 담당자나 도움말과 연결해 드리겠습니다."
• 행동 또는 지원:

커뮤니케이션 스타일 구성

_AI Assistant > 동작 > 커뮤니케이션 스타일_을 사용하여 AI Assistant가 응답을 형식화하는 방법과 채팅 인터페이스에서 사용자에게 표시되는 방법을 제어하십시오.

형식 지침

AI Assistant가 응답을 형식화하는 방법을 지정하려면 다음을 수행하십시오.

1. _AI Assistant > 동작 > 커뮤니케이션 스타일 > 고급_으로 이동합니다.
2. 형식 지침을 입력합니다. 예를 들어 ‘글머리 기호로 답변하십시오’ 또는 ‘답변을 3문장 이내로 유지하십시오’라고 말할 수 있습니다.

AI Assistant는 응답을 생성할 때 이러한 지침을 적용합니다.

채팅 도우미 아이콘

채팅 도우미에 대한 사용자 지정 아이콘을 업로드하려면 다음과 같이 하십시오.

1. _AI Assistant > 동작 > 커뮤니케이션 스타일_로 이동합니다.
2. 채팅 도우미 아이콘으로 사용할 이미지를 업로드하십시오.

워크플로우 및 도구 구성

내부적으로 AI Assistant는 도구(API)와 워크플로우(다단계 절차)를 호출할 수 있어 단순히 질문에 답변하는 것 이상의 작업을 수행할 수 있습니다.

내장된 도구

기본적으로 AI Assistant는 다음과 같은 도구에 액세스할 수 있습니다.

• 문서 검색: 관련 도움말 콘텐츠를 찾습니다.
• 가이드 검색: 관련 가이드 및 설문조사 경험을 찾습니다.
• 가이드 실행기: 사용자의 제품에서 특정 가이드 또는 체크리스트를 시작합니다.
• 대체 도구: AI Assistant는 자신있게 답변할 수 없거나 사용자가 부정적인 피드백을 제공할 때 이러한 도구를 사용합니다.

AI Assistant는 사용자의 요청에 응답하거나 이에 따라 행동하는 데 도움이 될 수 있을 때마다 이러한 도구를 자동으로 고려합니다.

워크플로

워크플로우는 여러 단계와 도구를 재사용 가능한 패턴으로 묶습니다. 예를 들면 다음과 같습니다.

• "사용자가 암호를 재설정하도록 도와주십시오."
• "대시보드가 비어 있는 이유를 해결하십시오."
• "기능 도입 체크리스트를 살펴보십시오."

일반적인 워크플로우는 다음과 같습니다.

1. 채팅에서 내용을 명확히 하기 위한 질문을 하십시오.
2. 내부 API를 호출하여 데이터를 조회합니다.
3. 해당 데이터를 기반으로 여러 분기 대상 구간에서 선택하십시오.
4. 관련 가이드 또는 체크리스트를 실행하십시오.
5. 요약을 통해 AI Assistant 채팅으로 돌아갑니다.

워크플로를 생성하려면 다음과 같이 하십시오.

1. _AI Assistant > 자동화 > 워크플로_로 이동한 후 만들기를 클릭합니다.
2. 워크플로의 트리거를 정의합니다. 예를 들어 사용자가 입력할 때 워크플로를 트리거하는 단어나 구문을 정의합니다. 필요에 따라 사용자가 주제를 변경하거나 더 이상 응답하지 않을 때와 같이 워크플로를 종료할 시기를 AI Assistant에게 알려줄 수 있습니다.
3. 워크플로를 정의합니다. 자연어를 사용하여 AI Assistant에게 어떻게 반응해야 하는지를 알려줍니다. **작업 삽입(Insert Actions)**을 클릭하거나 @ 를 입력하여 워크플로에 작업을 삽입합니다.
4. 워크플로의 타겟팅을 설정합니다.
5. 저장 및 활성화를 클릭하여 워크플로를 활성화합니다.

워크플로우 예제

이 워크플로는 사용자가 자신의 플랜을 확인하고 관련 가이드를 실행함으로써 빈 대시보드 문제를 해결하는 데 도움을 줍니다.

트리거:

Use this workflow whenever the user reports that their dashboard or charts aren't showing data, or asks why their data is missing.

프롬프트:

First, ask the user whether they recently set up a new project or whether data was previously showing.
Then, check the user's account and plan status using @Get user account information.
If the account is on a free plan, let the user know that data may take up to 24 hours to appear and launch @Empty dashboard troubleshooting guide.
If the account is on a paid plan, ask whether they've verified that events are being sent using the Amplitude Debugger, then launch @Instrumentation troubleshooting guide.
Exit the workflow and return to AI Assistant chat with a brief summary of what you recommended.

도구

자체 API로 지원되는 맞춤형 도구로 AI Assistant를 확장하십시오. 정의한 각 도구에 대해 다음을 수행합니다.

1. 이름과 설명(마치 인간 에이전트에게 이를 설명하는 것처럼 평범한 언어로 작성됨).
2. 유형 및 유효성 검사를 포함한 하나 이상의 입력 매개변수입니다.
3. 요청을 수신하는 백엔드 엔드포인트입니다.

그런 다음 AI Assistant는 이러한 도구를 사용하여 다음을 수행합니다.

• 내부 정보(예: 계정 상태, 계획 한도)를 조회합니다.
• 작업을 수행합니다(예: 지원 티켓 생성, 내부 워크플로 시작).
• 상황에 맞는 보다 개인화된 도움말을 제공합니다.

새 도구를 생성하려면 다음과 같이 하십시오.

1. _AI Assistant > Automations > Tools_로 이동한 후 Create를 클릭합니다.
2. 도구에 대한 세부 정보를 입력합니다. 마치 인간 상담원에게 도구를 설명하는 것처럼 평범한 언어로 작성된 이름과 설명을 제공하십시오. 필요한 경우 도구가 실행되기 전에 사용자에게 메시지를 표시하는 확인 대화상자를 활성화할 수 있습니다.
3. API 호출을 정의합니다.
   • HTTP 메소드를 선택합니다. GET, POST, PUT, PATCH 또는 DELETE.
   • API 엔드포인트 추가: 요청을 수신하는 서버의 전체 URL을 입력합니다. 엔드포인트는 유효한 http 또는 https URL이어야 합니다.
   • 요청 매개변수 정의: 매개변수는 AI Assistant가 도구를 호출할 때 입력할 수 있는 입력입니다. 각 매개변수에 대해 유형(예: string 또는 number), 키, 필수 상태 및 설명을 설정합니다. AI Assistant가 매개변수를 언제 어떻게 사용하는지 이해할 수 있도록 설명을 평범한 언어로 작성하십시오.
   • 매개변수를 엔드포인트 또는 본문에 연결: AI Assistant는 매개변수를 URL 또는 요청 본문에 자동으로 추가하지 않습니다. 파라미터를 사용하려면 엔드포인트 URL, 요청 본문 또는 둘 모두에서 {{parameter_name}} 자리 표시자를 사용하여 참조하십시오. AI Assistant는 사용자가 정의했지만 자리 표시자로 참조하지 않은 전체 매개변수를 무시합니다.
   • 요청 본문 정의: 유효한 JSON을 제공하십시오. 본문은 JSON 객체여야 합니다(배열이 아님). 본문에서 자리 {{parameter_name}}표시자를 사용하여 매개변수를 참조하십시오. URL을 통해 모든 매개변수를 전달하는 GET 요청의 경우 본문을 비워 둡니다.
   • 요청 헤더를 정의합니다. 유효한 JSON을 제공합니다. 예를 들어, {"Content-Type": "application/json"} 또는 {"Authorization": "Bearer YOUR_TOKEN"}.
4. 응답을 테스트합니다. 정의한 각 매개변수의 값을 입력하고, 테스트 요청을 엔드포인트로 전송한 후 응답을 검토합니다.

GET 요청 예제

매개변수를 쿼리 스트링 값으로 전달하는 간단한 GET 요청:

• 방법: GET
• 엔드포인트: https://weather.example.com/search?city={{city}}
• 매개 변수: city (문자열, 필수) - "날씨를 조회할 도시입니다."
• 본문: 비워 둡니다.

GET 요청의 경우 매개변수를 엔드포인트 URL에 직접 포함하십시오. 예를 들어, ?city만이 아니라 ?city={{city}}를 사용하십시오.{{city}} 자리 표시자는 AI Assistant에게 값을 삽입할 위치를 알려주는 역할을 합니다.

URL 및 본문 매개 변수를 포함한 POST 요청

URL 경로와 요청 본문 모두에 매개변수 자리 표시자를 혼합할 수 있으며, 그 옆에 정적 값을 포함시킬 수 있습니다.

• 방법: POST
• 엔드포인트: https://api.example.com/update_order/{{order_id}}
• 매개 변수: order_id (문자열, 필수); shipping (문자열, 필수) - "주문의 배송 방법(예: '표준' 또는 '급행')"
• 본문:

{
  "shipping": "{{shipping}}",
  "notify_customer": true
}

• 헤더:

{
  "Content-Type": "application/json",
  "Authorization": "Bearer YOUR_TOKEN"
}

이 예제에서 URL 경로는 {{order_id}}를 사용하며, 본문은 {{shipping}}을 사용하며, "notify_customer": true 이 값은 매개변수에서 가져오지 않는 정적 값입니다.

매개변수에 대해 알아야 할 주요 사항

• 매개변수는 AI Assistant가 도구를 호출할 때 제공할 수 있는 값을 정의합니다. 이들은 쿼리 문자열, 양식 필드 또는 본문 콘텐츠를 자동으로 생성하지 않습니다.
• 플레이스홀더를 {{parameter_name}}사용하여 각 매개변수를 엔드포인트 URL 또는 본문에 직접 연결해야 합니다.
• AI Assistant는 도구가 실행되기 전에 필요한 매개변수를 검증합니다. 필수 매개변수가 누락된 경우 AI Assistant는 요청을 전송하지 않습니다.
• 이 도구는 모든 요청을 JSON으로 전송하므로 사용자 지정 도구는 JSON API와 함께 가장 잘 작동합니다.

사용자 승인 및 안전

사용자 데이터에 영향을 주거나 민감한 작업을 수행하는 도구의 경우 사용자 승인을 요구할 수 있습니다.

• AI Assistant는 자신이 무엇을 하려고 하는지를 쉬운 언어로 설명합니다.
• 사용자가 작업을 확인하거나 거부합니다.

도구를 추가함에 따라:

• 위험을 최소화하려면 읽기 전용 도구부터 시작하십시오.
• 쓰기 가능 도구를 범위가 잘 정해진 고가치 작업에만 사용하도록 제한하십시오.
• X-ray를 사용하여 AI Assistant가 도구를 호출한 시기, 방법, 이유를 감사하십시오.

AI Assistant 및 리소스 센터 스타일 지정

AI Assistant는 가이드 및 설문조사 및 리소스 센터와 동일한 테마 시스템을 사용하므로 앱 내 브랜드를 일관되게 유지할 수 있습니다.

테마 선택 또는 만들기

1. AI Assistant > 테마로 이동합니다.
2. 편집할 기존 테마를 선택하거나 테마 만들기를 클릭합니다.

테마는 일반적으로 다음을 제어합니다.

• 기본 및 보조 색상입니다.
• 글꼴 및 타이포그래피.
• 버튼 스타일.
• 패널 배경과 테두리.

리소스 센터 및 AI Assistant에 테마 적용

리소스 센터 구성에서:

1. 위젯에서 사용할 테마를 선택합니다.
2. 테마의 런처, 패널/헤더, 목록 항목 및 탭(채팅/리소스)(사용 가능한 경우)이 원하는 방식으로 표시되는지 확인합니다.

AI Assistant는 동일한 기본 테마를 공유하지만 다음에 대한 추가 구성을 노출할 수 있습니다.

• 채팅 풍선 색상 및 배경과 같은 채팅 탭 스타일 지정.
• AI Assistant 이름과 아바타.
• 런처에 사용되는 아이콘입니다.