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.
# Implementación de un agente
Al crear un agente de Amazon Bedrock por primera vez, tiene una versión de borrador de trabajo (`DRAFT`) y un alias de prueba (`TSTALIASID`) que apunta hacia la versión de borrador de trabajo. Al realizar cambios en su agente, los cambios se aplican al borrador de trabajo. Itere el borrador de trabajo hasta que apruebe el comportamiento del agente. A continuación, podrá configurar el agente para implementarlo e integrarlo en su aplicación creando los *alias* del agente.
**Alias y versiones**
Para implementar el agente, debe crear un *alias*. Durante la creación del alias, Amazon Bedrock crea automáticamente una versión de su agente. El alias apunta a esta versión recién creada. Como alternativa, puede dirigir el alias hacia una versión del agente creada anteriormente. A continuación, configure su aplicación para realizar llamadas a la API a ese alias.
Una *versión* es una instantánea que conserva el recurso tal como estaba en el momento de su creación. Puede seguir modificando el borrador de trabajo y crear nuevos alias (y, en consecuencia, versiones) de su agente según sea necesario. En Amazon Bedrock, puede crear una nueva versión de su agente mediante la creación de un alias que apunte a la nueva versión de forma predeterminada. Amazon Bedrock crea las versiones en orden numérico, empezando por 1.
Las versiones son inmutables porque actúan como una instantánea de su agente en el momento en que las creó. Para realizar actualizaciones en un agente en producción, debe crear una nueva versión y configurar la aplicación para que realice llamadas al alias que apunten hacia esa versión.
Los alias le permiten cambiar de forma eficiente entre distintas versiones de su agente sin que la aplicación tenga que realizar un seguimiento de la versión. Por ejemplo, puede cambiar un alias para que apunte hacia una versión anterior del agente si hay cambios que necesita revertir rápidamente.
## Puesta en pausa de un agente implementado
Es posible que necesite pausar temporalmente el funcionamiento de un agente. Esto puede ocurrir, por ejemplo, durante el mantenimiento, las actualizaciones o cuando se abordan problemas de rendimiento. Para pausar un agente, utilice el alias del agente con la operación [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html). Para pausar un agente, establezca el campo `aliasInvocationState` en `REJECT_INVOCATIONS`. Para iniciar de nuevo la ejecución del agente, establezca `aliasInvocationState` en `ACCEPT_INVOCATIONS`. No necesita realizar ninguna modificación en la política de IAM para pausar el agente.
Para comprobar si un agente está actualmente en pausa, llame a [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) y compruebe el campo `aliasInvocationState`. También puede comprobar si el campo `aliasInvocationState` contiene un alias en la respuesta de [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html).
**Topics**
+ [Puesta en pausa de un agente implementado](#agent-pause)
+ [Creación de un alias de agente](deploy-agent-proc.md)
+ [Visualización de información sobre las versiones de los agentes en Amazon Bedrock](agents-version-view.md)
+ [Eliminación de una versión de un agente en Amazon Bedrock](agents-version-delete.md)
+ [Ver información sobre los alias de los agentes en Amazon Bedrock](agents-alias-view.md)
+ [Edición de un alias de un agente de Amazon Bedrock](agents-alias-edit.md)
+ [Eliminación de un alias de un agente de Amazon Bedrock](agents-alias-delete.md)
# Creación de un alias de agente
En el siguiente procedimiento se muestra cómo crear un alias y una versión para el agente. Tras crear un alias, puede usar el agente en su aplicación realizando 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) a 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 crear un alias**
+ Cree un alias y una versión de su agente. Elija la pestaña del método que prefiera y siga estos pasos:
------
#### [ Console ]
**Creación de un alias (y, si lo desea, una nueva versió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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. En la sección **Alias**, elija **Crear**.
1. Introduzca un **Nombre de alias** exclusivo y proporcione una **Descripción** opcional.
1. En **Asociar una versión**, elija una de las siguientes opciones:
+ Para crear una nueva versión, elija **Crear una nueva versión y asociarla a este alias**.
+ Para usar una versión existente, elija **Usar una versión existente para asociar este alias**. En el menú desplegable, elija la versión a la que desea asociar el alias.
1. En **Seleccionar rendimiento**, seleccione una de las siguientes opciones:
+ Para permitir que su agente ejecute la inferencia de modelos al ritmo establecido para su cuenta, seleccione **Bajo demanda (ODT)**. Para obtener más información, consulte [Cuotas para Amazon Bedrock](quotas.md).
+ Para permitir que su agente ejecute la inferencia de modelos a un ritmo mayor con un rendimiento aprovisionado que haya adquirido previamente para el modelo, seleccione **Rendimiento aprovisionado (PT)** y, a continuación, seleccione un modelo aprovisionado. Para obtener más información, consulte [Aumento de la capacidad de invocación de modelos con el rendimiento aprovisionado en Amazon Bedrock](prov-throughput.md).
1. Seleccione **Crear alias**.
------
#### [ API ]
Para crear alias para un agente, envíe una solicitud [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.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:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/deploy-agent-proc.html)
Los siguientes campos son opcionales:
****
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/bedrock/latest/userguide/deploy-agent-proc.html)
```
def create_agent_alias(self, name, agent_id):
"""
Creates an alias of an agent that can be used to deploy the agent.
:param name: The name of the alias.
:param agent_id: The unique identifier of the agent.
:return: Details about the alias that was created.
"""
try:
response = self.client.create_agent_alias(
agentAliasName=name, agentId=agent_id
)
agent_alias = response["agentAlias"]
except ClientError as e:
logger.error(f"Couldn't create agent alias. {e}")
raise
else:
return agent_alias
```
Para obtener más información, consulte [Introducción a Agentes de Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------
# Visualización de información sobre las versiones de los agentes en Amazon Bedrock
Después de crear una versión del agente, puede ver la información al respecto o eliminarla. Para crear una nueva versión de un agente primero debe crear un nuevo alias.
Para saber cómo ver la información de las versiones de un agente, 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 un agente**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. Elija la versión que desee ver en la sección **Versiones**.
1. Para ver detalles sobre el modelo, los grupos de acciones o las bases de conocimientos asociadas a la versión del agente, elija el nombre de la información que desea ver. No puede modificar ninguna parte de una versión. Para realizar modificaciones en el agente, utilice el borrador de trabajo y cree una nueva versión.
------
#### [ API ]
Para obtener información sobre la versión de un agente, envíe una solicitud [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.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). Especifique el `agentId` y el `agentVersion`.
Para mostrar la información sobre las versiones de un agente, envíe una solicitud [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.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 elemento `agentId`. 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. |
------
# Eliminación de una versión de un agente en Amazon Bedrock
Para obtener más información sobre cómo eliminar una versión de un agente, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:
------
#### [ Console ]
**Eliminación de una versión de un agente**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. Para elegir la versión a eliminar, en la sección **Versiones**, elija el botón de opción junto a la versión que desea eliminar.
1. Elija **Eliminar**.
1. Aparece un cuadro de diálogo que le advierte sobre las consecuencias de la eliminación. Para confirmar que desea eliminar la versión, escriba **delete** en el campo de entrada y, a continuación, seleccione **Eliminar**.
1. Aparece un banner para informarle de que se va a eliminar la versión. Cuando se complete la eliminación, aparecerá un banner de confirmación.
------
#### [ API ]
Para eliminar una versión de un agente, envíe una solicitud [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.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). De forma predeterminada, el parámetro `skipResourceInUseCheck` es `false` y la eliminación se detiene si el recurso está en uso. Si establece `skipResourceInUseCheck` en `true`, el recurso se eliminará incluso aunque el recurso esté en uso.
------
# Ver información sobre los alias de los agentes en Amazon Bedrock
Para saber cómo obtener información sobre los alias de un agente, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:
------
#### [ Console ]
**Visualización de los detalles de un alias**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. Elija el alias que desea ver en la sección **Alias**.
1. Puede ver el nombre y la descripción del alias y las etiquetas asociadas al mismo.
------
#### [ API ]
Para obtener información sobre un alias de agente, envíe una solicitud [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.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). Especifique el `agentId` y el `agentAliasId`.
Para mostrar la información sobre los alias de un agente, envíe una solicitud [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.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 elemento `agentId`. 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. |
Para ver todas las etiquetas de un alias, envíe una solicitud [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.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) e incluya el Nombre de recurso de Amazon (ARN) del alias.
------
# Edición de un alias de un agente de Amazon Bedrock
Para obtener más información sobre cómo editar un alias de un agente, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:
------
#### [ Console ]
**Para editar un alias**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. En la sección **Alias**, elija el botón de opción junto al alias que desea editar. A continuación, elija **Editar**.
1. Edite los campos existentes según sea necesario. Para obtener más información acerca de estos campos, consulte [Implementación y uso de un agente de Amazon Bedrock en su aplicación](agents-deploy.md).
1. Seleccione **Guardar**.
**Agregación o eliminación de etiquetas asociadas a un alias**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. Elija el alias cuyas etiquetas desea administrar en la sección **Alias**.
1. En la sección **Etiquetas**, elija **Administrar etiquetas**.
1. Para añadir una etiqueta, elija **Añadir nueva etiqueta**. Indique una **Clave** y, de forma opcional, un **Valor**. Para eliminar una etiqueta, elija **Eliminar**. Para obtener más información, consulte [Etiquetado de los recursos de Amazon Bedrock](tagging.md).
1. Cuando haya terminado de editar las etiquetas, elija **Enviar**.
------
#### [ API ]
Para editar un alias de agente, envíe una solicitud [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.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). Dado que se sobrescribirán todos los campos, incluya los dos campos que quiera actualizar, así como los campos que quiera mantener sin cambios.
Para añadir etiquetas a un alias, envíe una solicitud [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.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) e incluya el Nombre de recurso de Amazon (ARN) del alias. El cuerpo de la solicitud contiene un campo `tags`, que es un objeto que contiene un par clave-valor que se especifica para cada etiqueta.
Para eliminar etiquetas de un alias, envíe una solicitud [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.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) e incluya el Nombre de recurso de Amazon (ARN) del alias. El parámetro de solicitud `tagKeys` es una lista que contiene las claves de las etiquetas que quiere eliminar.
------
# Eliminación de un alias de un agente de Amazon Bedrock
Para obtener más información sobre cómo eliminar un alias de un agente, seleccione la pestaña correspondiente al método que prefiera y siga los pasos:
------
#### [ Console ]
**Eliminación de un alias**
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 **Agentes**. A continuación, elija un agente en la sección **Agentes**.
1. Para elegir el alias que desea eliminar, elija el botón de opción situado junto al alias que desea eliminar en la sección **Alias**.
1. Elija **Eliminar**.
1. Aparece un cuadro de diálogo que le advierte sobre las consecuencias de la eliminación. Para confirmar que desea eliminar el alias, escriba **delete** en el campo de entrada y, a continuación, elija **Eliminar**.
1. Aparece un banner para informarle de que el alias se va a eliminar. Cuando se complete la eliminación, aparecerá un banner de confirmación.
------
#### [ API ]
Para eliminar un alias de un agente, envíe una solicitud [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.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). De forma predeterminada, el parámetro `skipResourceInUseCheck` es `false` y la eliminación se detiene si el recurso está en uso. Si establece `skipResourceInUseCheck` en `true`, el recurso se eliminará incluso aunque el recurso esté en uso.
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
Para obtener más información, consulte [Introducción a Agentes de Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------