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. # Generación, ejecución y prueba del código para la aplicación mediante la activación de la interpretación del código La interpretación del código permite a su agente generar, ejecutar y solucionar los problemas del código de la aplicación en un entorno de prueba seguro. Con la interpretación del código, puede utilizar el modelo fundacional del agente para generar código para implementar las capacidades básicas y, al mismo tiempo, centrarse en crear aplicaciones de IA generativa. Puede llevar a cabo las siguientes tareas con la interpretación del código en Amazon Bedrock: + Comprender las solicitudes de los usuarios para tareas específicas, generar código que pueda realizar las tareas solicitadas por el usuario, ejecutar el código y proporcionar el resultado de la ejecución del código. + Comprender las consultas genéricas del usuario, generar y ejecutar código para responder al usuario. + Generar código para realizar el análisis, la visualización y la evaluación de los datos. + Extraer información de los archivos cargados por el usuario, procesar la información y responder a las consultas de los usuarios. + Generar código basado en las conversaciones interactivas con el usuario para crear prototipos rápidamente. De forma predeterminada, el número máximo de interpretaciones de código activas simultáneamente por sesión y por Cuenta de AWS es de 25. Esto significa que cada Cuenta de AWS puede mantener hasta 25 conversaciones continuas con los agentes a la vez mediante el intérprete de código. Los siguientes son algunos de los casos de uso en los que la interpretación del código puede ayudar al generar y ejecutar el código dentro de Amazon Bedrock: 1. Analizar las transacciones financieras desde un archivo de datos, como un archivo .csv, para determinar si se han generado ganancias o pérdidas. 1. Convertir el formato de fecha, como el *14 de marzo de 2020*, al formato API `YYYY-MM-DD` estándar para formatos de archivo, como .txt o .csv. 1. Realizar análisis de datos en una hoja de cálculo (XLS) para calcular métricas, como los ingresos trimestrales o anuales de la empresa o la tasa de crecimiento de la población. Para usar la interpretación del código en Amazon Bedrock, siga estos pasos: + Active la interpretación del código al crear el agente. Después de activar la interpretación del código, podrá empezar a utilizarla. + Comience a utilizar la interpretación del código en Amazon Bedrock mediante peticiones. Por ejemplo, puede preguntar “calcula la raíz cuadrada de pi con 127 dígitos”. La interpretación del código generará y ejecutará código python para generar una respuesta. + También puede asociar archivos. Puede usar la información de los archivos para hacer preguntas y resumir o analizar los datos. Puede asociar los archivos desde el equipo o desde el bucket de Amazon S3. **Regiones admitidas** La interpretación del código de Agentes para Amazon Bedrock se admite en las siguientes regiones: **** | Región | | --- | | Este de EE. UU. (Norte de Virginia) | | Oeste de EE. UU. (Oregón) | | Europa (Fráncfort) | **Compatibilidad de archivos** La interpretación del código permite asociar archivos y luego usar los archivos asociados para hacer preguntas y resumir o analizar los datos en función del contenido de los archivos asociados. Puede asociar un máximo de cinco archivos. El tamaño total de todos los archivos puede ser de hasta 10 MB. + **Tipos de archivos de entrada admitidos**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT y PDF + **Tipos de archivos de salida admitidos**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT, PDF y PNG # Activación de la interpretación del código en Amazon Bedrock Puede activar la interpretación del código en la consola de Amazon Bedrock al [crear](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-create.html) o [actualizar](https://docs.aws.amazon.com//bedrock/latest/userguide/agents-manage.html#agents-edit) el agente. Si utiliza la API o SDKs, puede habilitar la interpretación del código al [crear](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html) o [actualizar](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html) el grupo de acciones. Para obtener más información sobre cómo activar la interpretación de código en Amazon Bedrock, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Activación de la interpretación del código para el agente** 1. Si aún no se encuentra en el creador de agentes, haga lo siguiente: 1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**. 1. Elija **Editar en el Creador de agentes**. 1. Expanda la sección **Configuración adicional**. 1. En **Intérprete de código**, seleccione **Activar**. 1. Primero debe **Guardar** y luego **Preparar** para aplicar los cambios que haya realizado en el agente antes de probarlo. ------ #### [ API ] Para habilitar la interpretación del código para su agente, envíe una [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)solicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) a un [punto final de tiempo de compilación de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique los siguientes campos: **** | Campo | Descripción breve | | --- | --- | | actionGroupName | Nombre del grupo de acciones | | parentActionGroupFirma | Especifique AMAZON.CodeInterpreter para permitir que el agente genere y pruebe el código | | actionGroupState | Especifique ENABLED para permitir que el agente invoque la interpretación del código | A continuación se muestra el formato general de los campos obligatorios para permitir la interpretación del código en una [CreateActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_CreateAgentActionGroup.html)solicitud. ``` CreateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "ENABLED" } ``` ------ # Prueba de la interpretación del código en Amazon Bedrock Antes de probar la interpretación del código en Amazon Bedrock, asegúrese de preparar al agente para aplicarle los cambios que acaba de realizar. Con la interpretación del código habilitada, cuando comience a realizar las pruebas con el agente, podrá asociar archivos y elegir cómo quiere que se utilicen los archivos que asocie en la interpretación del código. Según su caso de uso, puede solicitar a la interpretación del código que utilice la información de los archivos asociados para resumir el contenido del archivo y responder a las consultas sobre el contenido del archivo durante una conversación de chat interactiva. O bien, puede solicitar la interpretación del código para analizar el contenido de los archivos asociados y proporcionar métricas e informes de visualización de datos. **Asociar archivos** Para obtener más información sobre cómo adjuntar archivos para la interpretación de código, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Asociación de archivos para la interpretación del código** 1. Si aún no se encuentra en el creador de agentes, haga lo siguiente: 1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**. 1. Elija **Editar en el Creador de agentes**. 1. Expanda **Configuración adicional** y confirme que **Intérprete de código** esté activado. 1. Asegúrese de que el agente esté preparado. 1. Si la ventana de prueba no está abierta, elija **Prueba**. 1. En la parte inferior de la ventana de prueba, seleccione el icono del sujetapapeles para asociar archivos. 1. En la página **Asociar archivos**, haga lo siguiente: 1. **En **Elegir función**, especifique lo siguiente:** + Si va a asociar archivos para que el agente los utilice para responder a sus consultas y resumir el contenido, elija **Asociar archivos al chat (más rápido)**. + Si va a asociar archivos para la interpretación del código a fin de analizar el contenido y proporcionar métricas, elija **Asociar archivos al intérprete de código**. 1. **En **Elegir método de carga**, elija desde dónde quiere cargar los archivos:** + Si va a cargar archivos desde su ordenador, elija **Elegir archivos** y seleccione los archivos que desea asociar. + Si está cargando desde Amazon S3, elija **Examinar S3**, seleccione los archivos, **Elegir** y, a continuación, **Agregar**. 1. Elija **Adjuntar**. ------ #### [ API ] Para probar la interpretación del código, envíe una [InvokeAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_InvokeAgent.html)solicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) a un punto final de tiempo de [compilación de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). **Para asociar archivos para que el agente los utilice para responder a sus consultas y resumir el contenido, especifique los siguientes campos:** **** | Campo | Descripción breve | | --- | --- | | name | Es el nombre del archivo asociado. | | sourceType | Es la ubicación del archivo que se va a asociar. Especifique s3 si el archivo se encuentra en el bucket de Amazon S3. Especifique byte\$1content si el archivo se encuentra en su ordenador. | | S3Location | Es la ruta de S3 en la que se encuentra el archivo. Este campo es obligatorio si el sourceType es S3. | | mediaType | Es el tipo de archivo asociado. **Tipos de archivos de entrada admitidos**: CSV, XLS, XLSX, YAML, JSON, DOC, DOCX, HTML, MD, TXT y PDF | | data | Es la cadena codificada en base64. El tamaño máximo del archivo es 10 MB. Si utiliza el SDK, solo tiene que proporcionar el contenido de los bytes del archivo. AWS El SDK codifica automáticamente las cadenas en base64. | | useCase | Es la manera en que desea que se usen los archivos asociados. Valores válidos: CHAT \$1 CODE\$1INTERPRETER | En el siguiente ejemplo se muestra el formato general de especificación de los campos obligatorios para asociar archivos al chat. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": "uri": "s3Uri" } }, "useCase": "CHAT" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CHAT" } ] } ``` En el siguiente ejemplo se muestra el formato general de especificación de los campos obligatorios para asociar archivos para la interpretación del código. ``` "sessionState": { "promptSessionAttributes": { "string": "string" }, "sessionAttributes": { "string": "string" }, "files": [ { "name": "banking_data", "source": { "sourceType": "S3", "s3Location": { "uri": "s3Uri" } }, "useCase": "CODE_INTERPRETER" }, { "name": "housing_stats.csv", "source": { "sourceType": "BYTE_CONTENT", "byteContent": { "mediaType": "text/csv", "data": "file byte content" } }, "useCase": "CODE_INTERPRETER" } ] } ``` ------ # Desactivación de la interpretación del código en Amazon Bedrock Puede desactivar la interpretación del código en Amazon Bedrock en cualquier momento. Para obtener más información sobre cómo desactivar la interpretación de código, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Desactivación de la interpretación del código** 1. Inicie sesión Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola Amazon Bedrock. A continuación, abra la consola de Amazon Bedrock en [https://console.aws.amazon.com/bedrock.](https://console.aws.amazon.com/bedrock) 1. En el panel de navegación de la izquierda, seleccione **Agentes**. A continuación, elija un agente en la sección **Agentes**. 1. Elija **Editar en el Creador de agentes**. 1. Expanda la sección **Configuración adicional** y seleccione **Desactivar** para **Intérprete de código**. 1. Seleccione **Preparar** en la parte superior de la página. Y, a continuación, seleccione **Guardar** para guardar los cambios en el agente. ------ #### [ API ] Para deshabilitar la interpretación del código, envíe una [UpdateAgentActionGroup](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_UpdateAgentActionGroup.html)solicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) a un [punto final de tiempo de compilación de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique los siguientes campos: **** | Campo | Descripción breve | | --- | --- | | actionGroupName | Nombre del grupo de acciones | | parentActionGroupFirma | Especifique AMAZON.CodeInterpreter para desactivar el intérprete de código. | | actionGroupState | Especifique DISABLED para desactivar el intérprete de código. | En el ejemplo siguiente se muestra el formato general de especificación de los campos obligatorios para desactivar la interpretación del código. ``` UpdateAgentActionGroup: { "actionGroupName": "CodeInterpreterAction", "parentActionGroupSignature": "AMAZON.CodeInterpreter", "actionGroupState": "DISABLED" } ``` ------ Una vez que haya desactivado la interpretación del código para su agente, asegúrese de enviar una [PrepareAgent](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent_PrepareAgent.html)solicitud (consulte el enlace para ver los formatos de solicitud y respuesta y los detalles de los campos) con un punto final de tiempo de [compilación de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).