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. # Creación y almacenamiento de peticiones reutilizables con la administración de peticiones en Amazon Bedrock Amazon Bedrock le permite crear y guardar sus propias peticiones mediante la administración de peticiones para ahorrar tiempo al aplicar la misma petición a diferentes flujos de trabajo. Al crear una petición, puede seleccionar un modelo para realizar inferencias en él y modificar los parámetros de inferencia que desee utilizar. Puede incluir variables en la petición para poder adaptarla a diferentes casos de uso. Al probar la petición, tiene la opción de comparar diferentes variantes de la petición y elegir la variante que produzca los resultados que mejor se adapten a su caso de uso. Mientras itera la petición, puede guardar versiones de la misma. Puede integrar una petición en su aplicación con la ayuda de [Flujos de Amazon Bedrock](flows.md). El siguiente es el flujo de trabajo general para utilizar la administración de peticiones: 1. Cree una petición en la administración de peticiones que desee reutilizar en diferentes casos de uso. Incluya variables para proporcionar flexibilidad a la petición del modelo. 1. Elija un modelo, un perfil de inferencia o un agente para ejecutar la inferencia en la petición y modifique las configuraciones de la inferencia según sea necesario. 1. Rellene los valores de prueba para las variables y ejecute la petición. Puede crear variantes de la petición y comparar las salidas de las distintas variantes para elegir la que mejor se adapte a su caso de uso. 1. Integre la petición en la aplicación de una de las siguientes maneras: + Especifique la petición al [ejecutar la inferencia del modelo](inference.md). + Agregue un nodo de petición a un [flujo](flows.md) y especifique la petición. **Topics** + [Definiciones clave](#prompt-management-definitions) + [Regiones y modelos compatibles con la administración de peticiones](prompt-management-supported.md) + [Requisitos previos para la administración de peticiones](prompt-management-prereq.md) + [Creación de una petición con la administración de peticiones](prompt-management-create.md) + [Visualización de información sobre las peticiones mediante la administración de solicitudes](prompt-management-view.md) + [Modificación de una petición con la administración de peticiones](prompt-management-modify.md) + [Prueba de una petición con la administración de peticiones](prompt-management-test.md) + [Optimización de una petición](prompt-management-optimize.md) + [Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones](prompt-management-deploy.md) + [Eliminación de una petición en la administración de peticiones](prompt-management-delete.md) + [Ejecución de ejemplos de código de administración de peticiones](prompt-management-code-ex.md) ## Definiciones clave En la siguiente lista se enumeran los conceptos básicos de la administración de peticiones: + **Petición**: es una entrada que se proporciona al modelo para que genere una respuesta o salida adecuadas. + **Variable**: es un marcador de posición que se puede incluir en la petición. Puede incluir valores para cada variable al probar la petición o cuando invoque el modelo en tiempo de ejecución. + **Variante de la petición**: es una configuración alternativa de la petición, que incluye su mensaje o las configuraciones de inferencia o del modelo que se utilizan. Puede crear diferentes variantes de una petición, probarlas y guardar la variante que desee conservar. + **Generador de peticiones**: es una herramienta de la consola de Amazon Bedrock que permite crear, editar y probar peticiones y sus variantes en una interfaz visual. # Regiones y modelos compatibles con la administración de peticiones La gestión rápida se apoya en lo siguienteRegiones de AWS: + ap-northeast-1 + ap-northeast-2 + ap-northeast-3 + ap-south-1 + ap-south-2 + ap-southeast-1 + ap-southeast-2 + ca-central-1 + eu-central-1 + eu-central-2 + eu-north-1 + eu-south-1 + eu-south-2 + eu-west-1 + eu-west-2 + eu-west-3 + sa-east-1 + us-east-1 + us-east-2 + us-gov-east-1 + us-gov-west-1 + us-west-2 Puede utilizar la administración de peticiones con cualquier modelo de texto compatible con la API de [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html). Para obtener una lista de los modelos admitidos, consulte [Modelos y características del modelo compatibles](conversation-inference-supported-models-features.md). **nota** [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html)y [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html)solo funcionan con las solicitudes de Prompt Management cuya configuración especifique un Meta Llama modelo Anthropic Claude O. # Requisitos previos para la administración de peticiones Para que un rol utilice la administración de peticiones, debe permitirle realizar un conjunto determinado de acciones de la API. Consulte los siguientes requisitos previos y cumpla los que se apliquen a su caso de uso: 1. Si su función tiene la política [AmazonBedrockFullAccess](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonBedrockFullAccess)AWSgestionada adjunta, puede omitir esta sección. De lo contrario, siga los pasos que se indican en [Actualizar la política de permisos para un rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) y asocie la siguiente política a un rol para proporcionar permisos que permitan realizar acciones relacionadas con la administración de peticiones: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "PromptManagementPermissions", "Effect": "Allow", "Action": [ "bedrock:CreatePrompt", "bedrock:UpdatePrompt", "bedrock:GetPrompt", "bedrock:ListPrompts", "bedrock:DeletePrompt", "bedrock:CreatePromptVersion", "bedrock:OptimizePrompt", "bedrock:GetFoundationModel", "bedrock:ListFoundationModels", "bedrock:GetInferenceProfile", "bedrock:ListInferenceProfiles", "bedrock:InvokeModel", "bedrock:InvokeModelWithResponseStream", "bedrock:RenderPrompt", "bedrock:TagResource", "bedrock:UntagResource", "bedrock:ListTagsForResource" ], "Resource": "*" } ] } ``` ------ Para restringir aún más los permisos, puede omitir acciones o puede especificar recursos y claves de condición para filtrar los permisos. Para obtener más información sobre las acciones, los recursos y las claves de condición, consulte los siguientes temas en la *Referencia de autorizaciones de servicio*: + [Acciones definidas por Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-actions-as-permissions): obtenga información sobre las acciones, los tipos de recursos a los que puede aplicarlas en el campo `Resource` y las claves de condición que puede usar para filtrar los permisos en el campo `Condition`. + [Tipos de recursos definidos por Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-resources-for-iam-policies): obtenga información sobre los tipos de recursos de Amazon Bedrock. + [Claves de condición de Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys): obtenga información sobre las claves de condición de Amazon Bedrock. **nota** Si planea implementar su petición mediante la API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html), consulte [Requisitos previos para ejecutar la inferencia de modelos](inference-prereq.md) para obtener información sobre los permisos que debe configurar para invocar una petición. Si piensa utilizar un [flujo](flows.md) de Flujos de Amazon Bedrock para implementar su petición, consulte [Requisitos previos de Flujos de Amazon Bedrock](flows-prereq.md) para obtener información sobre los permisos que debe configurar para crear un flujo. 1. Si planea cifrar su solicitud con una clave administrada por el cliente en lugar de usar una Clave administrada de AWS (para obtener más información, consulte [AWS KMSclaves](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html)), cree las siguientes políticas: 1. Siga los pasos que se indican en [Crear una política de claves](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-overview.html) y adjunte la siguiente política de claves a una clave de KMS para permitir que Amazon Bedrock cifre y descifre un mensaje con la clave y sustituya la que sea necesario. *values* La política contiene claves de condición opcionales (consulte [Claves de condición para Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) y [Claves de contexto de condición globales de AWS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) en el campo `Condition` que es una práctica de seguridad que recomendamos. ``` { "Sid": "EncryptFlowKMS", "Effect": "Allow", "Principal": { "Service": "bedrock.amazonaws.com" }, "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:aws:bedrock-prompts:arn": "arn:${partition}:bedrock:${region}:${account-id}:prompt/${prompt-id}" } } } ``` 1. Siga los pasos que se indican en [Actualizar la política de permisos de un rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_update-role-permissions.html#id_roles_update-role-permissions-policy) y adjunte la siguiente política a la función de gestión rápida, sustituyéndola *values* según sea necesario, para que pueda generar y descifrar la clave gestionada por el cliente para una solicitud. La política contiene claves de condición opcionales (consulte [Claves de condición para Amazon Bedrock](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys) y [Claves de contexto de condición globales de AWS](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonbedrock.html#amazonbedrock-policy-keys)) en el campo `Condition` que es una práctica de seguridad que recomendamos. ``` { "Sid": "KMSPermissions", "Effect": "Allow", "Action": [ "kms:GenerateDataKey", "kms:Decrypt" ], "Resource": [ "arn:aws:kms:${region}:${account-id}:key/${key-id}" ], "Condition": { "StringEquals": { "aws:ResourceAccount": "${account-id}" } } } ``` # Creación de una petición con la administración de peticiones Al crear una petición, dispone de las siguientes opciones: + Escriba el mensaje de la petición que sirve de entrada para que un FM genere una salida. + Utilice corchetes dobles para incluir las variables (como en *\$1\$1variable\$1\$1*) en el mensaje de la petición que se pueden rellenar al llamar a la petición. + Elija un modelo con el que invocar la petición o, si piensa utilizar la petición con un agente, déjelo sin especificar. Si elige un modelo, también puede modificar las configuraciones de inferencia que se van a utilizar. Para ver los parámetros de inferencia de los diferentes modelos, consulte [Parámetros de solicitud de inferencia y campos de respuesta para los modelos fundacionales](model-parameters.md). Todas las peticiones admiten los siguientes parámetros de inferencia básicos: + **maxTokens**: cantidad máxima de tokens que se permiten en la respuesta generada. + **stopSequences**: lista de secuencias de detención. Una secuencia de detención es una secuencia de caracteres que hace que el modelo deje de generar la respuesta. + **temperature**: probabilidad de que el modelo seleccione las opciones más viables al generar una respuesta. + **topP**: porcentaje de candidatos más probables que el modelo considera para el siguiente token. Si un modelo admite parámetros de inferencia adicionales, puede especificarlos como *campos adicionales* para la petición. Los campos adicionales se proporcionan en un objeto JSON. El ejemplo siguiente muestra cómo configurar `top_k`, que está disponible en los modelos Anthropic Claude, pero no es un parámetro de inferencia básico. ``` { "top_k": 200 } ``` Para obtener información sobre los parámetros de inferencia de modelos, consulte [Parámetros de solicitud de inferencia y campos de respuesta para modelos fundacionales](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html). El establecimiento de un parámetro de inferencia básico como campo adicional no invalida el valor establecido en la consola. Si el modelo que ha elegido para la petición es compatible con la API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) (para obtener más información, consulte [Cómo mantener una conversación con las operaciones de la API Converse](conversation-inference.md)), puede incluir lo siguiente al crear la petición: + Una petición del sistema para proporcionar instrucciones o contexto al modelo. + Las peticiones anteriores (mensajes de usuario) y las respuestas del modelo (mensajes del asistente) como historial de conversación para que el modelo las tenga en cuenta al generar una respuesta para el mensaje final del usuario. + (Si el modelo lo admite) [Herramientas](tool-use.md) para que el modelo las utilice al generar la respuesta. + (Si el modelo lo admite) Utilice el [almacenamiento en caché de peticiones](prompt-caching.md) para reducir los costos mediante el almacenamiento en caché de peticiones grandes o de uso frecuente. Según el modelo, puede almacenar en caché las instrucciones del sistema, las herramientas y los mensajes (del usuario y del asistente). El almacenamiento en caché de peticiones crea un punto de control de caché para la petición si el prefijo total de la petición cumple con el número mínimo de tokens que requiere el modelo. Cuando se encuentra una variable modificada en una petición, el almacenamiento en caché de peticiones crea un nuevo punto de control de caché (si el número de tokens de entrada alcanza el mínimo que requiere el modelo). Para saber cómo crear una petición con Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Para crear un aviso** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija **Crear petición**. 1. Proporcione un nombre y una descripción opcional para la petición. 1. Para cifrar su petición con una clave administrada por el cliente, seleccione **Personalizar configuración de cifrado (avanzada)** en la sección **Selección de claves de KMS**. Si omite este campo, su petición se cifrará con una Clave administrada de AWS. Para obtener más información, consulte [Claves de AWS KMS](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html). 1. Elija **Crear petición**. Se crea la petición y se le redirigirá al **generador de peticiones** de la petición que se acaba de crear, donde podrá configurarla. 1. Puede continuar con el siguiente procedimiento para configurar la petición o volver al generador de peticiones más adelante. **Configuración de la petición** 1. Si aún no se encuentra en el generador de peticiones, haga lo siguiente: 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. En la sección **Borrador de la petición**, seleccione **Editar en el generador de peticiones**. 1. Utilice el panel **Petición** para crear la petición. Introduzca la petición en el último cuadro **Mensaje del usuario**. Si el modelo es compatible con la API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) o la [API Messages de AnthropicClaude](model-parameters-anthropic-claude-messages.md), también puede incluir una **petición del sistema** y **mensajes del usuario** y **mensajes del asistente** anteriores como contexto. Cuando escribe una petición, puede incluir las variables entre corchetes dobles (como en *\$1\$1variable\$1\$1*). Cada variable que incluya aparecerá en la sección **Variables de prueba**. 1. (Opcional) Puede modificar la petición de las siguientes maneras: + En la ventana **Configuraciones**, realice lo siguiente: 1. Elija un **recurso de IA generativa** para ejecutar la inferencia. **nota** Si elige un agente, solo podrá probar la petición en la consola. Para aprender a probar una petición con un agente en la API, consulte [Prueba de una petición con la administración de peticiones](prompt-management-test.md). 1. En **Parámetros de inferencia**, defina los parámetros de inferencia que desee utilizar. 1. Si el modelo admite el [razonamiento](inference-reasoning.md), active **Razonamiento** para incluir el razonamiento del modelo en su respuesta. En **Tokens de razonamiento**, puede configurar el número de tokens de razonamiento que puede utilizar el modelo. 1. En **Campos de solicitud de modelos adicionales**, elija **Configurar** para especificar parámetros de inferencia adicionales, además de los que se indican en **Parámetros de inferencia.** 1. Si el modelo que ha elegido admite herramientas, elija **Configurar herramientas** para utilizar herramientas con la petición. 1. Si el modelo que ha elegido admite el [almacenamiento en caché de peticiones](prompt-caching.md), elija una de las siguientes opciones (la disponibilidad varía según el modelo): + **Ninguno**: no se realiza ningún almacenamiento en caché de peticiones. + **Herramientas**: solo se almacenan en caché las herramientas de la petición. + **Herramientas, instrucciones del sistema:** las herramientas e instrucciones del sistema de la petición se almacenan en caché. + **Herramientas, instrucciones del sistema**: las herramientas, las instrucciones del sistema y los mensajes (del usuario y el asistente) de la petición se almacenan en caché. + Para comparar diferentes variantes de la petición, elija **Comparar variantes**. En la página de comparación, puede hacer lo siguiente: + Para añadir una variante, seleccione el signo de más. Puede agregar hasta tres variantes. + Tras especificar los detalles de una variante, puede especificar cualquier **Variable de prueba** y elegir **Ejecutar** para probar el resultado de la variante. + Para eliminar una variante, elija los tres puntos y seleccione **Eliminar de la comparación**. + Para reemplazar el borrador de trabajo y salir del modo de comparación, seleccione **Guardar como borrador**. Se eliminarán todas las demás variantes. + Para salir del modo de comparación, seleccione **Salir del modo de comparación**. 1. Al terminar de configurar la petición, aparecerán las siguientes opciones: + Para guardar la petición, seleccione **Guardar borrador**. Para obtener más información acerca de la versión de borrador, consulte [Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones](prompt-management-deploy.md). + Para eliminar la petición, seleccione **Eliminar**. Para obtener más información, consulte [Eliminación de una petición en la administración de peticiones](prompt-management-delete.md). + Para crear una versión de la petición, seleccione **Crear versión**. Para obtener más información sobre el control de versiones de las peticiones, consulte [Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones](prompt-management-deploy.md). ------ #### [ API ] Para crear una petición, envíe una solicitud [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Los siguientes campos son obligatorios: **** | Campo | Descripción breve | | --- | --- | | nombre | Nombre de la petición | | variants | Lista de las diferentes configuraciones de la petición (véase más abajo) | | defaultVariant | Nombre predeterminado de la variante | Cada variante de la lista `variants` es un objeto [PromptVariant](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptVariant.html) con la siguiente estructura general: ``` { "name": "string", # modelId or genAiResource (see below) "templateType": "TEXT", "templateConfiguration": # see below, "inferenceConfiguration": { "text": { "maxTokens": int, "stopSequences": ["string", ...], "temperature": float, "topP": float } }, "additionalModelRequestFields": { "key": "value", ... }, "metadata": [ { "key": "string", "value": "string" }, ... ] } ``` Rellene los campos de la siguiente manera: + name: introduzca un nombre para la variante. + Incluya uno de estos campos, según el recurso de invocación del modelo que utilice: + modelId: para especificar un [modelo fundacional](models-supported.md) o un [perfil de inferencia](cross-region-inference.md) para usarlo con la petición, introduzca su ARN o ID. + genAiResource: para especificar un [agente](agents.md), introduzca su ID o ARN. La entrada de `genAiResource` es un objeto JSON con el siguiente formato: ``` { "genAiResource": { "agent": { "agentIdentifier": "string" } } ``` **nota** Si incluye el campo `genAiResource`, solo podrá probar la petición en la consola. Para probar una petición con un agente en la API, debe introducir el texto de la petición directamente en el campo `inputText` de la solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html). + templateType: introduzca `TEXT` o `CHAT`. `CHAT` solo es compatible con los modelos que admiten la API [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html). Si quiere utilizar el almacenamiento en caché de peticiones, debe utilizar el tipo de plantilla `CHAT`. + templateConfiguration: el valor depende del tipo de plantilla que haya especificado: + Si especificó `TEXT` como tipo de plantilla, el valor debe ser un objeto JSON [TextPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TextPromptTemplateConfiguration.html.html). + Si especificó `CHAT` como tipo de plantilla, el valor debe ser un objeto JSON [ChatPromptTemplateConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ChatPromptTemplateConfiguration.html.html). + inferenceConfiguration: el campo `text` se asigna a una [PromptModelInferenceConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_PromptModelInferenceConfiguration.html.html) Este campo contiene parámetros de inferencia que son comunes a todos los modelos. Para obtener más información sobre los parámetros de inferencia, consulte [Influencia sobre la generación de respuestas con parámetros de inferencia](inference-parameters.md). + additionalModelRequestFields: se utiliza para especificar los parámetros de inferencia que son específicos del modelo con el que se ejecuta la inferencia. Para obtener más información sobre los parámetros de inferencia específicos de un modelo, consulte [Parámetros de solicitud de inferencia y campos de respuesta para los modelos fundacionales](model-parameters.md). + metadata: metadatos que se van a asociar a la variante de la petición. Puede añadir pares clave-valor a la matriz para etiquetar la variante de petición con metadatos. Los siguientes campos son opcionales: **** | Campo | Caso de uso | | --- | --- | | description | Para proporcionar una descripción de la petición. | | clientToken | Para garantizar que la solicitud de la API se complete solo una vez. Para obtener más información, consulte [Ensuring idempotency](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html). | | etiquetas | Para asociar etiquetas con el flujo. Para obtener más información, consulte [Etiquetado de los recursos de Amazon Bedrock](tagging.md). | La respuesta crea una versión `DRAFT` y devuelve un ID y un ARN que puede usar como identificador de la petición para otras solicitudes de la API relacionadas con la petición. ------ # Visualización de información sobre las peticiones mediante la administración de solicitudes Para saber cómo puede ver la información de las peticiones con Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Visualización de información sobre una petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. La página **Detalles de la petición** incluye las siguientes secciones: + **Información general**: contiene información general sobre la petición y cuándo se creó y se actualizó por última vez. + **Borrador de la petición**: contiene el mensaje de la petición y las configuraciones de la última versión de borrador guardada de la solicitud. + **Versiones de la petición**: lista de todas las versiones de la petición que se han creado. Para obtener más información sobre las versiones de la petición, consulte [Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones](prompt-management-deploy.md). ------ #### [ API ] Para obtener información sobre una petición, envíe una solicitud [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique el ARN o el ID de la petición como `promptIdentifier`. Para obtener más información sobre una versión específica de la petición, indique `DRAFT` o el número de versión en el campo `promptVersion`. Para mostrar la información sobre los agentes, envíe una solicitud [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Puede especificar los siguientes parámetros opcionales: **** | Campo | Descripción breve | | --- | --- | | maxResults | El número máximo de resultados que se devuelven en una respuesta. | | nextToken | Si hay más resultados que el número que ha especificado en el campo maxResults, la respuesta devolverá un valor nextToken. Para ver el siguiente lote de resultados, envíe el valor nextToken en otra solicitud. | ------ # Modificación de una petición con la administración de peticiones Para saber cómo modificar peticiones con Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Modificación de una petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. Para editar el **nombre** o la **descripción** de la petición, seleccione **Editar** en la sección **Información general**. Después de realizar las modificaciones, seleccione **Guardar**. 1. Para modificar la petición y sus configuraciones, elija **Editar en el generador de peticiones**. 1. Para obtener más información sobre las partes de la petición que puede modificar, consulte [Creación de una petición con la administración de peticiones](prompt-management-create.md). ------ #### [ API ] Para modificar una petición, envíe una solicitud [UpdatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdatePrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluya tanto los campos que quiere mantener como los campos que quiere modificar. ------ # Prueba de una petición con la administración de peticiones Para aprender a probar una petición con Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Cómo probar una petición con Administración de peticiones** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. Seleccione **Editar en el generador de peticiones** en la sección **Borrador de petición** o elija una versión de la petición en la sección **Versiones**. 1. (Opcional) Para proporcionar valores para las variables en la petición, primero debe seleccionar un modelo en el panel **Configuraciones**. A continuación, introduzca un **Valor de prueba** para cada variable en el panel **Variables de prueba**. **nota** Estos valores de prueba son temporales y no se guardan si guarda la petición. 1. Para probar la petición, seleccione **Ejecutar** en el panel **Ventana de prueba**. 1. Modifique la petición o sus configuraciones y, a continuación, vuelva a ejecutar la petición según sea necesario. Si está satisfecho con el mensaje, puede elegir **Crear versión** para crear una instantánea de la petición que se pueda utilizar en producción. Para obtener más información, consulte [Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones](prompt-management-deploy.md). Puede configurar la petición de las siguientes maneras: + Para probar la petición en un flujo, incluya un nodo de petición en el flujo. Para obtener más información, consulte [Creación y diseño de un flujo en Amazon Bedrock](flows-create.md) y [Tipos de nodos para el flujo](flows-nodes.md). + Si no configuró su petición con un agente, puede probar la petición con un agente importándola cuando pruebe un agente. Para obtener más información, consulte [Prueba y solución de problemas de comportamiento del agente](agents-test.md). ------ #### [ API ] Puede probar la petición de las siguientes maneras: + Para ejecutar la inferencia en la petición, envíe una solicitud [InvokeModel](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModel.html), [InvokeModelWithResponseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_InvokeModelWithResponseStream.html), [Converse](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html) o [ConverseStream](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ConverseStream.html) con un [punto de conexión en tiempo de ejecución de Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#br-rt) y especifique el ARN de la petición en el parámetro `modelId`. **nota** Se aplican las siguientes restricciones cuando se utiliza una petición de Administración de peticiones con `Converse` o `ConverseStream`: No puede incluir los campos `additionalModelRequestFields`, `inferenceConfig`, `system` ni `toolConfig`. Si incluye el campo `messages`, los mensajes se anexan después de los mensajes definidos en la petición. Si incluye el campo `guardrailConfig`, la barrera de protección se aplica a toda la petición. Si incluye bloques `guardContent` en el campo [ContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ContentBlock.html), la barrera de protección solo se aplicará a esos bloques. + Para probar la petición en un flujo, cree o edite un flujo enviando una solicitud [CreateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateFlow.html) o [UpdateFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateFlow.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt). Incluya un SDK para JavaScript en Node.js del tipo `PromptNode` e incluya el ARN de la petición en el campo `promptArn`. A continuación, envíe una solicitud [InvokeFlow](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeFlow.html) con un [punto de conexión en tiempo de ejecución de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Para obtener más información, consulte [Creación y diseño de un flujo en Amazon Bedrock](flows-create.md) y [Tipos de nodos para el flujo](flows-nodes.md). + Para probar su petición con un agente, utilice la consola Amazon Bedrock (consulte la pestaña **Consola**) o introduzca el texto de la petición en el campo `inputText` de una solicitud [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html). ------ # Optimización de una petición Amazon Bedrock ofrece una herramienta para optimizar las peticiones. La optimización reescribe las peticiones para obtener resultados de inferencia más adecuados para su caso de uso. Puede elegir el modelo para el que desea optimizar la petición y, a continuación, generar una petición revisada. Tras enviar una petición para optimizarla, Amazon Bedrock analiza los componentes de la petición. Si el análisis se realiza correctamente, reescribe la petición. A continuación, puede copiar y utilizar el texto de la petición optimizada. **nota** Para obtener los mejores resultados, se recomienda optimizar las peticiones en inglés. **Topics** + [Regiones y modelos que admiten la optimización de peticiones](#prompt-management-optimize-supported) + [Envío de una petición para optimización](#prompt-management-optimize-submit) ## Regiones y modelos que admiten la optimización de peticiones En la siguiente tabla se muestra el soporte del modelo para una rápida optimización: | Proveedor | Modelo | ID del modelo | Compatibilidad con modelos de una sola región | | --- | --- | --- | --- | | Amazon | Nova Lite | amazon. nova-lite-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Amazon | Nova Micro | amazon. nova-micro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Amazon | Nova Premier | amazon. nova-premier-v1:0 | | | Amazon | Nova Pro | amazon. nova-pro-v1:0 | ap-southeast-2 eu-west-2 us-east-1 | | Anthropic | Claude 3 Haiku | anthropic.claude-3-haiku-20240307-v1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Anthropic | Claude 3 Opus | anthropic.claude-3-opus-20240229-v 1:0 | | | Anthropic | Claude 3 Sonnet | anthropic.claude-3-sonnet-20240229-v1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Anthropic | Claude 3.5 Haiku | anthropic.claude-3-5-haiku-20241022-v1:0 | us-west-2 | | Anthropic | Claude 3.5 Sonnet | anthropic.claude-3-5-sonnet-20240620-v1:0 | eu-central-1 us-east-1 us-west-2 | | Anthropic | Claude 3.5 Sonnet v2 | anthropic.claude-3-5-sonnet-20241022-v2:0 | ap-southeast-2 us-west-2 | | Anthropic | Claude 3.7 Sonnet | anthropic.claude-3-7-sonnet-20250219-v 1:0 | eu-west-2 | | Anthropic | Claude Opus 4 | anthropic.claude-opus-4-20250514-v1:0 | | | Anthropic | Claude Sonnet 4 | anthropic.claude-sonnet-4-20250514-v1:0 | | | DeepSeek | DeepSeek-R1 | deepseek.r1-v1:0 | | | Meta | Llama 3 70B Instruct | meta.llama3-70 1:0 b-instruct-v | ap-south-1 ca-central-1 eu-west-2 us-east-1 us-west-2 | | Meta | Llama 3.1 70B Instruct | meta.llama3-1-70 1:0 b-instruct-v | us-west-2 | | Meta | Llama 3.2 11B Instruct | metal.llama 3-2-11 1:0 b-instruct-v | | | Meta | Llama 3.3 70B Instruct | metal.llama 3-3-70 1:0 b-instruct-v | | | Meta | Llama 4 Maverick 17B Instruct | meta.llama4-maverick-17 1:0 b-instruct-v | | | Meta | Llama 4 Scout 17B Instruct | b-instruct-vmeta.llama4-scout-17 1:0 | | | Mistral AI | Mistral Large (24.02) | mistral.mistral-large-2402-v1:0 | ap-south-1 ap-southeast-2 ca-central-1 eu-west-1 eu-west-2 eu-west-3 sa-east-1 us-east-1 us-west-2 | | Mistral AI | Mistral Large (24.07) | mistral.mistral-large-2407-v1:0 | us-west-2 | ## Envío de una petición para optimización Para obtener información sobre cómo optimizar una petición, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] Puede optimizar una petición mediante el uso de un entorno de pruebas o Administración de peticiones en la Consola de administración de AWS. Debe seleccionar un modelo para poder optimizar una petición. La petición se optimiza para el modelo que elija. **Cómo optimizar una petición en un entorno de pruebas** 1. Para aprender a escribir una petición en el entorno de pruebas de Amazon Bedrock, siga los pasos que se indican en [Generación de respuestas en la consola mediante áreas de juego](playgrounds.md). 1. Después de escribir una petición y seleccionar un modelo, elige el icono de varita (![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/wand.png)). Se abre el cuadro de diálogo **Optimizar petición** y Amazon Bedrock comienza a optimizar la petición. 1. Cuando Amazon Bedrock termine de analizar y optimizar la petición, podrá comparar la petición original con la petición optimizada en el cuadro de diálogo. 1. Para reemplazar su petición por la petición optimizada en el entorno de pruebas, elija **Usar petición optimizada**. Para conservar la petición original, seleccione **Cancelar**. 1. Para enviar la petición y generar una respuesta, seleccione **Ejecutar**. **Cómo optimizar una petición en Administración de peticiones** 1. Para aprender a escribir una petición con Administración de peticiones, siga los pasos que se indican en [Creación de una petición con la administración de peticiones](prompt-management-create.md). 1. Después de escribir una petición y seleccionar un modelo, elija **(![\[Sparkle icon representing cleaning or refreshing functionality.\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/images/icons/wand.png)) Optimizar** en la parte superior del cuadro **Petición**. 1. Cuando Amazon Bedrock termine de analizar y optimizar la petición, la petición optimizada se muestra como una variante junto a la petición original. 1. Para usar la petición optimizada en lugar de la original, seleccione **Reemplazar petición original**. Para conservar la petición original, seleccione **Salir de la comparación** y seleccione la opción para guardar la petición original. **nota** Si tiene tres peticiones en la vista de comparación e intenta optimizar otra, se le pedirá que anule y sustituya la petición original o una de las variantes. 1. Para enviar la petición y generar una respuesta, seleccione **Ejecutar**. ------ #### [ API ] Para optimizar una solicitud, envíe una [OptimizePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizePrompt.html)solicitud con un [punto de ejecución de Agents for Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). Proporcione la petición que desea optimizar en el objeto `input` y especifique el modelo para el que desea optimizarla en el campo `targetModelId`. El flujo de respuesta devuelve la siguiente estructura: 1. [analyzePromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_AnalyzePromptEvent.html)— Aparece cuando se termina de analizar el mensaje. Contiene un mensaje que describe el análisis de la petición. 1. [optimizedPromptEvent](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OptimizedPromptEvent.html)— Aparece cuando el mensaje ha terminado de reescribirse. Contiene la petición optimizada. Ejecute el siguiente ejemplo de código para optimizar una petición: ``` import boto3 # Set values here TARGET_MODEL_ID = "anthropic.claude-3-sonnet-20240229-v1:0" # Model to optimize for. For model IDs, see https://docs.aws.amazon.com/bedrock/latest/userguide/model-ids.html PROMPT = "Please summarize this text: " # Prompt to optimize def get_input(prompt): return { "textPrompt": { "text": prompt } } def handle_response_stream(response): try: event_stream = response['optimizedPrompt'] for event in event_stream: if 'optimizedPromptEvent' in event: print("========================== OPTIMIZED PROMPT ======================\n") optimized_prompt = event['optimizedPromptEvent'] print(optimized_prompt) else: print("========================= ANALYZE PROMPT =======================\n") analyze_prompt = event['analyzePromptEvent'] print(analyze_prompt) except Exception as e: raise e if __name__ == '__main__': client = boto3.client('bedrock-agent-runtime') try: response = client.optimize_prompt( input=get_input(PROMPT), targetModelId=TARGET_MODEL_ID ) print("Request ID:", response.get("ResponseMetadata").get("RequestId")) print("========================== INPUT PROMPT ======================\n") print(PROMPT) handle_response_stream(response) except Exception as e: raise e ``` ------ # Implementación de una petición en la aplicación mediante las versiones en la administración de peticiones Al guardar la petición, se crea una *versión de borrador* de la misma. Para seguir iterando la versión de borrador, modifique la petición y sus configuraciones y guárdela. Cuando quiera implementar una petición en producción, cree una versión de la misma para usarla en la aplicación. Una versión es una instantánea de la petición que se crea en un momento en el que está iterando el borrador de trabajo de la petición. Cuando considere que el conjunto de configuraciones es adecuado, empiece a crear versiones de la petición. Las versiones le permiten cambiar fácilmente entre diferentes configuraciones de la petición y actualizar la aplicación con la versión más adecuada según el caso de uso. **Topics** + [Creación de una versión de una petición en la administración de peticiones](prompt-management-version-create.md) + [Visualización de información sobre las versiones de una petición en la administración de peticiones](prompt-management-version-view.md) + [Comparación de versiones de una petición en Administración de peticiones](prompt-management-version-compare.md) + [Eliminación de una versión de una petición en la administración de peticiones](prompt-management-version-delete.md) # Creación de una versión de una petición en la administración de peticiones Para obtener información sobre cómo crear una versión de una petición, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] Si utiliza el generador de peticiones, puede crear una versión de la petición seleccionando **Crear versión**. De lo contrario, realice lo siguiente: **Creación de una versión de la petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. En la sección **Versiones de la petición**, seleccione **Crear versión** para tomar una instantánea del borrador de la versión. ------ #### [ API ] Para crear una versión de una petición, envíe una solicitud [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique el ARN o el ID de la petición como `promptIdentifier`. La respuesta devuelve un ID y un ARN para la versión. Las versiones se crean de forma incremental, empezando por 1. ------ # Visualización de información sobre las versiones de una petición en la administración de peticiones Para aprender a ver información de una versión de una petición, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Visualización de información sobre una versión de la petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. En **Versiones de la petición**, seleccione una versión. 1. En la página **Detalles de la versión**, puede ver información sobre la versión, el mensaje de la petición y sus configuraciones. Para obtener más información acerca de las pruebas de una versión de la petición, consulte [Prueba de una petición con la administración de peticiones](prompt-management-test.md). ------ #### [ API ] Para obtener información sobre una versión de una petición, envíe una solicitud [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique el ARN o el ID de la petición como `promptIdentifier`. En el campo `promptVersion`, especifique el número de versión. ------ # Comparación de versiones de una petición en Administración de peticiones La consola de Amazon Bedrock ofrece una herramienta que le permite comparar versiones de una petición que haya creado en Administración de peticiones. La herramienta resalta los campos que existen en una versión y que no existen en la otra. **Cómo comparar versiones de peticiones** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. En la sección **Versiones**, seleccione las casillas de verificación situadas junto a las dos peticiones que desea comparar. 1. Elija **Compare**. 1. Los objetos JSON que definen cada versión de la petición se muestran uno al lado del otro. Las diferencias entre las versiones se muestran a continuación: + Los campos que existen en una versión, pero que no existen en la otra, se marcan con un signo más (\$1) y se resaltan en verde. + Los campos que no existen en una versión, pero sí existen en la otra, se marcan con un signo menos (-) y se resaltan en rojo. 1. Para comparar las respuestas del modelo de salida de las distintas versiones, rellene las **variables de prueba** y seleccione **Ejecutar petición**. # Eliminación de una versión de una petición en la administración de peticiones Para obtener información sobre cómo eliminar una versión de una petición, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] **Eliminación de una versión de la petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. A continuación, elija una petición en la sección **Peticiones**. 1. En la sección **Versiones de la petición**, seleccione una versión y elija **Eliminar**. 1. En la página **Detalles de la versión**, puede ver información sobre la versión, el mensaje de la petición y sus configuraciones. Para obtener más información acerca de las pruebas de una versión de la petición, consulte [Prueba de una petición con la administración de peticiones](prompt-management-test.md). 1. Revise la advertencia que aparece, escriba **confirmar** y, a continuación, seleccione **Eliminar**. ------ #### [ API ] Para eliminar una versión de una petición, envíe una solicitud [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique el ARN o el ID de la petición como `promptIdentifier`. En el campo `promptVersion`, especifique el número de versión a borrar. ------ # Eliminación de una petición en la administración de peticiones Si ya no necesita una petición, puede eliminarla. Las peticiones que elimine se conservan en los servidores de AWS durante un máximo de catorce días. Para saber cómo eliminar una petición con Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: ------ #### [ Console ] Si está en la página **Detalles de la petición** de una petición o en el generador de peticiones, seleccione **Eliminar** para eliminar una petición. **nota** Si elimina una petición, se eliminarán todas sus versiones. Es posible que cualquier recurso que utilice la petición experimente errores de tiempo de ejecución. Recuerde desasociar la petición de cualquier recurso que la utilice. **Eliminación de una petición** 1. Inicie sesión en la Consola de administración de AWS con una identidad de IAM que tenga permisos para usar la consola de 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 **Administración de peticiones**. 1. Seleccione una petición y elija **Eliminar**. 1. Revise la advertencia que aparece, escriba **confirmar** y, a continuación, seleccione **Eliminar**. ------ #### [ API ] Para eliminar una petición, envíe una solicitud [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) con un [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt) y especifique el ARN o el ID de la petición como `promptIdentifier`. Para eliminar una versión específica de la petición, indique el número de versión en el campo `promptVersion`. ------ # Ejecución de ejemplos de código de administración de peticiones Para probar algunos ejemplos de código de Administración de peticiones, seleccione la pestaña correspondiente al método que prefiera y siga los pasos: en los siguientes ejemplos de código se parte de la base de que ha configurado las credenciales para usar la API de AWS. Si no lo ha hecho, consulte [Introducción a la API](getting-started-api.md). ------ #### [ Python ] 1. Ejecute el siguiente fragmento de código para cargar el AWS SDK para Python (Boto3), cree un cliente y una petición que genere una lista de reproducción de música con dos variables (`genre` y `number`) con una solicitud [CreatePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePrompt.html) de [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Create a prompt in Prompt management import boto3 # Create an Amazon Bedrock Agents client client = boto3.client(service_name="bedrock-agent") # Create the prompt response = client.create_prompt( name="MakePlaylist", description="My first prompt.", variants=[ { "name": "Variant1", "modelId": "amazon.titan-text-express-v1", "templateType": "TEXT", "inferenceConfiguration": { "text": { "temperature": 0.8 } }, "templateConfiguration": { "text": { "text": "Make me a {{genre}} playlist consisting of the following number of songs: {{number}}." } } } ] ) prompt_id = response.get("id") ``` 1. Ejecute el siguiente fragmento de código para ver la petición que acaba de crear (junto con cualquier otra petición de su cuenta) para realizar una solicitud [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) al [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # List prompts that you've created client.list_prompts() ``` 1. Debería ver el ID de la petición que ha creado en el campo `id` del objeto en el campo `promptSummaries`. Ejecute el siguiente fragmento de código para mostrar la información de la solicitud que ha creado al realizar una solicitud [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) del [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Get information about the prompt that you created client.get_prompt(promptIdentifier=prompt_id) ``` 1. Cree una versión de la petición y obtenga su ID ejecutando el siguiente fragmento de código para realizar una solicitud [CreatePromptVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreatePromptVersion.html) de [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Create a version of the prompt that you created response = client.create_prompt_version(promptIdentifier=prompt_id) prompt_version = response.get("version") prompt_version_arn = response.get("arn") ``` 1. Para ver la información sobre la versión de la petición que acaba de crear, junto con la información sobre la versión de borrador, ejecute el siguiente fragmento de código para crear una solicitud [ListPrompts](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListPrompts.html) de [punto de conexión en tiempo de compilación para Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # List versions of the prompt that you just created client.list_prompts(promptIdentifier=prompt_id) ``` 1. Para ver la información de la versión de la petición que acaba de crear, ejecute el siguiente fragmento de código para realizar una solicitud [GetPrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetPrompt.html) del [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Get information about the prompt version that you created client.get_prompt( promptIdentifier=prompt_id, promptVersion=prompt_version ) ``` 1. Para probar la petición, añádala a un flujo siguiendo los pasos que se indican en [Ejecución de ejemplos de código de Flujos de Amazon Bedrock](flows-code-ex.md). En el primer paso al crear el flujo, ejecute el siguiente fragmento de código para utilizar la petición que ha creado en lugar de definir una petición en línea en el flujo (sustituya el ARN de la versión de la petición en el campo `promptARN` por el ARN de la versión de la petición que ha creado): ``` # Import Python SDK and create client import boto3 client = boto3.client(service_name='bedrock-agent') FLOWS_SERVICE_ROLE = "arn:aws:iam::123456789012:role/MyPromptFlowsRole" # Flows service role that you created. For more information, see https://docs.aws.amazon.com/bedrock/latest/userguide/flows-permissions.html PROMPT_ARN = prompt_version_arn # ARN of the prompt that you created, retrieved programatically during creation. # Define each node # The input node validates that the content of the InvokeFlow request is a JSON object. input_node = { "type": "Input", "name": "FlowInput", "outputs": [ { "name": "document", "type": "Object" } ] } # This prompt node contains a prompt that you defined in Prompt management. # It validates that the input is a JSON object that minimally contains the fields "genre" and "number", which it will map to the prompt variables. # The output must be named "modelCompletion" and be of the type "String". prompt_node = { "type": "Prompt", "name": "MakePlaylist", "configuration": { "prompt": { "sourceConfiguration": { "resource": { "promptArn": "" } } } }, "inputs": [ { "name": "genre", "type": "String", "expression": "$.data.genre" }, { "name": "number", "type": "Number", "expression": "$.data.number" } ], "outputs": [ { "name": "modelCompletion", "type": "String" } ] } # The output node validates that the output from the last node is a string and returns it as is. The name must be "document". output_node = { "type": "Output", "name": "FlowOutput", "inputs": [ { "name": "document", "type": "String", "expression": "$.data" } ] } # Create connections between the nodes connections = [] # First, create connections between the output of the flow input node and each input of the prompt node for input in prompt_node["inputs"]: connections.append( { "name": "_".join([input_node["name"], prompt_node["name"], input["name"]]), "source": input_node["name"], "target": prompt_node["name"], "type": "Data", "configuration": { "data": { "sourceOutput": input_node["outputs"][0]["name"], "targetInput": input["name"] } } } ) # Then, create a connection between the output of the prompt node and the input of the flow output node connections.append( { "name": "_".join([prompt_node["name"], output_node["name"]]), "source": prompt_node["name"], "target": output_node["name"], "type": "Data", "configuration": { "data": { "sourceOutput": prompt_node["outputs"][0]["name"], "targetInput": output_node["inputs"][0]["name"] } } } ) # Create the flow from the nodes and connections client.create_flow( name="FlowCreatePlaylist", description="A flow that creates a playlist given a genre and number of songs to include in the playlist.", executionRoleArn=FLOWS_SERVICE_ROLE, definition={ "nodes": [input_node, prompt_node, output_node], "connections": connections } ) ``` 1. Para eliminar la versión de la petición que acaba de crear, ejecute el siguiente fragmento de código para realizar una solicitud [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) del [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Delete the prompt version that you created client.delete_prompt( promptIdentifier=prompt_id, promptVersion=prompt_version ) ``` 1. Para eliminar por completo la petición que acaba de crear, ejecute el siguiente fragmento de código para realizar una solicitud [DeletePrompt](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeletePrompt.html) al [punto de conexión en tiempo de compilación de Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt): ``` # Delete the prompt that you created client.delete_prompt( promptIdentifier=prompt_id ) ``` ------