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.

# Agregue datos de clientes a una sesión de agente de IA
<a name="ai-agent-session"></a>

Amazon Connect permite añadir datos personalizados a una sesión de agente de Connect AI para que puedan utilizarse para impulsar las soluciones generativas impulsadas por la IA. Los datos personalizados se pueden utilizar añadiéndolos primero a una sesión mediante la [UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html)API y, a continuación, utilizándolos para personalizar las solicitudes de IA.

## Adición y actualización de datos en una sesión
<a name="adding-updating-data-ai-agent-session"></a>

Los datos se añaden a una sesión mediante la [UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html)API. Utilice el siguiente comando AWS CLI de ejemplo. 

```
aws qconnect update-session-data \
  --assistant-id <YOUR_CONNECT_AI_AGENT_ASSISTANT_ID> \
  --session-id <YOUR_CONNECT_AI_AGENT_SESSION_ID> \
  --data '[
    { "key": "productId", "value": { "stringValue": "ABC-123" }},
  ]'
```

Como las sesiones se crean para los contactos, una forma útil de añadir datos de sesión es mediante un flujo: utilice un [Función de AWS Lambda ](invoke-lambda-function-block.md) bloque para llamar a la [UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html)API. La API puede agregar información a la sesión.

Este es el procedimiento: 

1. Agregue un [Connect Assistant](connect-assistant-block.md) bloque a su flujo. Asocia un dominio de agente de Connect AI a un contacto para que Amazon Connect pueda buscar recomendaciones en tiempo real en las bases de conocimiento.

1. Coloque el bloque [Función de AWS Lambda ](invoke-lambda-function-block.md) después del bloque [Connect Assistant](connect-assistant-block.md). La [UpdateSessionData](https://docs.aws.amazon.com/connect/latest/APIReference/API_amazon-q-connect_UpdateSessionData.html)API requiere el sessionID. Puedes recuperar el SessionID mediante la API y [DescribeContact](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeContact.html)el AssistantID que está asociado al bloque. [Connect Assistant](connect-assistant-block.md) 

La siguiente imagen muestra los dos bloques, primero [Connect Assistant](connect-assistant-block.md) y después [Función de AWS Lambda ](invoke-lambda-function-block.md). 

![\[El bloque Connect Assistant y el bloque de funciones AWS Lambda están configurados para añadir datos de sesión.\]](http://docs.aws.amazon.com/es_es/connect/latest/adminguide/images/ai-agents-add-session-data.png)


## Uso de datos personalizados con una petición de IA
<a name="using-with-ai-prompt-custom-data"></a>

 Después de añadir los datos a una sesión, puede personalizar las peticiones de IA para utilizar los datos en los resultados de la IA generativa. 

Para especificar la variable personalizada de los datos, utilice el siguiente formato: 
+ `{{$.Custom.<KEY>}}`

Por ejemplo, supongamos que un cliente necesita información relacionada con un producto específico. Puede crear una petición de IA de **Reformulación de consultas** que utilice el productId que el cliente ha proporcionado durante la sesión. 

En el siguiente extracto de una petición de IA se muestra el envío de \$1\$1\$1.Custom.productId\$1\$1 al LLM. 

```
anthropic_version: bedrock-2023-05-31
system: You are an intelligent assistant that assists with query construction.
messages:
- role: user
  content: |
    Here is a conversation between a customer support agent and a customer

    <conversation>
      {{$.transcript}}
    </conversation>
    
    And here is the productId the customer is contacting us about
    
    <productId>
      {{$.Custom.productId}}
     </productId>

    Please read through the full conversation carefully and use it to formulate a query to find
    a relevant article from the company's knowledge base to help solve the customer's issue. Think 
    carefully about the key details and specifics of the customer's problem. In <query> tags, 
    write out the search query you would use to try to find the most relevant article, making sure 
    to include important keywords and details from the conversation. The more relevant and specific 
    the search query is to the customer's actual issue, the better. If a productId is specified, 
    incorporate it in the query constructed to help scope down search results.

    Use the following output format

    <query>search query</query>

    and don't output anything else.
```

Si el valor de la variable personalizada no está disponible en la sesión, se interpola como una cadena vacía. Recomendamos proporcionar instrucciones en la petición de IA para que el sistema tenga en cuenta la presencia del valor en cualquier comportamiento alternativo.