# Utilizar conexiones a Anthropic (Amazon Bedrock) en expresiones de visualización

Además de agregar preguntas y respuestas de Anthropic al modelo de datos de su aplicación mediante el script de carga, también puede realizar estas operaciones directamente en un gráfico de su aplicación en modo de análisis. Los datos de un solo campo se envían de un lado a otro entre usted y Anthropic.

Nota informativa

El conector Amazon Bedrock - Converse API le permite conectarse a la API universal de Amazon Bedrock para modelos de generación de texto, incluidos uno o varios modelos disponibles a través de este conector. Para una funcionalidad más avanzada, considere la posibilidad de sustituir las conexiones de Anthropic (Amazon Bedrock) por conexiones de Amazon Bedrock - Converse API. Para más información, vea [Amazon Bedrock - Converse API Fuente de analítica](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-overview.htm).

En muchos casos, el código utilizado para una conexión de script de carga se puede reutilizar para su uso en un gráfico, con algunas diferencias.

Si el caso de uso se basa en lo introducido por el usuario, puede usar una conexión analítica y la sintaxis de extensión del lado del servidor correspondiente en su expresión de gráfico para crear gráficos interactivos que visualicen los datos recibidos de los puntos de conexión del modelo.

## Consideraciones en cuanto a los volúmenes de solicitud de datos

Se recomienda utilizar conexiones de Anthropic (Amazon Bedrock) únicamente en expresiones de gráfico para una o varias filas de datos. No se recomienda utilizar expresiones de gráfico para enviar grandes cantidades de datos a Anthropic.

Es importante tener en cuenta cuántas filas está enviando con cada solicitud. Los errores en la configuración de la conexión en una expresión de gráfico pueden dar lugar a solicitudes involuntariamente grandes (por ejemplo, filas idénticas con la misma pregunta debido al uso inadecuado del modelo de datos en un gráfico). Antes de interactuar con una plataforma de terceros, asegúrese de saber cómo los campos utilizados en el cálculo de la expresión del gráfico y su ubicación en el modelo de datos afectan a su acuerdo financiero y de facturación con el tercero. Un mayor uso de la plataforma externa podría generar mayores costes.

Siga estas pautas para moderar y limitar el tamaño de sus solicitudes:

* Cuando trabaje con expresiones de gráfico, utilice únicamente la conexión en un objeto de texto (desde la página Dashboard bundle). Se desaconseja enfáticamente usar una conexión de Anthropic (Amazon Bedrock) en un objeto de Tabla, sobre todo si está agregando la expresión a una tabla con una o más dimensiones ya agregadas.

* Si la expresión del gráfico está vinculada al modelo de datos de su aplicación, utilice una sentencia if en la expresión para calcular solo el gráfico cuando se realiza una única selección en la aplicación. Esto reduce drásticamente el número de filas en las solicitudes que su gráfico enviará a Anthropic.

* Si está usando la conexión de Anthropic (Amazon Bedrock) para enviar solicitudes grandes, utilice la conexión en su script de carga en lugar de en una expresión de gráfico, para que los datos se carguen previamente en su modelo de datos.

## Ingeniería rápida

Cuando redacte las solicitudes que envía a un modelo de IA generativa (a menudo conocidas como prompts o indicaciones), siga las directrices específicas de la plataforma con la que interactúa. Para obtener información sobre la ingeniería de indicaciones (prompts) y algunas pautas sobre cómo estructurar las solicitudes para conectores de Amazon Bedrock, vea [Conceptos de ingeniería de indicaciones](https://docs.aws.amazon.com/bedrock/latest/userguide/prompt-engineering-guidelines.html).

### Construir solicitudes para la configuración de Anthropic - Claude

Puede utilizar la configuración Anthropic - Claude para conectarse a varios modelos Claude heredados.

Los prompts (mensajes o solicitudes) escritos para esta configuración requieren una sintaxis específica para devolver las respuestas completas correctamente. Aquí tiene los requisitos:

* Cada solicitud debe tener el prefijo de texto Human:

* Cada solicitud debe tener el sufijo de texto Assistant:

* El prefijo Human: debe tener dos retornos de carro precedentes. Esto se logra agregando `chr(10) & chr(10)` a la expresión, antes del prefijo.

* El sufijo Assistant: debe tener dos retornos de carro precedentes. Esto se logra agregando `chr(10) & chr(10)` a la expresión, antes del sufijo.

Para obtener información sobre cómo estructurar y dar formato a una solicitud de Claude, consulte [Crear una solicitud](https://docs.anthropic.com/claude/docs/constructing-a-prompt).

Para ejemplos, vea [Ejemplos rápidos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-anthropic-use.htm#Quick).

### Crear solicitudes para la configuración de Anthropic - Claude (Messages API).

La configuración de Anthropic - Claude (Messages API) conecta con la API Messages.

Las solicitudes para estos modelos no requieren ninguna sintaxis específica. Para ejemplos, vea [Ejemplos rápidos](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-anthropic-use.htm#Quick).

## Crear la expresión de gráfico

Haga lo siguiente:

1. Al editar una visualización, haga clic en the Expresión icon para acceder al editor de expresiones.

2. En el editor de expresiones, inserte una expresión en el campo de expresión. La expresión debe construirse utilizando la sintaxis de extensión del lado del servidor.

## Ejemplos rápidos

Aquí encontrará expresiones a modo de ejemplo, que se pueden utilizar para comenzar con el conector Anthropic (Amazon Bedrock). Tenga en cuenta los siguientes detalles:

* Utilice las expresiones solo con un objeto de Texto (desde el Dashboard bundle). Vea [Texto](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/text-object.htm).

* Considere la posibilidad de añadir una sentencia `if` a sus expresiones para controlar cuándo se recalculará el gráfico, y para actualizarlo en función de las selecciones del usuario en la aplicación.

* Para que las expresiones funcionen, debe sustituir el valor de `connectionname` y los nombres de los campos, para que coincidan con sus propias conexiones y aplicaciones.

* Existen diferentes requisitos de sintaxis para cada configuración de este conector. Vea [Ingeniería rápida](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-anthropic-use.htm#Prompt).

Ejemplos de expresiones de gráfico para el conector analítico de Anthropic (Amazon Bedrock)

Ejemplos de expresiones de gráfico para el conector analítico de Anthropic (Amazon Bedrock)Anthropic (Amazon Bedrock)

| Configuración del conector | Expresión | Resumen |
| --- | --- | --- |
| Anthropic - Claude | `endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.' & chr(10) & chr(10) & 'Assistant:')` | Esta sentencia devolverá la respuesta de Anthropic a una única pregunta que se haya introducido en la expresión.<br><br>Nota de aviso<br><br>Esta expresión no utiliza una sentencia `if`, y por lo tanto no es adecuada para ser utilizada si va ligada a un campo en su modelo de datos. Únicamente es adecuada para su uso en una expresión independiente, con una sola celda de entrada que contenga un valor codificado. |
| Anthropic - Claude | `if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human:' & vQuestion & chr(10) & chr(10) & ' Assistant:'))` | Se trata de una sentencia que se puede utilizar en un objeto de Texto (desde el Dashboard bundle) vinculado a un control de entrada variable. El gráfico sólo se calcula cuando se introducen datos. Cuando el usuario escribe datos de entrada en el objeto y pulsa Intro, el gráfico muestra la respuesta del modelo a lo introducido.<br><br>Tenga en cuenta que, dados los requisitos de la solicitud de Anthropic, el usuario debe insertar el prefijo y el sufijo manualmente en su entrada.<br><br>Para un tutorial similar con un conector diferente, vea [Ejercicio: crear un cuadro de entrada de texto usando una variable](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm#Exercise). |
| Anthropic - Claude | `if(count(distinct [BusinessTopic]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"completion"}}', chr(10) & chr(10) & 'Human: write me a sample response from a technical support department for a customer complaint about ' & [BusinessTopic] & chr(10) & chr(10) & ' Assistant:'))` | En este ejemplo, el gráfico sólo se calcula si se ha seleccionado un valor distinto del campo `IssueCategory` en el modelo de datos de la aplicación. Se envía una solicitud al modelo pidiendo un ejemplo de respuesta para un departamento de asistencia técnica sobre un tipo general de problemas, un listado de los cuales figura en el campo `IssueCategory`. El gráfico se actualiza en función del valor seleccionado por el usuario. |
| Anthropic - Claude (Messages API) | `endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Translate this text from English to Spanish: The sun was rising over the new tomorrow with a tinge of excitement.')` | Esta sentencia devolverá la respuesta de Anthropic a una única pregunta que se haya introducido en la expresión.<br><br>Nota de aviso<br><br>Esta expresión no utiliza una sentencia `if`, y por lo tanto no es adecuada para ser utilizada si va ligada a un campo en su modelo de datos. Únicamente es adecuada para su uso en una expresión independiente, con una sola celda de entrada que contenga un valor codificado. |
| Anthropic - Claude (Messages API) | `if(vQuestion <> '', endpoints.scriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}',vQuestion))` | Se trata de una sentencia que se puede utilizar en un objeto de Texto (desde el Dashboard bundle) vinculado a un control de entrada variable. El gráfico sólo se calcula cuando se introducen datos. Cuando el usuario escribe datos de entrada en el objeto y pulsa Intro, el gráfico muestra la respuesta del modelo a lo introducido.<br><br>Para un tutorial similar con un conector diferente, vea [Ejercicio: crear un cuadro de entrada de texto usando una variable](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-openai-tutorial-example-3.htm#Exercise). |
| Anthropic - Claude (Messages API) | `if(count(distinct [IssueCategory]) = 1, endpoints.ScriptAggrStr('{"RequestType":"endpoint", "endpoint":{"connectionname":"Anthropic_(Amazon_Bedrock)","column":"text"}}', 'Write me a sample response from a technical support department for a customer complaint about ' & [IssueCategory]'))` | En este ejemplo, el gráfico sólo se calcula si se ha seleccionado un valor distinto del campo `IssueCategory` en el modelo de datos de la aplicación. Se envía una solicitud al modelo pidiendo un ejemplo de respuesta para un departamento de asistencia técnica sobre un tipo general de problemas, un listado de los cuales figura en el campo `IssueCategory`. El gráfico se actualiza en función del valor seleccionado por el usuario. |

## Más información

* [Sintaxis de las extensiones del lado del servidor](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/sse-syntax.htm)
* [if Función de script y de gráfico](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Scripting/ConditionalFunctions/if.htm)
* [GetSelectedCount - función de gráfico](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/ChartFunctions/FieldFunctions/getselectedcount.htm)
* [Utilizar variables en expresiones](https://help.qlik.com/es-ES/cloud-services/Subsystems/Hub/Content/Sense_Hub/Variables/work-with-variables.htm)