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.

Invoca un agente de AgentCore tiempo de ejecución

La InvokeAgentRuntime operación permite enviar solicitudes a puntos finales de AgentCore Runtime específicos identificados por su nombre de recurso de Amazon (ARN) y recibir respuestas en streaming con los resultados del agente. La API admite la administración de sesiones mediante identificadores de sesión, lo que te permite mantener el contexto de la conversación en varias interacciones. Puede dirigirse a puntos finales de agentes específicos mediante calificadores opcionales.

Para llamarInvokeAgentRuntime, necesita bedrock-agentcore:InvokeAgentRuntime permisos. En la llamada, también puedes pasar un token de portador que el agente puede usar para la autenticación del usuario.

La InvokeAgentRuntime operación acepta la carga útil de la solicitud como datos binarios de hasta 100 MB de tamaño y devuelve una respuesta en streaming que entrega fragmentos de datos en tiempo real a medida que el agente procesa la solicitud. Este enfoque de transmisión permite recibir resultados parciales de forma inmediata, en lugar de esperar a recibir la respuesta completa, por lo que es ideal para aplicaciones interactivas.

Para ejecutar comandos de shell (como ejecutar pruebas, operaciones de git o configurar el entorno) en la misma sesión, utilice la operación Ejecutar comandos de shell en sesiones AgentCore de ejecución. Ambas operaciones funcionan en el mismo tiempo de ejecución y sesión del agente.

Si planeas integrar tu agente con OAuth, no puedes usar el AWS SDK para realizar llamadas. InvokeAgentRuntime En su lugar, haz una solicitud HTTPS a. InvokeAgentRuntime Para obtener más información, consulta Autenticar y autorizar con la autenticación entrante y la autenticación saliente.

Invoca a los agentes de streaming

El siguiente ejemplo muestra cómo usar boto3 para invocar el tiempo de ejecución de un agente:

import boto3
import json

# Initialize the Bedrock AgentCore client
agent_core_client = boto3.client('bedrock-agentcore')

# Prepare the payload
payload = json.dumps({"prompt": prompt}).encode()

# Invoke the agent
response = agent_core_client.invoke_agent_runtime(
    agentRuntimeArn=agent_arn,
    runtimeSessionId=session_id,
    payload=payload
)


# Process and print the response
if "text/event-stream" in response.get("contentType", ""):

    # Handle streaming response
    content = []
    for line in response["response"].iter_lines(chunk_size=10):
        if line:
            line = line.decode("utf-8")
            if line.startswith("data: "):
                line = line[6:]
                print(line)
                content.append(line)
    print("\nComplete response:", "\n".join(content))

elif response.get("contentType") == "application/json":
    # Handle standard JSON response
    content = []
    for chunk in response.get("response", []):
        content.append(chunk.decode('utf-8'))
    print(json.loads(''.join(content)))

else:
    # Print raw response for other content types
    print(response)

Invoca agentes multimodales

Puede usar la InvokeAgentRuntime operación para enviar solicitudes multimodales que incluyan texto e imágenes. El siguiente ejemplo muestra cómo invocar un agente multimodal:

import boto3
import json
import base64

# Read and encode image
with open("image.jpg", "rb") as image_file:
    image_data = base64.b64encode(image_file.read()).decode('utf-8')

# Prepare multi-modal payload
payload = json.dumps({
    "prompt": "Describe what you see in this image",
    "media": {
        "type": "image",
        "format": "jpeg",
        "data": image_data
 }
}).encode()

# Invoke the agent
response = agent_core_client.invoke_agent_runtime(
    agentRuntimeArn=agent_arn,
    runtimeSessionId=session_id,
    payload=payload
)

Administración de sesiones

La InvokeAgentRuntime operación admite la administración de sesiones a través del runtimeSessionId parámetro. Al proporcionar el mismo identificador de sesión en varias solicitudes, puede mantener el contexto de la conversación, lo que permite al agente hacer referencia a las interacciones anteriores.

Para iniciar una conversación nueva, genere un identificador de sesión único. Para continuar una conversación existente, usa el mismo identificador de sesión de las solicitudes anteriores. Este enfoque le permite crear aplicaciones interactivas que mantienen el contexto a lo largo del tiempo.

Gestión de errores

Al utilizar la InvokeAgentRuntime operación, es posible que se produzcan varios errores. Estos son algunos errores comunes y cómo solucionarlos:

Implementa una gestión de errores adecuada en tu aplicación para ofrecer una mejor experiencia de usuario y solucionar los problemas de forma eficaz.

Prácticas recomendadas

Siga estas prácticas recomendadas cuando utilice la InvokeAgentRuntime operación: