Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Dati degli agenti AI nel data lake Connect Customer
<a name="data-lake-ai-agent-data"></a>

Le tabelle seguenti contengono i dati degli agenti ai.

**Topics**
+ [Agente AI](#data-lake-ai-agent)
+ [Base di conoscenza di AI Agent](#data-lake-ai-agent-knowledge-base)
+ [Prompt AI](#data-lake-ai-prompt)
+ [Sessione AI](#data-lake-ai-session)
+ [Strumento AI](#data-lake-ai-tool)

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

**Nome della tabella:** `ai_agent`

**Descrizione:** tiene traccia degli eventi di chiamata dell'agente AI, tra cui il successo della chiamata, la latenza, i turni di conversazione e le valutazioni di utilità per ogni interazione dell'agente AI all'interno di un contatto.

**Chiave primaria:** `ai_agent_event_id, instance_id`

**Chiave di partizione:** `creation_timestamp` (giornaliera)

**Chiavi di unione:**
+ `instance_id`— Si unisce a tutti i tavoli
+ `contact_id`— Si unisce a Contact Record, Contact Statistic Record, Contact Lens, Contact Evaluation Record, Contact Flow Events
+ `ai_session_id`— Si unisce a AI Session, AI Prompt, AI Tool, AI Agent Knowledge Base
+ `assistant_id`— Si unisce a AI Session, AI Prompt, AI Tool


|  **Colonna**  |  **Tipo**  |  **Annullabile**  |  **Descrizione**  | 
| --- | --- | --- | --- | 
| instance\_arn | stringa |  Sì  | L’ARN dell’istanza Connect. | 
| instance\_id | stringa |  No  | L'ID dell'istanza Connect. | 
| contact\_id | stringa |  Sì  | ID del contatto. | 
| ai\_agent\_id | stringa |  Sì  | L'ID dell'agente AI richiesto. | 
| ai\_agent\_version | stringa |  Sì  | La versione dell'agente AI richiesto. | 
| ai\_agent\_event\_id | stringa |  No  | ID dell'evento. | 
| aws\_account\_id | stringa |  Sì  | L'ID dell' AWS account in cui viene utilizzato AI Assistant. | 
| assistant\_id | stringa |  Sì  | L'ID dell'Assistente AI. | 
| ai\_session\_id | stringa |  Sì  | L'ID della sessione. AI-Agent  | 
| creation\_timestamp | bigint |  Sì  | Il timestamp dell'evento viene creato nel data lake. | 
| update\_timestamp | bigint |  Sì  | Il timestamp dell'evento viene aggiornato nel data lake. | 
| ai\_use\_case | stringa |  Sì  | Il caso d'uso dell'agente AI. | 
| ai\_agent\_type | stringa |  Sì  | Il tipo di agente AI richiesto. | 
| ai\_agent\_name | stringa |  Sì  | Il nome dell'agente AI richiesto. | 
| ai\_agent\_arn | stringa |  Sì  | L'Arn dell'agente AI richiesto. | 
| invocation\_success | bool |  Sì  | Un campo booleano che indica se l'invocazione dell'agente AI ha avuto successo o meno. | 
| invocation\_latency\_ms | virgola mobile |  Sì  | La latenza di invocazione dell'agente AI nel contatto valutato. | 
| conversation\_turns\_in\_response | bigint |  Sì  | Il numero di turni di conversazione a cui ha risposto l'agente AI richiesto. | 
| response\_helpful | int |  Sì  | Il numero di suggerimenti di intelligenza artificiale giudicati utili con il pollice in su. | 
| response\_not\_helpful | int |  Sì  | Il numero di suggerimenti di intelligenza artificiale giudicati inutili con il pollice rivolto verso il basso. | 

## Base di conoscenza di AI Agent
<a name="data-lake-ai-agent-knowledge-base"></a>

**Nome della tabella:** `ai_agent_knowledge_base`

**Descrizione:** registra gli eventi di riferimento della knowledge base, tracciando quali contenuti della conoscenza sono stati recuperati e utilizzati durante le interazioni con AI Agent.

**Chiave primaria:** `ai_agent_knowledge_base_event_id, instance_id`

**Chiave di partizione:** `creation_timestamp` (giornaliera)

**Chiavi di unione:**
+ `instance_id`— Si unisce a tutti i tavoli
+ `contact_id`— Si unisce a Contact Record, Contact Statistic Record, Contact Lens
+ `ai_session_id`— Si unisce a AI Session, AI Agent, AI Prompt, AI Tool
+ `ai_agent_id`— Si unisce a AI Agent


|  **Colonna**  |  **Tipo**  |  **Annullabile**  |  **Descrizione**  | 
| --- | --- | --- | --- | 
| instance\_arn | stringa |  Sì  | L’ARN dell’istanza Connect. | 
| aws\_account\_id | stringa |  Sì  | L'identificatore dell'account AWS proprietario di Connect AI Assistant. | 
| instance\_id | stringa |  No  | L'ID dell'istanza Connect. | 
| contact\_id | stringa |  Sì  | L'ID del contatto specifico. | 
| knowledge\_content\_id | stringa |  Sì  | L'ID del contenuto della conoscenza di riferimento. | 
| ai\_agent\_type | stringa |  Sì  | Il tipo di agente AI richiesto. | 
| ai\_agent\_knowledge\_base\_event\_id | stringa |  No  | L'ID dell'evento di riferimento della knowledge base. | 
| assistant\_id | stringa |  Sì  | L'ID dell'assistente AI di Amazon Connect. | 
| ai\_session\_id | stringa |  Sì  | L'ID della sessione di AI Agent. | 
| creation\_timestamp | stringa |  Sì  | L'istante in cui è stato creato l'evento data lake. | 
| update\_timestamp | stringa |  Sì  | L'istante in cui l'evento data lake è stato modificato l'ultima volta. | 
| ai\_agent\_id | stringa |  Sì  | L'ID dell'agente AI richiesto. | 
| ai\_agent\_name | stringa |  Sì  | Il nome dell'agente AI richiesto. | 
| ai\_agent\_version | stringa |  Sì  | Il numero di versione dell'agente AI richiesto. | 
| ai\_agent\_arn | stringa |  Sì  | L'ARN dell'agente AI richiesto. | 
| knowledge\_base\_id | stringa |  Sì  | L'ID della knowledge base di riferimento. | 
| nome\_base\_conoscenza | stringa |  Sì  | Il nome della knowledge base di riferimento. | 
| knowledge\_content\_reference | stringa |  Sì  | Il titolo del contenuto della conoscenza a cui si fa riferimento. | 
| data\_lake\_last\_processed\_timestamp | timestamp |  Sì  | Il timestamp, che mostra l'ultima volta che il record è stato toccato dal data lake. Può includere la trasformazione e il riempimento. Questo campo non può essere utilizzato in modo affidabile per determinare la freschezza dei dati. | 

## Prompt AI
<a name="data-lake-ai-prompt"></a>

**Nome della tabella:** `ai_prompt`

**Descrizione:** tiene traccia degli eventi di invocazione di AI Prompt, inclusi l'utilizzo del modello, il conteggio dei token, la latenza e il successo della chiamata per ogni chiamata rapida all'interno di una sessione AI.

**Chiave primaria:** `ai_prompt_event_id, instance_id`

**Chiave di partizione:** `creation_timestamp` (giornaliera)

**Chiavi di unione:**
+ `instance_id`— Si unisce a tutti i tavoli
+ `contact_id`— Si unisce a Contact Record, Contact Statistic Record, Contact Lens
+ `ai_session_id`— Si unisce a AI Session, AI Agent, AI Tool
+ `ai_agent_id`— Si unisce a AI Agent


|  **Colonna**  |  **Tipo**  |  **Annullabile**  |  **Descrizione**  | 
| --- | --- | --- | --- | 
| instance\_arn | stringa |  Sì  | L'ARN dell'istanza Connect Customer. | 
| aws\_account\_id | stringa |  Sì  | L'ID dell' AWS account del cliente. | 
| instance\_id | stringa |  No  | L'ID dell'istanza Connect Customer. | 
| contact\_id | stringa |  Sì  | ID del contatto. | 
| ai\_prompt\_id | stringa |  Sì  | L'ID della richiesta. AI-prompt | 
| ai\_prompt\_version | stringa |  Sì  | La versione della richiesta. AI-prompt | 
| ai\_prompt\_event\_id | stringa |  No  | ID dell'evento. | 
| assistant\_id | stringa |  Sì  | L'identificatore dell'Assistente AI. | 
| ai\_session\_id | stringa |  Sì  | L'ID della sessione. AI-Agent  | 
| creation\_timestamp | bigint |  Sì  | Il timestamp in cui l'evento viene creato nel data lake. | 
| update\_timestamp | bigint |  Sì  | Il timestamp in cui l'evento viene aggiornato nel data lake. | 
| ai\_agent\_type | stringa |  Sì  | Il tipo di agente AI richiesto. | 
| ai\_agent\_name | stringa |  Sì  | Il nome dell'agente AI richiesto. | 
| ai\_agent\_id | stringa |  Sì  | L'ID dell'agente AI richiesto. | 
| ai\_agent\_version | stringa |  Sì  | Il numero di versione dell'agente AI richiesto. | 
| ai\_agent\_arn | stringa |  Sì  | L'Arn dell'agente AI richiesto. | 
| ai\_prompt\_type | stringa |  Sì  | Il tipo di prompt AI richiamato. | 
| ai\_prompt\_name | stringa |  Sì  | Il nome del prompt AI richiamato. | 
| ai\_prompt\_arn | stringa |  Sì  | L'arn del prompt AI richiamato. | 
| model\_id | stringa |  Sì  | Il nome del modello llm associato al prompt AI. | 
| invocation\_success | booleano |  Sì  | Un campo booleano che indica se l'invocazione del prompt ha avuto successo o meno. | 
| invocation\_latency\_ms | virgola mobile |  Sì  | La latenza di invocazione del prompt AI nel contatto valutato. | 
| input\_token | bigint |  Sì  | Il token di input del prompt AI nel contatto valutato. | 
| output\_token | bigint |  Sì  | Il token di output del prompt AI nel contatto valutato. | 

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

**Nome della tabella:** `ai_session`

**Descrizione:** contiene metriche di intelligenza artificiale a livello di sessione, tra cui il rilevamento proattivo degli intenti, il conteggio delle chiamate, lo stato di consegna e i punteggi di qualità (successo degli obiettivi, fedeltà, completezza) per ogni sessione di intelligenza artificiale.

**Chiave principale:** `ai_session_id, instance_id`

**Chiave di partizione:** `creation_timestamp` (giornaliera)

**Chiavi di unione:**
+ `instance_id`— Si unisce a tutti i tavoli
+ `contact_id`— Si unisce a Contact Record, Contact Statistic Record, Contact Lens
+ `ai_session_id`— Si unisce a AI Agent, AI Prompt, AI Tool, AI Agent Knowledge Base


|  **Colonna**  |  **Tipo**  |  **Annullabile**  |  **Descrizione**  | 
| --- | --- | --- | --- | 
| instance\_arn | stringa |  Sì  | L'ARN dell'istanza Connect Customer. | 
| instance\_id | stringa |  No  | L'ID dell'istanza Connect Customer. | 
| contact\_id | stringa |  Sì  | ID del contatto. | 
| ai\_session\_id | stringa |  No  | L'ID della sessione. AI-Agent  | 
| aws\_account\_id | stringa |  Sì  | L'ID dell'account AWS del cliente. | 
| assistant\_id | stringa |  Sì  | L'identificatore dell'assistente Connect AI agent. | 
| creation\_timestamp | bigint |  Sì  | Il timestamp in cui l'evento viene creato nel data lake. | 
| update\_timestamp | bigint |  Sì  | Il timestamp in cui l'evento viene aggiornato nel data lake. | 
| proactive\_intents\_detected | bigint |  Sì  | Il numero di intenti proattivi (richieste dei clienti) rilevati durante la sessione di intelligenza artificiale per un caso d'uso di Agent Assistance. | 
| proactive\_intents\_engaged | bigint |  Sì  | Il numero di intenti proattivi (richieste dei clienti) coinvolti nella sessione di intelligenza artificiale per un caso d'uso di Agent Assistance. | 
| proactive\_intents\_answer | bigint |  Sì  | Il numero di intenti proattivi (domande dei clienti) a cui è stata data risposta nella sessione di intelligenza artificiale per un caso d'uso di Agent Assistance. | 
| ai\_agent\_invocation\_count | bigint |  Sì  | Il numero di invocazioni di AI Agent nella sessione AI. | 
| ai\_agent\_invocation\_success\_count | bigint |  Sì  | Il numero di invocazioni riuscite di AI Agent nella sessione AI. | 
| is\_handed\_off | booleano |  Sì  | Un campo booleano che indica se l'agente AI è passato all'agente umano durante la sessione di intelligenza artificiale. | 
| avg\_conversation\_turns\_in\_response | virgola mobile |  Sì  | Il numero medio di conversioni in risposta alla chiamata di AI Agent. | 
| goal\_success\_rate | virgola mobile a doppia precisione |  Sì  | Un doppio compreso tra 0 e 1 che valuta se l'agente AI di Orchestration ha risolto con successo il problema del cliente. | 
| faithfulness\_score | virgola mobile a doppia precisione |  Sì  | Un doppio compreso tra 0 e 1 che valuta se la risposta dell'agente AI di Orchestration è fedele al contesto della conversazione, inclusi i messaggi e i risultati delle chiamate allo strumento. | 
| punteggio\_completezza | virgola mobile a doppia precisione |  Sì  | Un valore doppio compreso tra 0 e 1 che valuta se la risposta dell'agente AI di Orchestration risponde completamente a tutte le parti delle richieste dei clienti. | 

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

**Nome della tabella:** `ai_tool`

**Descrizione:** tiene traccia degli eventi di invocazione dello strumento AI, tra cui l'accuratezza della selezione degli strumenti, l'accuratezza dei parametri, l'accuratezza dell'utilizzo e la latenza di invocazione per ogni chiamata allo strumento all'interno di una sessione di intelligenza artificiale.

**Chiave primaria:** `ai_tool_event_id, instance_id`

**Chiave di partizione:** `creation_timestamp` (giornaliera)

**Chiavi di unione:**
+ `instance_id`— Si unisce a tutti i tavoli
+ `contact_id`— Si unisce a Contact Record, Contact Statistic Record, Contact Lens
+ `ai_session_id`— Si unisce a AI Session, AI Agent, AI Prompt
+ `ai_agent_id`— Si unisce a AI Agent


|  **Colonna**  |  **Tipo**  |  **Annullabile**  |  **Descrizione**  | 
| --- | --- | --- | --- | 
| instance\_arn | stringa |  Sì  | L’ARN dell’istanza Connect. | 
| aws\_account\_id | stringa |  Sì  | L'identificatore dell' AWS account proprietario di Connect AI Assistant. | 
| instance\_id | stringa |  No  | L'ID dell'istanza Connect. | 
| contact\_id | stringa |  Sì  | ID del contatto. | 
| ai\_agent\_id | stringa |  Sì  | L'ID dell'agente AI richiesto. | 
| ai\_tool\_id | stringa |  Sì  | L'ID dello strumento di intelligenza artificiale richiesto. | 
| ai\_tool\_event\_id | stringa |  No  | L'ID dell'evento di invocazione di AI Tool. | 
| assistant\_id | stringa |  Sì  | L'ID dell'assistente AI di Connect Customer. | 
| ai\_session\_id | stringa |  Sì  | L'ID della sessione di AI Agent. | 
| creation\_timestamp | bigint |  Sì  | L'istante in cui è stato creato l'evento data lake. | 
| update\_timestamp | bigint |  Sì  | L'istante in cui l'evento data lake è stato modificato l'ultima volta. | 
| ai\_agent\_type | stringa |  Sì  | Il tipo di agente AI richiesto. | 
| ai\_agent\_name | stringa |  Sì  | Il nome dell'agente AI richiesto. | 
| ai\_agent\_version | stringa |  Sì  | Il numero di versione dell'agente AI richiesto. | 
| ai\_agent\_arn | stringa |  Sì  | L'ARN dell'agente AI richiesto. | 
| ai\_tool\_type | stringa |  Sì  | Il tipo di strumento AI richiamato. | 
| ai\_tool\_name | stringa |  Sì  | Il nome dello strumento di intelligenza artificiale richiamato. | 
| ai\_tool\_arn | stringa |  Sì  | L'ARN dello strumento di intelligenza artificiale richiamato. | 
| invocation\_success | booleano |  Sì  | Un campo booleano che indica se l'invocazione dello strumento ha avuto successo o meno. | 
| invocation\_latency\_ms | virgola mobile |  Sì  | La latenza di invocazione per la chiamata agli strumenti di intelligenza artificiale. | 
| ai\_tool\_parameter\_accuracy | virgola mobile a doppia precisione |  Sì  | Un valore doppio compreso tra 0 e 1 che valuta se l'agente AI ha fornito i parametri dell'utensile corretti, dove 1 indica i parametri dell'utensile corretti. | 
| ai\_tool\_selection\_accuracy | virgola mobile a doppia precisione |  Sì  | Un doppio compreso tra 0 e 1 che valuta se l'agente AI ha selezionato lo strumento corretto, dove 1 indica la corretta selezione dell'utensile. | 
| ai\_tool\_utilization\_accuracy | virgola mobile a doppia precisione |  Sì  | Un doppio compreso tra 0 e 1 che valuta se l'agente AI ha utilizzato correttamente lo strumento, dove 1 indica un utilizzo perfetto. |