기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Connect Customer 데이터 레이크의 AI 에이전트 데이터
<a name="data-lake-ai-agent-data"></a>

다음 표에는 ai 에이전트 데이터가 포함되어 있습니다.

**Topics**
+ [AI 에이전트](#data-lake-ai-agent)
+ [AI 에이전트 지식 기반](#data-lake-ai-agent-knowledge-base)
+ [AI 프롬프트](#data-lake-ai-prompt)
+ [AI 세션](#data-lake-ai-session)
+ [AI 도구](#data-lake-ai-tool)

## AI 에이전트
<a name="data-lake-ai-agent"></a>

**테이블 이름:** `ai_agent`

**설명:** 호출 성공, 지연 시간, 대화 전환, 고객 응대 내의 각 AI 에이전트 상호 작용에 대한 유용성 등급을 포함하여 AI 에이전트 호출 이벤트를 추적합니다.

**기본 키:** `ai_agent_event_id, instance_id`

**파티션 키:** `creation_timestamp` (매일)

**조인 키:**
+ `instance_id` - 모든 테이블에 조인
+ `contact_id` - 고객 응대 레코드, 고객 응대 통계 레코드, Contact Lens, 고객 응대 평가 레코드, 고객 응대 흐름 이벤트에 조인
+ `ai_session_id` - AI 세션, AI 프롬프트, AI 도구, AI 에이전트 지식 기반에 참여
+ `assistant_id` - AI 세션, AI 프롬프트, AI 도구에 참여


|  **열**  |  **유형**  |  **Nullable**  |  **설명**  | 
| --- | --- | --- | --- | 
| instance\_arn | 문자열 |  예  |  Connect 인스턴스의 ARN입니다. | 
| instance-id | 문자열 |  No  | Connect 인스턴스의 ID입니다. | 
| contact\_id | 문자열 |  예  | 연락처 ID입니다. | 
| ai\_agent\_id | 문자열 |  예  | 요청된 AI 에이전트의 ID입니다. | 
| ai\_agent\_버전 | 문자열 |  예  | 요청된 AI 에이전트의 버전입니다. | 
| ai\_agent\_event\_id | 문자열 |  No  | 이벤트의 ID입니다. | 
| aws\_account\_id | 문자열 |  예  | AI Assistant가 사용되는 AWS 계정의 ID입니다. | 
| assistant\_id | 문자열 |  예  | AI 어시스턴트의 ID입니다. | 
| ai\_session\_id | 문자열 |  예  | AI-에이전트 세션의 ID입니다. | 
| creation\_timestamp | bigint |  예  | 이벤트의 타임스탬프는 데이터 레이크에 생성됩니다. | 
| update\_timestamp | bigint |  예  | 이벤트의 타임스탬프는 데이터 레이크에서 업데이트됩니다. | 
| ai\_use\_case | 문자열 |  예  | AI 에이전트의 사용 사례입니다. | 
| ai\_agent\_type | 문자열 |  예  | 요청된 AI 에이전트의 유형입니다. | 
| ai\_agent\_name | 문자열 |  예  | 요청된 AI 에이전트의 이름입니다. | 
| ai\_agent\_arn | 문자열 |  예  | 요청된 AI 에이전트의 Arn입니다. | 
| 간접 호출\_성공 | bool |  예  | AI 에이전트 호출이 성공했는지 여부를 나타내는 부울 필드입니다. | 
| 간접 호출\_지연 시간\_ms | 실수 |  예  | 평가된 고객 응대에서 AI 에이전트의 호출 지연 시간입니다. | 
| conversation\_turns\_in\_response | bigint |  예  | 요청된 AI 에이전트가 응답한 대화 전환 횟수입니다. | 
| response\_helpful | int |  예  | 썸업에서 유용한 것으로 평가된 AI 제안 수입니다. | 
| response\_not\_helpful | int |  예  | 썸다운을 통해 도움이 되지 않는 것으로 평가된 AI 제안 수입니다. | 

## AI 에이전트 지식 기반
<a name="data-lake-ai-agent-knowledge-base"></a>

**테이블 이름:** `ai_agent_knowledge_base`

**설명:** AI 에이전트 상호 작용 중에 검색되고 사용된 지식 콘텐츠를 추적하여 지식 기반 참조 이벤트를 기록합니다.

**기본 키:** `ai_agent_knowledge_base_event_id, instance_id`

**파티션 키:** `creation_timestamp` (매일)

**조인 키:**
+ `instance_id` - 모든 테이블에 조인
+ `contact_id` - 고객 응대 레코드, 고객 응대 통계 레코드, Contact Lens에 조인
+ `ai_session_id` - AI 세션, AI 에이전트, AI 프롬프트, AI 도구에 참여
+ `ai_agent_id` - AI 에이전트에 조인


|  **열**  |  **유형**  |  **Nullable**  |  **설명**  | 
| --- | --- | --- | --- | 
| instance\_arn | 문자열 |  예  |  Connect 인스턴스의 ARN입니다. | 
| aws\_account\_id | 문자열 |  예  | Connect AI Assistant를 소유한 AWS 계정의 ID입니다. | 
| instance-id | 문자열 |  No  | Connect 인스턴스의 ID입니다. | 
| contact\_id | 문자열 |  예  | 특정 연락처의 ID입니다. | 
| 지식\_콘텐츠\_id | 문자열 |  예  | 참조된 지식 콘텐츠의 ID입니다. | 
| ai\_agent\_type | 문자열 |  예  | 요청된 AI 에이전트의 유형입니다. | 
| ai\_agent\_knowledge\_base\_event\_id | 문자열 |  No  | 지식 기반 참조 이벤트의 ID입니다. | 
| assistant\_id | 문자열 |  예  | Amazon Connect AI Assistant의 ID입니다. | 
| ai\_session\_id | 문자열 |  예  | AI 에이전트 세션의 ID입니다. | 
| creation\_timestamp | 문자열 |  예  | 데이터 레이크 이벤트가 생성된 순간입니다. | 
| update\_timestamp | 문자열 |  예  | 데이터 레이크 이벤트가 마지막으로 수정된 순간입니다. | 
| ai\_agent\_id | 문자열 |  예  | 요청된 AI 에이전트의 ID입니다. | 
| ai\_agent\_name | 문자열 |  예  | 요청된 AI 에이전트의 이름입니다. | 
| ai\_agent\_버전 | 문자열 |  예  | 요청된 AI 에이전트의 버전 번호입니다. | 
| ai\_agent\_arn | 문자열 |  예  | 요청된 AI 에이전트의 ARN입니다. | 
| 지식\_베이스\_id | 문자열 |  예  | 참조된 지식 기반의 ID입니다. | 
| 지식\_베이스\_이름 | 문자열 |  예  | 참조된 지식 기반의 이름입니다. | 
| 지식\_콘텐츠\_참조 | 문자열 |  예  | 참조된 지식 콘텐츠의 제목입니다. | 
| data\_lake\_last\_processed\_timestamp | timestamp |  예  | 데이터 레이크가 레코드를 마지막으로 터치한 시간을 보여주는 타임스탬프입니다. 여기에는 변환 및 채우기가 포함될 수 있습니다. 이 필드는 데이터 신선도를 결정하는 데 안정적으로 사용할 수 없습니다. | 

## AI 프롬프트
<a name="data-lake-ai-prompt"></a>

**테이블 이름:** `ai_prompt`

**설명:** AI 세션 내의 각 프롬프트 호출에 대한 모델 사용, 토큰 수, 지연 시간 및 호출 성공을 포함하여 AI 프롬프트 호출 이벤트를 추적합니다.

**기본 키:** `ai_prompt_event_id, instance_id`

**파티션 키:** `creation_timestamp` (매일)

**조인 키:**
+ `instance_id` - 모든 테이블에 조인
+ `contact_id` - 고객 응대 레코드, 고객 응대 통계 레코드, Contact Lens에 조인
+ `ai_session_id` - AI 세션, AI 에이전트, AI 도구에 참여
+ `ai_agent_id` - AI 에이전트에 조인


|  **열**  |  **유형**  |  **Nullable**  |  **설명**  | 
| --- | --- | --- | --- | 
| instance\_arn | 문자열 |  예  | Connect Customer 인스턴스의 ARN입니다. | 
| aws\_account\_id | 문자열 |  예  | 고객 AWS 계정 ID입니다. | 
| instance-id | 문자열 |  No  | Connect Customer 인스턴스의 ID입니다. | 
| contact\_id | 문자열 |  예  | 연락처 ID입니다. | 
| ai\_prompt\_id | 문자열 |  예  | 요청된 AI 프롬프트의 ID입니다. | 
| ai\_prompt\_version | 문자열 |  예  | 요청된 AI 프롬프트의 버전입니다. | 
| ai\_prompt\_event\_id | 문자열 |  No  | 이벤트의 ID입니다. | 
| assistant\_id | 문자열 |  예  | AI 어시스턴트의 식별자입니다. | 
| ai\_session\_id | 문자열 |  예  | AI-Agent 세션의 ID입니다. | 
| creation\_timestamp | bigint |  예  | 이벤트가 데이터 레이크에 생성될 때의 타임스탬프입니다. | 
| update\_timestamp | bigint |  예  | 데이터 레이크에서 이벤트가 업데이트될 때의 타임스탬프입니다. | 
| ai\_agent\_type | 문자열 |  예  | 요청된 AI 에이전트의 유형입니다. | 
| ai\_agent\_name | 문자열 |  예  | 요청된 AI 에이전트의 이름입니다. | 
| ai\_agent\_id | 문자열 |  예  | 요청된 AI 에이전트의 ID입니다. | 
| ai\_agent\_버전 | 문자열 |  예  | 요청된 AI 에이전트의 버전 번호입니다. | 
| ai\_agent\_arn | 문자열 |  예  | 요청된 AI 에이전트의 Arn입니다. | 
| ai\_prompt\_type | 문자열 |  예  | 호출된 AI 프롬프트의 유형입니다. | 
| ai\_prompt\_name | 문자열 |  예  | 호출된 AI 프롬프트의 이름입니다. | 
| ai\_prompt\_arn | 문자열 |  예  | 호출된 AI 프롬프트의 ARN입니다. | 
| model\_id | 문자열 |  예  | AI 프롬프트와 연결된 llm 모델의 이름입니다. | 
| invocation\_success | 부울 |  예  | 프롬프트 호출이 성공했는지 여부를 나타내는 부울 필드입니다. | 
| 간접 호출\_지연 시간\_ms | 실수 |  예  | 평가된 고객 응대에서 AI 프롬프트의 호출 지연 시간입니다. | 
| input\_token | bigint |  예  | 평가된 고객 응대에서 AI 프롬프트의 입력 토큰입니다. | 
| output\_토큰 | bigint |  예  | 평가된 고객 응대에서 AI 프롬프트의 출력 토큰입니다. | 

## AI 세션
<a name="data-lake-ai-session"></a>

**테이블 이름:** `ai_session`

**설명:** 각 AI 세션에 대한 선제적 의도 감지, 간접 호출 수, 핸드오프 상태 및 품질 점수(목표 성공, 충실도, 완전성)를 포함한 세션 수준 AI 지표를 포함합니다.

**기본 키:** `ai_session_id, instance_id`

**파티션 키:** `creation_timestamp` (매일)

**조인 키:**
+ `instance_id` - 모든 테이블에 조인
+ `contact_id` - 고객 응대 레코드, 고객 응대 통계 레코드, Contact Lens에 조인
+ `ai_session_id` - AI 에이전트, AI 프롬프트, AI 도구, AI 에이전트 지식 기반에 조인


|  **열**  |  **유형**  |  **Nullable**  |  **설명**  | 
| --- | --- | --- | --- | 
| instance\_arn | 문자열 |  예  | Connect Customer 인스턴스의 ARN입니다. | 
| instance-id | 문자열 |  No  | Connect Customer 인스턴스의 ID입니다. | 
| contact\_id | 문자열 |  예  | 연락처 ID입니다. | 
| ai\_session\_id | 문자열 |  No  | AI-에이전트 세션의 ID입니다. | 
| aws\_account\_id | 문자열 |  예  | 고객 AWS 계정 ID입니다. | 
| assistant\_id | 문자열 |  예  | Connect AI 에이전트 어시스턴트의 식별자입니다. | 
| creation\_timestamp | bigint |  예  | 이벤트가 데이터 레이크에 생성될 때의 타임스탬프입니다. | 
| update\_timestamp | bigint |  예  | 데이터 레이크에서 이벤트가 업데이트될 때의 타임스탬프입니다. | 
| 선제적\_의도\_감지됨 | bigint |  예  | 에이전트 지원 사용 사례에서 AI 세션 중에 감지된 선제적 의도(고객 쿼리) 수입니다. | 
| 선제적\_의도\_참여 | bigint |  예  | 에이전트 지원 사용 사례에 대해 AI 세션에 참여하는 선제적 의도(고객 쿼리)의 수입니다. | 
| 선제적\_의도\_응답 | bigint |  예  | 에이전트 지원 사용 사례에 대해 AI 세션에서 응답한 선제적 의도(고객 쿼리) 수입니다. | 
| ai\_agent\_invocation\_count | bigint |  예  | AI 세션의 AI 에이전트 호출 수입니다. | 
| ai\_agent\_invocation\_success\_count | bigint |  예  | AI 세션에서 성공한 AI 에이전트 호출 수입니다. | 
| is\_handed\_off | 부울 |  예  | AI 에이전트가 AI 세션 중에 인적 에이전트에게 인계했는지 여부를 나타내는 부울 필드입니다. | 
| 평균\_대화\_턴\_인\_응답 | 실수 |  예  | AI 에이전트 호출에 대한 응답으로 전환되는 평균 대화 횟수입니다. | 
| goal\_success\_rate | double |  예  | 오케스트레이션 AI 에이전트가 고객 문제를 성공적으로 해결했는지 여부를 평가하는 0과 1 사이의 두 배입니다. | 
| 충실도\_점수 | double |  예  | 오케스트레이션 AI 에이전트의 응답이 메시지 및 도구 호출 결과를 포함하여 대화 컨텍스트에 충실한지 여부를 평가하는 0과 1 사이의 두 배입니다. | 
| completeness\_score | double |  예  | 오케스트레이션 AI 에이전트의 응답이 고객 요청의 모든 부분을 완전히 처리하는지 여부를 평가하는 0과 1 사이의 두 배입니다. | 

## AI 도구
<a name="data-lake-ai-tool"></a>

**테이블 이름:** `ai_tool`

**설명:** AI 세션 내의 각 도구 호출에 대한 도구 선택 정확도, 파라미터 정확도, 사용률 정확도 및 호출 지연 시간을 포함하여 AI 도구 호출 이벤트를 추적합니다.

**기본 키:** `ai_tool_event_id, instance_id`

**파티션 키:** `creation_timestamp` (매일)

**조인 키:**
+ `instance_id` - 모든 테이블에 조인
+ `contact_id` - 고객 응대 레코드, 고객 응대 통계 레코드, Contact Lens에 조인
+ `ai_session_id` - AI 세션, AI 에이전트, AI 프롬프트에 참여
+ `ai_agent_id` - AI 에이전트에 조인


|  **열**  |  **유형**  |  **Nullable**  |  **설명**  | 
| --- | --- | --- | --- | 
| instance\_arn | 문자열 |  예  |  Connect 인스턴스의 ARN입니다. | 
| aws\_account\_id | 문자열 |  예  | Connect AI Assistant를 소유한 AWS 계정의 식별자입니다. | 
| instance-id | 문자열 |  No  | Connect 인스턴스의 ID입니다. | 
| contact\_id | 문자열 |  예  | 연락처 ID입니다. | 
| ai\_agent\_id | 문자열 |  예  | 요청된 AI 에이전트의 ID입니다. | 
| ai\_도구\_id | 문자열 |  예  | 요청된 AI 도구의 ID입니다. | 
| ai\_도구\_이벤트\_id | 문자열 |  No  | AI 도구 호출 이벤트의 ID입니다. | 
| assistant\_id | 문자열 |  예  | Connect Customer AI Assistant의 ID입니다. | 
| ai\_session\_id | 문자열 |  예  | AI 에이전트 세션의 ID입니다. | 
| creation\_timestamp | bigint |  예  | 데이터 레이크 이벤트가 생성된 순간입니다. | 
| update\_timestamp | bigint |  예  | 데이터 레이크 이벤트가 마지막으로 수정된 순간입니다. | 
| ai\_agent\_type | 문자열 |  예  | 요청된 AI 에이전트의 유형입니다. | 
| ai\_agent\_name | 문자열 |  예  | 요청된 AI 에이전트의 이름입니다. | 
| ai\_agent\_버전 | 문자열 |  예  | 요청된 AI 에이전트의 버전 번호입니다. | 
| ai\_agent\_arn | 문자열 |  예  | 요청된 AI 에이전트의 ARN입니다. | 
| ai\_도구\_유형 | 문자열 |  예  | 호출된 AI 도구의 유형입니다. | 
| ai\_tool\_name | 문자열 |  예  | 호출된 AI 도구의 이름입니다. | 
| ai\_도구\_arn | 문자열 |  예  | 호출된 AI 도구의 ARN입니다. | 
| 간접 호출\_성공 | 부울 |  예  | 도구 호출이 성공했는지 여부를 나타내는 부울 필드입니다. | 
| 간접 호출\_지연 시간\_ms | 실수 |  예  | AI 도구 호출의 호출 지연 시간입니다. | 
| ai\_tool\_파라미터\_정확도 | double |  예  | AI 에이전트가 올바른 도구 파라미터를 제공했는지 여부를 평가하는 0과 1 사이의 두 배입니다. 여기서 1은 올바른 도구 파라미터를 나타냅니다. | 
| ai\_tool\_selection\_accuracy | double |  예  | AI 에이전트가 올바른 도구를 선택했는지 여부를 평가하는 0과 1 사이의 두 배입니다. 여기서 1은 올바른 도구 선택을 나타냅니다. | 
| ai\_tool\_utilization\_accuracy | double |  예  | AI 에이전트가 도구를 올바르게 사용했는지 여부를 평가하는 0과 1 사이의 두 배입니다. 여기서 1은 완벽한 사용을 나타냅니다. |