Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Datos de agentes de IA en el lago de datos de Connect Customer
<a name="data-lake-ai-agent-data"></a>

Las siguientes tablas contienen datos sobre los agentes de IA.

**Topics**
+ [Agente de IA](#data-lake-ai-agent)
+ [Base de conocimientos sobre agentes de IA](#data-lake-ai-agent-knowledge-base)
+ [Aviso de IA](#data-lake-ai-prompt)
+ [Sesión de IA](#data-lake-ai-session)
+ [Herramienta de IA](#data-lake-ai-tool)

## Agente de IA
<a name="data-lake-ai-agent"></a>

**Nombre de la tabla:** `ai_agent`

**Descripción:** Realiza un seguimiento de los eventos de invocación de un agente de IA, incluidos el éxito de la invocación, la latencia, los turnos de conversación y las puntuaciones de utilidad de cada interacción de un agente de IA dentro de un contacto.

**Clave principal:** `ai_agent_event_id, instance_id`

**Clave de partición:** `creation_timestamp` (diaria)

**Unir claves:**
+ `instance_id`— Se une a todas las tablas
+ `contact_id`— Se une al registro de contactos, al registro de estadísticas de contactos, a la lente de contacto, al registro de evaluación de contactos o a los eventos de flujo de contactos
+ `ai_session_id`— Se une a AI Session, AI Prompt, AI Tool y AI Agent Knowledge Base
+ `assistant_id`— Se une a AI Session, AI Prompt y AI Tool


|  **Columna**  |  **Tipo**  |  **Acepta valores NULL**  |  **Descripción**  | 
| --- | --- | --- | --- | 
| instance\_arn | cadena |  Sí  | Es el ARN de la instancia de Connect. | 
| instance\_id | cadena |  No  | El ID de la instancia de Connect. | 
| contact\_id | cadena |  Sí  | El ID del contacto. | 
| ai\_agent\_id | cadena |  Sí  | El ID del agente de IA solicitado. | 
| ai\_agent\_version | cadena |  Sí  | La versión del agente de IA solicitado. | 
| ai\_agent\_event\_id | cadena |  No  | ID del evento. | 
| aws\_account\_id | cadena |  Sí  | El ID de la AWS cuenta en la que se utiliza AI Assistant. | 
| assistant\_id | cadena |  Sí  | El ID del asistente de IA. | 
| ai\_session\_id | cadena |  Sí  | El ID de la sesión. AI-Agent  | 
| creation\_timestamp | bigint |  Sí  | La marca de tiempo del evento se crea en el lago de datos. | 
| update\_timestamp | bigint |  Sí  | La marca de tiempo del evento se actualiza en el lago de datos. | 
| ai\_use\_case | cadena |  Sí  | El caso de uso del agente de IA. | 
| ai\_agent\_type | cadena |  Sí  | El tipo de agente de IA solicitado. | 
| ai\_agent\_name | cadena |  Sí  | El nombre del agente de IA solicitado. | 
| ai\_agent\_arn | cadena |  Sí  | El Arn del agente de IA solicitado. | 
| éxito de invocación | bool |  Sí  | Un campo booleano que indica si la invocación del agente de IA se ha realizado correctamente o no. | 
| invocation\_latency\_ms | float |  Sí  | La latencia de invocación del agente de IA en el contacto evaluado. | 
| La conversación se convierte en respuesta | bigint |  Sí  | El número de turnos de conversación respondidos por el agente de IA solicitado. | 
| response\_helpful | int |  Sí  | El recuento de sugerencias de IA calificadas como útiles con el visto bueno hacia arriba. | 
| response\_not\_helpful | int |  Sí  | El recuento de sugerencias de IA calificadas como inútiles con un pulgar hacia abajo. | 

## Base de conocimientos sobre agentes de IA
<a name="data-lake-ai-agent-knowledge-base"></a>

**Nombre de la tabla:** `ai_agent_knowledge_base`

**Descripción:** Registra los eventos de referencia de la base de conocimientos y rastrea qué contenido de conocimiento se recuperó y utilizó durante las interacciones con los agentes de IA.

**Clave principal:** `ai_agent_knowledge_base_event_id, instance_id`

**Clave de partición:** `creation_timestamp` (diaria)

**Unir claves:**
+ `instance_id`— Se une a todas las tablas
+ `contact_id`— Se une al registro de contactos, al registro de estadísticas de contactos o a la lente de contacto
+ `ai_session_id`— Se une a AI Session, AI Agent, AI Prompt y AI Tool
+ `ai_agent_id`— Se une a AI Agent


|  **Columna**  |  **Tipo**  |  **Acepta valores NULL**  |  **Descripción**  | 
| --- | --- | --- | --- | 
| instance\_arn | cadena |  Sí  | Es el ARN de la instancia de Connect. | 
| aws\_account\_id | cadena |  Sí  | El identificador de la cuenta de AWS propietaria de Connect AI Assistant. | 
| instance\_id | cadena |  No  | El ID de la instancia de Connect. | 
| contact\_id | cadena |  Sí  | El ID del contacto específico. | 
| knowledge\_content\_id | cadena |  Sí  | El ID del contenido de conocimiento al que se hace referencia. | 
| ai\_agent\_type | cadena |  Sí  | El tipo de agente de IA solicitado. | 
| ai\_agent\_knowledge\_base\_event\_id | cadena |  No  | El ID del evento de referencia de la base de conocimientos. | 
| assistant\_id | cadena |  Sí  | El ID del asistente de IA de Amazon Connect. | 
| ai\_session\_id | cadena |  Sí  | El ID de la sesión del agente de IA. | 
| creation\_timestamp | cadena |  Sí  | El instante en que se creó el evento del lago de datos. | 
| update\_timestamp | cadena |  Sí  | El momento en que se modificó por última vez el evento del lago de datos. | 
| ai\_agent\_id | cadena |  Sí  | El ID del agente de IA solicitado. | 
| ai\_agent\_name | cadena |  Sí  | El nombre del agente de IA solicitado. | 
| ai\_agent\_version | cadena |  Sí  | El número de versión del agente de IA solicitado. | 
| ai\_agent\_arn | cadena |  Sí  | El ARN del agente de IA solicitado. | 
| knowledge\_base\_id | cadena |  Sí  | El ID de la base de conocimientos a la que se hace referencia. | 
| knowledge\_base\_name | cadena |  Sí  | El nombre de la base de conocimientos a la que se hace referencia. | 
| conocimiento\_contenido\_referencia | cadena |  Sí  | El título del contenido de conocimiento al que se hace referencia. | 
| data\_lake\_last\_processed\_timestamp | timestamp |  Sí  | La marca de tiempo, que muestra la última vez que el lago de datos tocó el registro. Esto puede incluir la transformación y la reposición. Este campo no se puede utilizar de forma fiable para determinar la actualización de los datos. | 

## Aviso de IA
<a name="data-lake-ai-prompt"></a>

**Nombre de la tabla:** `ai_prompt`

**Descripción:** Realiza un seguimiento de los eventos de invocación de AI Prompt, incluidos el uso del modelo, el recuento de tokens, la latencia y el éxito de la invocación de cada llamada rápida de una sesión de IA.

**Clave principal:** `ai_prompt_event_id, instance_id`

**Clave de partición:** `creation_timestamp` (diaria)

**Unir claves:**
+ `instance_id`— Se une a todas las tablas
+ `contact_id`— Se une al registro de contactos, al registro de estadísticas de contactos o a la lente de contacto
+ `ai_session_id`— Se une a AI Session, AI Agent, AI Tool
+ `ai_agent_id`— Se une a AI Agent


|  **Columna**  |  **Tipo**  |  **Acepta valores NULL**  |  **Descripción**  | 
| --- | --- | --- | --- | 
| instance\_arn | cadena |  Sí  | El ARN de la instancia de Connect Customer. | 
| aws\_account\_id | cadena |  Sí  | El ID de la AWS cuenta del cliente. | 
| instance\_id | cadena |  No  | El ID de la instancia de Connect Customer. | 
| contact\_id | cadena |  Sí  | El ID del contacto. | 
| ai\_prompt\_id | cadena |  Sí  | El ID de la solicitud. AI-prompt | 
| ai\_prompt\_version | cadena |  Sí  | La versión de la solicitada. AI-prompt | 
| ai\_prompt\_event\_id | cadena |  No  | El ID de del evento. | 
| assistant\_id | cadena |  Sí  | El identificador del asistente de IA. | 
| ai\_session\_id | cadena |  Sí  | El ID de la sesión. AI-Agent  | 
| creation\_timestamp | bigint |  Sí  | La marca de tiempo en que se crea el evento en el lago de datos. | 
| update\_timestamp | bigint |  Sí  | La marca de tiempo en la que se actualiza el evento en el lago de datos. | 
| ai\_agent\_type | cadena |  Sí  | El tipo de agente de IA solicitado. | 
| ai\_agent\_name | cadena |  Sí  | El nombre del agente de IA solicitado. | 
| ai\_agent\_id | cadena |  Sí  | El identificador del agente de IA solicitado. | 
| ai\_agent\_version | cadena |  Sí  | El número de versión del agente de IA solicitado. | 
| ai\_agent\_arn | cadena |  Sí  | El Arn del agente de IA solicitado. | 
| ai\_prompt\_type | cadena |  Sí  | El tipo del AI Prompt invocado. | 
| ai\_prompt\_name | cadena |  Sí  | El nombre del AI Prompt invocado. | 
| ai\_prompt\_arn | cadena |  Sí  | El ARN del indicador de IA invocado. | 
| model\_id | cadena |  Sí  | El nombre del modelo LLM asociado al AI Prompt. | 
| éxito de invocación | booleano |  Sí  | Un campo booleano que indica si la invocación de la solicitud se ha realizado correctamente o no. | 
| invocation\_latency\_ms | float |  Sí  | La latencia de invocación del indicador de IA en el contacto evaluado. | 
| input\_token | bigint |  Sí  | El token de entrada del AI Prompt del contacto evaluado. | 
| output\_token | bigint |  Sí  | El token de salida del AI Prompt del contacto evaluado. | 

## Sesión de IA
<a name="data-lake-ai-session"></a>

**Nombre de la tabla:** `ai_session`

**Descripción:** Contiene métricas de IA a nivel de sesión, que incluyen la detección proactiva de intenciones, el recuento de invocaciones, el estado de la transferencia y los puntajes de calidad (éxito de los objetivos, fidelidad, integridad) de cada sesión de IA.

**Clave principal:** `ai_session_id, instance_id`

**Clave de partición:** `creation_timestamp` (diaria)

**Unir claves:**
+ `instance_id`— Se une a todas las tablas
+ `contact_id`— Se une al registro de contactos, al registro de estadísticas de contactos o a la lente de contacto
+ `ai_session_id`— Se une a AI Agent, AI Prompt, AI Tool y AI Agent Knowledge Base


|  **Columna**  |  **Tipo**  |  **Acepta valores NULL**  |  **Descripción**  | 
| --- | --- | --- | --- | 
| instance\_arn | cadena |  Sí  | El ARN de la instancia de Connect Customer. | 
| instance\_id | cadena |  No  | El ID de la instancia de Connect Customer. | 
| contact\_id | cadena |  Sí  | El ID del contacto. | 
| ai\_session\_id | cadena |  No  | El ID de la sesión. AI-Agent  | 
| aws\_account\_id | cadena |  Sí  | El ID de la cuenta de AWS del cliente. | 
| assistant\_id | cadena |  Sí  | El identificador del asistente de agentes de Connect AI. | 
| creation\_timestamp | bigint |  Sí  | La marca temporal en la que se crea el evento en el lago de datos. | 
| update\_timestamp | bigint |  Sí  | La marca de tiempo en la que se actualiza el evento en el lago de datos. | 
| proactive\_intents\_detectado | bigint |  Sí  | El número de intentos proactivos (consultas de los clientes) detectados durante la sesión de IA en un caso práctico de Agent Assistance. | 
| proactive\_intents\_engaged | bigint |  Sí  | El número de intentos proactivos (consultas de los clientes) utilizados en la sesión de IA para un caso práctico de Agent Assistance. | 
| proactive\_intents\_answered | bigint |  Sí  | El número de intentos proactivos (consultas de los clientes) respondidas en la sesión de IA para un caso práctico de Agent Assistance. | 
| ai\_agent\_invocation\_count | bigint |  Sí  | El número de invocaciones del agente de IA en la sesión de IA. | 
| ai\_agent\_invocation\_success\_count | bigint |  Sí  | El número de invocaciones correctas de un agente de IA en la sesión de IA. | 
| is\_handed\_off | booleano |  Sí  | Un campo booleano que indica si el agente de IA se lo ha transferido al agente humano durante la sesión de IA. | 
| avg\_conversation\_turns\_in\_response | float |  Sí  | El número medio de turnos de conversación en respuesta a la invocación de un agente de IA. | 
| goal\_success\_rate | double |  Sí  | Un doble entre 0 y 1 que evalúa si el agente de IA de Orchestration ha resuelto correctamente el problema del cliente. | 
| faithfulness\_score | double |  Sí  | Un doble entre 0 y 1 que evalúa si la respuesta del agente de IA de Orchestration es fiel al contexto de la conversación, incluidos los mensajes y los resultados de las llamadas a las herramientas. | 
| puntuación de completeness\_score | double |  Sí  | Un doble entre 0 y 1 que evalúa si la respuesta del agente de Orchestration AI responde plenamente a todos los aspectos de las solicitudes de los clientes. | 

## Herramienta de IA
<a name="data-lake-ai-tool"></a>

**Nombre de la tabla:** `ai_tool`

**Descripción:** Realiza un seguimiento de los eventos de invocación de las herramientas de IA, incluida la precisión de la selección de herramientas, la precisión de los parámetros, la precisión de utilización y la latencia de invocación para cada llamada a una herramienta en una sesión de IA.

**Clave principal:** `ai_tool_event_id, instance_id`

**Clave de partición:** `creation_timestamp` (diaria)

**Unir claves:**
+ `instance_id`— Se une a todas las tablas
+ `contact_id`— Se une al registro de contactos, al registro de estadísticas de contactos o a la lente de contacto
+ `ai_session_id`— Se une a AI Session, AI Agent, AI Prompt
+ `ai_agent_id`— Se une a AI Agent


|  **Columna**  |  **Tipo**  |  **Acepta valores NULL**  |  **Descripción**  | 
| --- | --- | --- | --- | 
| instance\_arn | cadena |  Sí  | Es el ARN de la instancia de Connect. | 
| aws\_account\_id | cadena |  Sí  | El identificador de la AWS cuenta propietaria de Connect AI Assistant. | 
| instance\_id | cadena |  No  | El ID de la instancia de Connect. | 
| contact\_id | cadena |  Sí  | El ID del contacto. | 
| ai\_agent\_id | cadena |  Sí  | El ID del agente de IA solicitado. | 
| ai\_tool\_id | cadena |  Sí  | El ID de la herramienta de IA solicitada. | 
| ai\_tool\_event\_id | cadena |  No  | El ID del evento de invocación de AI Tool. | 
| assistant\_id | cadena |  Sí  | El ID del asistente de IA de Connect Customer. | 
| ai\_session\_id | cadena |  Sí  | El ID de la sesión del agente de IA. | 
| creation\_timestamp | bigint |  Sí  | El instante en que se creó el evento del lago de datos. | 
| update\_timestamp | bigint |  Sí  | El momento en que se modificó por última vez el evento del lago de datos. | 
| ai\_agent\_type | cadena |  Sí  | El tipo de agente de IA solicitado. | 
| ai\_agent\_name | cadena |  Sí  | El nombre del agente de IA solicitado. | 
| ai\_agent\_version | cadena |  Sí  | El número de versión del agente de IA solicitado. | 
| ai\_agent\_arn | cadena |  Sí  | El ARN del agente de IA solicitado. | 
| ai\_tool\_type | cadena |  Sí  | El tipo de herramienta de IA invocada. | 
| ai\_tool\_name | cadena |  Sí  | El nombre de la herramienta de IA invocada. | 
| ai\_tool\_arn | cadena |  Sí  | El ARN de la herramienta de IA invocada. | 
| éxito de invocación | booleano |  Sí  | Un campo booleano que indica si la invocación de la herramienta se ha realizado correctamente o no. | 
| invocation\_latency\_ms | float |  Sí  | La latencia de invocación para las llamadas a herramientas de IA. | 
| ai\_tool\_parameter\_accuracy | double |  Sí  | Un doble entre 0 y 1 que evalúa si el agente de IA proporcionó los parámetros de herramienta correctos, donde 1 indica los parámetros de herramienta correctos. | 
| ai\_tool\_selection\_accuracy | double |  Sí  | Un doble entre 0 y 1 que evalúa si el agente de IA seleccionó la herramienta correcta, donde 1 indica la selección correcta de la herramienta. | 
| ai\_tool\_utilization\_accuracy | double |  Sí  | Un doble entre 0 y 1 que evalúa si el agente de IA utilizó la herramienta correctamente, donde 1 indica un uso perfecto. |