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 do 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: ** monitora eventos de invocação de agentes de IA, incluindo sucesso de invocação, latência, turnos de conversa 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`— Junções 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, AI Agent Knowledge Base
+ `assistant_id`— Junta-se à sessão de IA, ao prompt de inteligência artificial e à ferramenta de inteligência artificial


|  **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 do 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 assistente de IA. | 
| id da sessão ai | string |  Sim  | O ID da AI-Agent sessão. | 
| creation\_timestamp | bigint |  Sim  | A data e hora do evento é criada no data lake. | 
| update\_timestamp | bigint |  Sim  | A data e hora do evento é atualizada no data lake. | 
| ai\_use\_case | string |  Sim  | O caso de uso do agente de IA. | 
| tipo\_do\_agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| nome\_do\_agente ai | string |  Sim  | O nome do agente de IA solicitado. | 
| ai\_agent\_arn | string |  Sim  | O Arn do agente de IA solicitado. | 
| invocação\_sucesso | bool |  Sim  | Um campo booleano que indica se a invocação do agente de IA foi bem-sucedida ou não. | 
| latência\_invocação\_ms | flutuação |  Sim  | A latência de invocação do agente de IA no contato avaliado. | 
| conversação vira 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 classificadas como úteis com um sinal positivo. | 
| resposta não é útil | int |  Sim  | A contagem de sugestões de IA classificadas como inúteis com o polegar para baixo. | 
| data\_lake\_last\_processed\_timestamp | Timestamp |  Sim  | O carimbo de data/hora, 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. | 

## 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`— Junções ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Junta-se à sessão de IA, agente de IA, prompt de IA, 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 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 do Connect. | 
| contact\_id | string |  Sim  | O ID do contato específico. | 
| id de conteúdo de conhecimento | string |  Sim  | O ID do conteúdo de conhecimento referenciado. | 
| tipo\_do\_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  | No 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. | 
| nome\_do\_agente ai | string |  Sim  | O nome do agente de IA solicitado. | 
| versão\_ai\_agent\_br | 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. | 
| ID da base de conhecimento | string |  Sim  | O ID da base de conhecimento referenciada. | 
| nome\_da\_base de conhecimento | string |  Sim  | O nome da base de conhecimento referenciada. | 
| referência de conteúdo de conhecimento | string |  Sim  | O título do conteúdo de conhecimento referenciado. | 
| data\_lake\_last\_processed\_timestamp | timestamp |  Sim  | O carimbo de data/hora, 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: ** monitora eventos de invocação do AI Prompt, incluindo uso do modelo, contagem de tokens, latência e sucesso da invocação para cada chamada de prompt 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`— Junções ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Junta-se à sessão de IA, agente de IA, 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 do 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\_br | 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  | A data e hora em que o evento é criado no data lake. | 
| update\_timestamp | bigint |  Sim  | A data e hora em que o evento é atualizado no data lake. | 
| tipo\_do\_agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| nome\_do\_agente ai | 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 aviso do AI Prompt invocado. | 
| model\_id | string |  Sim  | O nome do modelo llm associado ao AI Prompt. | 
| invocação\_sucesso | booleano |  Sim  | Um campo booleano que indica se a invocação do prompt foi bem-sucedida ou não. | 
| latência\_invocação\_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. | 
| data\_lake\_last\_processed\_timestamp | Timestamp |  Sim  | O carimbo de data/hora, 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. | 

## 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ções, contagens de invocações, status de entrega e índices 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`— Junções ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Junta-se ao AI Agent, AI Prompt, AI Tool, 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 do 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 assistência ao agente. | 
| creation\_timestamp | bigint |  Sim  | A data e hora em que o evento é criado no data lake. | 
| update\_timestamp | bigint |  Sim  | A 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 do Agent Assistance. | 
| 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 do Agent Assistance. | 
| 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 do Agent Assistance. | 
| 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 de agentes de IA na sessão de IA. | 
| é\_entregado\_desligado | 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\_meta | double |  Sim  | Um duplo entre 0 e 1 que avalia se o agente do Orchestration AI resolveu com êxito 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 de 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. | 
| data\_lake\_last\_processed\_timestamp | Timestamp |  Sim  | O carimbo de data/hora, 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. | 

## 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`— Junções ao registro de contato, registro estatístico de contato, lente de contato
+ `ai_session_id`— Junta-se à 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 que possui o Connect AI Assistant. | 
| instance\_id | string |  Não  | O ID da instância do Connect. | 
| contact\_id | string |  Sim  | O ID do contato. | 
| ai\_agent\_id | string |  Sim  | O ID do agente de IA solicitado. | 
| ai\_tool\_id | 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  | No instante em que o evento do data lake foi modificado pela última vez. | 
| tipo\_do\_agente ai | string |  Sim  | O tipo do agente de IA solicitado. | 
| nome\_do\_agente ai | string |  Sim  | O nome do agente de IA solicitado. | 
| versão\_ai\_agent\_br | 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\_tool\_type | string |  Sim  | O tipo da ferramenta de IA invocada. | 
| nome\_da\_ferramenta ai | string |  Sim  | O nome da ferramenta de IA invocada. | 
| ai\_tool\_arn | string |  Sim  | O ARN da ferramenta de IA invocada. | 
| invocação\_sucesso | booleano |  Sim  | Um campo booleano que indica se a invocação da ferramenta foi bem-sucedida ou não. | 
| latência\_invocação\_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, em que 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, em que 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, em que 1 indica uso perfeito. | 
| data\_lake\_last\_processed\_timestamp | Timestamp |  Sim  | O carimbo de data/hora, 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. |