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 y uso de un agente de Amazon Bedrock en su aplicación
Para poder utilizar un agente, debe implementarlo mediante la creación de un alias. A continuación, puede utilizar el agente en su aplicación llamando a la operación [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). En esta sección, aprenderá a crear y a administrar un alias y a llamar a su agente desde una aplicación.
**Topics**
+ [Implementación de un agente](deploy-agent.md)
+ [Invocación de un agente desde su aplicación](agents-invoke-agent.md)
# 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).
------
# Invocación de un agente desde su aplicación
Utilice su agente en una 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).
De forma predeterminada, la respuesta de `InvokeAgent` incluye un fragmento que contiene la respuesta completa del agente, que puede tardar un tiempo en completarse. También puede configurar `InvokeAgent` para que transmita la respuesta en varios fragmentos más pequeños. Esto reduce la latencia de la respuesta inicial del agente.
**Respuestas de transmisión**
Si lo desea, puede habilitar la transmisión de la respuesta estableciendo `streamFinalResponse` en `true` en las configuraciones de transmisión ([StreamingConfigurations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StreamingConfigurations.html)). El flujo de respuesta contiene varios eventos con fragmentos para cada parte de la respuesta en orden.
Para transmitir las respuestas, asegúrese de que el rol de ejecución del agente incluya el permiso `bedrock:InvokeModelWithResponseStream` para el modelo de agente configurado. Para obtener más información, consulte [Permisos basados en identidades para el rol de servicio de los agentes](agents-permissions.md#agents-permissions-identity).
Si su agente está configurado con una barrera de protección, también puede especificar `applyGuardrailInterval` en `StreamingConfigurations`, para controlar la frecuencia con la que se realiza una llamada a `ApplyGuardrail` en el número de caracteres de respuesta de salida (por ejemplo, cada 50 caracteres).
De forma predeterminada, el intervalo de la barrera de protección está establecido en 50 caracteres. Si se especifica un intervalo mayor, la respuesta se generará en fragmentos más grandes con menos llamadas a `ApplyGuardrail`. Los siguientes ejemplos muestran la respuesta generada para la cadena de entrada *Hello, I am an agent*.
**Ejemplo de respuesta en fragmentos: intervalo establecido en tres caracteres**
```
'Hel', 'lo, ', 'I am', ' an', ' Age', 'nt'
```
Cada fragmento tiene al menos tres caracteres, excepto el último fragmento.
**Ejemplo de respuesta en fragmentos: intervalo establecido en veinte o más caracteres**
```
'Hello, I am an Agent'
```
## Invocación de un agente
El siguiente ejemplo de Python muestra cómo llamar a la operación [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) y mostrar la salida del agente, así como cualquier información de [seguimiento](trace-events.md) que genere la llamada.
**Cómo invocar un agente**
1. Cree un agente siguiendo las instrucciones de [Creación y configuración de agentes manualmente](agents-create.md). Anote el ID del agente. Si es necesario, puede obtener el ID más adelante. Para obtener más información, consulte [Visualización de la información de un agente](agents-view.md).
1. Cree un alias para el agente siguiendo las instrucciones de [Creación de un alias de agente](deploy-agent-proc.md). Anote el ID del alias. Si es necesario, puede obtener el ID más adelante. Para obtener más información, consulte [Ver información sobre los alias de los agentes en Amazon Bedrock](agents-alias-view.md).
1. Ejecute el siguiente código. Cambie el valor de `agent_id` al ID del agente y el valor de `alias_id` al ID de alias del agente. Para transmitir la respuesta del agente, cambie el valor de `streamFinalResponse` a `True`. También puede cambiar el intervalo de la barrera de protección cambiando el valor de `applyGuardrailInterval`.
```
import boto3
import logging
from botocore.exceptions import ClientError
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
def invoke_agent(client, agent_id, alias_id, prompt, session_id):
response = client.invoke_agent(
agentId=agent_id,
agentAliasId=alias_id,
enableTrace=True,
sessionId = session_id,
inputText=prompt,
streamingConfigurations = {
"applyGuardrailInterval" : 20,
"streamFinalResponse" : False
}
)
completion = ""
for event in response.get("completion"):
#Collect agent output.
if 'chunk' in event:
chunk = event["chunk"]
completion += chunk["bytes"].decode()
# Log trace output.
if 'trace' in event:
trace_event = event.get("trace")
trace = trace_event['trace']
for key, value in trace.items():
logging.info("%s: %s",key,value)
print(f"Agent response: {completion}")
if __name__ == "__main__":
client=boto3.client(
service_name="bedrock-agent-runtime"
)
agent_id = "AGENT_ID"
alias_id = "ALIAS_ID"
session_id = "MY_SESSION_ID"
prompt = "Prompt to send to agent"
try:
invoke_agent(client, agent_id, alias_id, prompt, session_id)
except ClientError as e:
print(f"Client error: {str(e)}")
logger.error("Client error: %s", {str(e)})
```