As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Dados do agente de IA no data lake Connect Customer
<a name="data-lake-ai-agent-data"></a>

As tabelas a seguir contêm dados do agente de inteligência artificial.

**Topics**
+ [Agente de IA](#data-lake-ai-agent)
+ [Base de conhecimento do AI Agent](#data-lake-ai-agent-knowledge-base)
+ [Prompt de IA](#data-lake-ai-prompt)
+ [Sessão de IA](#data-lake-ai-session)
+ [Ferramenta de IA](#data-lake-ai-tool)

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

**Nome da tabela:** `ai_agent`

**Descrição:** Acompanha os eventos de invocação do Agente de IA, incluindo sucesso da invocação, latência, turnos de conversação e classificações de utilidade para cada interação do agente de IA em um contato.

**Chave primária:** `ai_agent_event_id, instance_id`

**Chave de partição:** `creation_timestamp` (diariamente)

**Teclas de junção:**
+ `instance_id`— Junta-se a todas as mesas
+ `contact_id`— Junta-se ao registro de contato, registro estatístico de contato, lente de contato, registro de avaliação de contato, eventos de fluxo de contato
+ `ai_session_id`— Ingressa na AI Session, AI Prompt, AI Tool e AI Agent Knowledge Base
+ `assistant_id`— Ingressa na AI Session, AI Prompt, AI Tool


|  **Coluna**  |  **Tipo**  |  **Anulável**  |  **Descrição**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  Sim  | O ARN da instância do Connect. | 
| instance\_id | string |  Não  | O ID da instância Connect. | 
| contact\_id | string |  Sim  | O ID do contato. | 
| ai\_agent\_id | string |  Sim  | O ID do agente de IA solicitado. | 
| versão ai\_agent\_ | string |  Sim  | A versão do agente de IA solicitado. | 
| ai\_agent\_event\_id | string |  Não  | ID do evento. | 
| aws\_account\_id | string |  Sim  | O ID da AWS conta em que o AI Assistant é usado. | 
| assistant\_id | string |  Sim  | O ID do AI Assistant. | 
| id da sessão ai | string |  Sim  | O ID da AI-Agent sessão. | 
| creation\_timestamp | bigint |  Sim  | O timestamp do evento é criado no data lake. | 
| update\_timestamp | bigint |  Sim  | A data e hora do evento é atualizada no data lake. | 
| caso de uso da IA | string |  Sim  | O caso de uso do agente de IA. | 
| tipo de agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| ai\_agent\_name | string |  Sim  | O nome do agente de IA solicitado. | 
| ai\_agent\_arn | string |  Sim  | O Arn do agente de IA solicitado. | 
| sucesso\_invocação | bool |  Sim  | Um campo booleano que indica se a invocação do agente de IA foi bem-sucedida ou não. | 
| invocation\_latency\_ms | flutuação |  Sim  | A latência de invocação do agente de IA no contato avaliado. | 
| a conversa se transforma em resposta | bigint |  Sim  | O número de turnos de conversa respondidos pelo agente de IA solicitado. | 
| resposta\_útil | int |  Sim  | A contagem de sugestões de IA avaliadas como úteis com o polegar para cima. | 
| a resposta não é útil | int |  Sim  | A contagem de sugestões de IA classificadas como inúteis com o polegar para baixo. | 

## Base de conhecimento do AI Agent
<a name="data-lake-ai-agent-knowledge-base"></a>

**Nome da tabela:** `ai_agent_knowledge_base`

**Descrição:** registra eventos de referência da base de conhecimento, rastreando qual conteúdo de conhecimento foi recuperado e usado durante as interações do AI Agent.

**Chave primária:** `ai_agent_knowledge_base_event_id, instance_id`

**Chave de partição:** `creation_timestamp` (diariamente)

**Teclas de junção:**
+ `instance_id`— Junta-se a todas as mesas
+ `contact_id`— Junta-se ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Ingressa na AI Session, AI Agent, AI Prompt, AI Tool
+ `ai_agent_id`— Junta-se ao AI Agent


|  **Coluna**  |  **Tipo**  |  **Anulável**  |  **Descrição**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  Sim  | O ARN da instância do Connect. | 
| aws\_account\_id | string |  Sim  | O identificador da conta da AWS que possui o Connect AI Assistant. | 
| instance\_id | string |  Não  | O ID da instância Connect. | 
| contact\_id | string |  Sim  | O ID do contato específico. | 
| conhecimento\_content\_id | string |  Sim  | O ID do conteúdo de conhecimento referenciado. | 
| tipo de agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| ai\_agent\_knowledge\_base\_event\_id | string |  Não  | O ID do evento de referência da base de conhecimento. | 
| assistant\_id | string |  Sim  | O ID do Amazon Connect AI Assistant. | 
| id da sessão ai | string |  Sim  | O ID da sessão do AI Agent. | 
| creation\_timestamp | string |  Sim  | No instante em que o evento do data lake foi criado. | 
| update\_timestamp | string |  Sim  | O instante em que o evento do data lake foi modificado pela última vez. | 
| ai\_agent\_id | string |  Sim  | O ID do agente de IA solicitado. | 
| ai\_agent\_name | string |  Sim  | O nome do agente de IA solicitado. | 
| versão ai\_agent\_ | string |  Sim  | O número da versão do Agente de IA solicitado. | 
| ai\_agent\_arn | string |  Sim  | O ARN do agente de IA solicitado. | 
| conhecimento\_base\_id | string |  Sim  | O ID da base de conhecimento referenciada. | 
| nome\_de\_base\_conhecimento | string |  Sim  | O nome da base de conhecimento referenciada. | 
| conhecimento\_conteu\_referencia | string |  Sim  | O título do conteúdo de conhecimento referenciado. | 
| data\_lake\_last\_processed\_timestamp | timestamp |  Sim  | O timestamp, que mostra a última vez em que o registro foi tocado pelo data lake. Pode incluir transformação e preenchimento. Esse campo não pode ser usado de forma confiável para determinar a atualização dos dados. | 

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

**Nome da tabela:** `ai_prompt`

**Descrição:** rastreia eventos de invocação do AI Prompt, incluindo uso do modelo, contagem de tokens, latência e sucesso da invocação para cada chamada rápida em uma sessão de IA.

**Chave primária:** `ai_prompt_event_id, instance_id`

**Chave de partição:** `creation_timestamp` (diariamente)

**Teclas de junção:**
+ `instance_id`— Junta-se a todas as mesas
+ `contact_id`— Junta-se ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Ingressa na sessão de IA, no agente de IA e na ferramenta de IA
+ `ai_agent_id`— Junta-se ao AI Agent


|  **Coluna**  |  **Tipo**  |  **Anulável**  |  **Descrição**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  Sim  | O ARN da instância Connect Customer. | 
| aws\_account\_id | string |  Sim  | O ID da AWS conta do cliente. | 
| instance\_id | string |  Não  | O ID da instância Connect Customer. | 
| contact\_id | string |  Sim  | O ID do contato. | 
| ai\_prompt\_id | string |  Sim  | O ID do solicitado AI-prompt. | 
| versão ai\_prompt\_ | string |  Sim  | A versão do solicitado AI-prompt. | 
| ai\_prompt\_event\_id | string |  Não  | O ID do evento. | 
| assistant\_id | string |  Sim  | O identificador do AI Assistant. | 
| id da sessão ai | string |  Sim  | O ID da AI-Agent sessão. | 
| creation\_timestamp | bigint |  Sim  | O registro de data e hora em que o evento é criado no data lake. | 
| update\_timestamp | bigint |  Sim  | O registro de data e hora em que o evento é atualizado no data lake. | 
| tipo de agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| ai\_agent\_name | string |  Sim  | O nome do agente de IA solicitado. | 
| ai\_agent\_id | string |  Sim  | O ID do agente de IA solicitado. | 
| versão ai\_agent\_ | string |  Sim  | O número da versão do Agente de IA solicitado. | 
| ai\_agent\_arn | string |  Sim  | O Arn do agente de IA solicitado. | 
| ai\_prompt\_type | string |  Sim  | O tipo do AI Prompt invocado. | 
| ai\_prompt\_name | string |  Sim  | O nome do AI Prompt invocado. | 
| ai\_prompt\_arn | string |  Sim  | O arn do API Prompt invocado. | 
| model\_id | string |  Sim  | O nome do modelo llm associado ao AI Prompt. | 
| sucesso\_invocação | booleano |  Sim  | Um campo booleano que indica se a invocação do prompt foi bem-sucedida ou não. | 
| invocation\_latency\_ms | flutuação |  Sim  | A latência de invocação do AI Prompt no contato avaliado. | 
| token de entrada | bigint |  Sim  | O token de entrada do AI Prompt no contato avaliado. | 
| token de saída | bigint |  Sim  | O token de saída do AI Prompt no contato avaliado. | 

## Sessão de IA
<a name="data-lake-ai-session"></a>

**Nome da tabela:** `ai_session`

**Descrição:** contém métricas de IA em nível de sessão, incluindo detecção proativa de intenção, contagem de invocações, status de transferência e pontuações de qualidade (sucesso da meta, fidelidade, integridade) para cada sessão de IA.

**Chave primária:** `ai_session_id, instance_id`

**Chave de partição:** `creation_timestamp` (diariamente)

**Teclas de junção:**
+ `instance_id`— Junta-se a todas as mesas
+ `contact_id`— Junta-se ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Une-se ao AI Agent, AI Prompt, AI Tool e AI Agent Knowledge Base


|  **Coluna**  |  **Tipo**  |  **Anulável**  |  **Descrição**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  Sim  | O ARN da instância Connect Customer. | 
| instance\_id | string |  Não  | O ID da instância Connect Customer. | 
| contact\_id | string |  Sim  | O ID do contato. | 
| id da sessão ai | string |  Não  | O ID da AI-Agent sessão. | 
| aws\_account\_id | string |  Sim  | O ID da conta AWS do cliente. | 
| assistant\_id | string |  Sim  | O identificador do assistente de agentes do Connect AI. | 
| creation\_timestamp | bigint |  Sim  | O registro de data e hora em que o evento é criado no data lake. | 
| update\_timestamp | bigint |  Sim  | O registro de data e hora em que o evento é atualizado no data lake. | 
| intenções\_proativas detectadas | bigint |  Sim  | O número de intenções proativas (consultas de clientes) detectadas durante a sessão de IA para um caso de uso de Assistência ao Agente. | 
| intenções proativas\_engajadas | bigint |  Sim  | O número de intenções proativas (consultas de clientes) envolvidas na sessão de IA para um caso de uso de assistência ao agente. | 
| intenções\_proativas respondidas | bigint |  Sim  | O número de intenções proativas (consultas de clientes) respondidas na sessão de IA para um caso de uso de assistência ao agente. | 
| ai\_agent\_invocation\_count | bigint |  Sim  | O número de invocações do Agente de IA na sessão de IA. | 
| ai\_agent\_invocation\_success\_count | bigint |  Sim  | O número de invocações bem-sucedidas do Agente de IA na sessão de IA. | 
| é\_entregue\_debitado | booleano |  Sim  | Um campo booleano que indica se o agente de IA foi transferido para o agente humano durante a sessão de IA. | 
| avg\_conversation\_turns\_in\_response | flutuação |  Sim  | O número médio de turnos de conversa em resposta à invocação do Agente de IA. | 
| taxa de sucesso da meta | double |  Sim  | Um duplo entre 0 e 1 que avalia se o agente do Orchestration AI resolveu com sucesso o problema do cliente. | 
| pontuação de fidelidade | double |  Sim  | Um duplo entre 0 e 1 que avalia se a resposta do agente do Orchestration AI é fiel ao contexto conversacional, incluindo mensagens e resultados de chamadas de ferramentas. | 
| pontuação\_completude | double |  Sim  | Um duplo entre 0 e 1 que avalia se a resposta do agente do Orchestration AI atende totalmente a todas as partes das solicitações do cliente. | 

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

**Nome da tabela:** `ai_tool`

**Descrição:** Rastreia eventos de invocação de ferramentas de IA, incluindo precisão de seleção de ferramentas, precisão de parâmetros, precisão de utilização e latência de invocação para cada chamada de ferramenta em uma sessão de IA.

**Chave primária:** `ai_tool_event_id, instance_id`

**Chave de partição:** `creation_timestamp` (diariamente)

**Teclas de junção:**
+ `instance_id`— Junta-se a todas as mesas
+ `contact_id`— Junta-se ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Ingressa na AI Session, AI Agent, AI Prompt
+ `ai_agent_id`— Junta-se ao AI Agent


|  **Coluna**  |  **Tipo**  |  **Anulável**  |  **Descrição**  | 
| --- | --- | --- | --- | 
| instance\_arn | string |  Sim  | O ARN da instância do Connect. | 
| aws\_account\_id | string |  Sim  | O identificador da AWS conta proprietária do Connect AI Assistant. | 
| instance\_id | string |  Não  | O ID da instância Connect. | 
| contact\_id | string |  Sim  | O ID do contato. | 
| ai\_agent\_id | string |  Sim  | O ID do agente de IA solicitado. | 
| id da ferramenta ai | string |  Sim  | O ID da ferramenta de IA solicitada. | 
| ai\_tool\_event\_id | string |  Não  | O ID do evento de invocação do AI Tool. | 
| assistant\_id | string |  Sim  | O ID do Connect Customer AI Assistant. | 
| id da sessão ai | string |  Sim  | O ID da sessão do AI Agent. | 
| creation\_timestamp | bigint |  Sim  | No instante em que o evento do data lake foi criado. | 
| update\_timestamp | bigint |  Sim  | O instante em que o evento do data lake foi modificado pela última vez. | 
| tipo de agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| ai\_agent\_name | string |  Sim  | O nome do agente de IA solicitado. | 
| versão ai\_agent\_ | string |  Sim  | O número da versão do Agente de IA solicitado. | 
| ai\_agent\_arn | string |  Sim  | O ARN do agente de IA solicitado. | 
| tipo de ferramenta ai | string |  Sim  | O tipo da ferramenta de IA invocada. | 
| nome\_do\_ferramenta ai | string |  Sim  | O nome da ferramenta de IA invocada. | 
| ai\_tool\_arn | string |  Sim  | O ARN da ferramenta de IA invocada. | 
| sucesso\_invocação | booleano |  Sim  | Um campo booleano que indica se a invocação da ferramenta foi bem-sucedida ou não. | 
| invocation\_latency\_ms | flutuação |  Sim  | A latência de invocação para chamadas de ferramentas de IA. | 
| ai\_tool\_parameter\_accuracy | double |  Sim  | Um duplo entre 0 e 1 que avalia se o agente de IA forneceu os parâmetros corretos da ferramenta, onde 1 indica os parâmetros corretos da ferramenta. | 
| ai\_tool\_selection\_accuracy | double |  Sim  | Um duplo entre 0 e 1 que avalia se o agente de IA selecionou a ferramenta correta, onde 1 indica a seleção correta da ferramenta. | 
| ai\_tool\_utilization\_accuracy | double |  Sim  | Um duplo entre 0 e 1 que avalia se o agente de IA utilizou corretamente a ferramenta, onde 1 indica o uso perfeito. |