View a markdown version of this page

Exportar arnés a código - Base amazónica AgentCore
¿Cuándo usar la exportación?¿Qué se admite en la actualidadUso de la CLIEXPORTAR_ NOTES.mdOpciones de implementación

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.

Exportar arnés a código

La exportación del arnés a código toma una configuración de arnés gestionada y genera el agente equivalente al código fuente editable de Python mediante el marco de trabajo de Strands. El agente generado es un agente AgentCore de ejecución normal: eres el propietario del código, puedes modificarlo libremente e implementarlo como cualquier otro agente. El agente generado refleja el modelo, las herramientas, las habilidades, la memoria, los límites de ejecución y los montajes del sistema de archivos del arnés.

¿Cuándo usar la exportación?

Usa la exportación cuando tengas un arnés que funcione y quieras:

  • Personaliza más allá de lo que permite la configuración del arnés: agrega una lógica de herramientas personalizada, cambia el bucle del agente middleware/hooks, inyecta o integra bibliotecas que el arnés no expone

  • Sé dueño del código: pasa de una configuración declarativa a un código fuente que controlas, revisas y versionas como el resto de tu aplicación.

  • Gradua un prototipo: empieza rápido con un arnés y luego expórtalo cuando estés listo para invertir en un agente mantenido manualmente.

Si la configuración del arnés ya cumple con todos los requisitos, no es necesario que la exporte, sino que siga ejecutándola como un arnés.

¿Qué se admite en la actualidad

  • Framework: Strands, y próximamente habrá otros marcos como el SDK de Claude Agents

  • Idioma: solo Python

  • Tipos de compilación: CodeZip (predeterminado) y contenedor

Aproveche las funciones incorporadas al agente generado:

  • Proveedor y configuración del modelo (Bedrock, OpenAI, Gemini, incluidas las referencias al ID del modelo y a las claves de API)

  • Herramientas: herramientas MCP remotas, puertas de enlace, herramientas de funciones en línea, AgentCore navegador, intérprete de AgentCore código, herramientas integradas shell file_operations

  • Memoria

  • Límites de ejecución

  • Truncamiento de la conversación

  • Habilidades (Path, S3, Git)

  • Montajes de sistemas de archivos (almacenamiento de sesiones, EFS, S3) para aprovechar las VPC

  • Configuración del autorizador

Uso de la CLI

Sintaxis de comandos

ejemplo
AgentCore CLI
agentcore export harness --arn <arn> [options]

Opciones

Indicador Description (Descripción) Predeterminado

--arn <arn>

ARN del arnés que se va a exportar (utilícelo al exportar un arnés creado fuera del proyecto de CLI actual)

arno name es obligatorio

--name <name>

Nombre del arnés que se va a exportar (utilícelo al exportar un arnés creado en el mismo proyecto de CLI)

arno name es obligatorio

--target-agent-name <name>

Nombre del agente de ejecución generado

<harnessName>Agent

--build <type>

Tipo de compilación: CodeZip o Container

CodeZip

--json

Genera los resultados como JSON

False

Ejemplos

Exportación básica con valores predeterminados:

ejemplo
AgentCore CLI
# Export harness with ARN - generates MyHarnessAgent using CodeZip
agentcore export harness --arn arn:aws:bedrock-agentcore:us-east-1:123456789012:harness/MyHarness
# Export harness created within CLI project - generates MyHarnessAgent using CodeZip
agentcore export harness --name MyHarness
# Export with a custom agent name
agentcore export harness --name MyHarness --target-agent-name MyProductionAgent
# Export as a Container build (generates Dockerfile)
agentcore export harness --name MyHarness --build Container
Interactive

Ejecute agentcore export harness sin --name ella para iniciar el asistente de exportación interactivo.

  1. Si el proyecto tiene más de un arnés, seleccione el arnés que desee exportar. (Con un solo arnés, el asistente omite este paso).

    Seleccione el arnés que desea exportar

  2. Introduzca un nombre para el agente de ejecución generado o acepte el nombre predeterminado<harness>Agent.

    Asigne un nombre al agente de tiempo de ejecución generado

  3. Elige el tipo de compilación: CodeZip (empaqueta el código fuente de Python en formato zip, el predeterminado) o Container (crea una imagen de Docker mediante ECR y CodeBuild).

    Selecciona el tipo de compilación

  4. Revise la configuración de exportación y confirme.

    Revisa y confirma la exportación

Tras la exportación, revise yEXPORT_NOTES.md, a continuación, ejecútelo agentcore deploy para implementar el agente generado.

Después de la exportación

Implemente el agente de tiempo de ejecución generado mediante la AgentCore CLI.

ejemplo
AgentCore CLI
agentcore deploy

El agente exportado se agrega como un tiempo de ejecución normal, por lo que se implementa junto con el resto del proyecto de AgentCore CLI.

EXPORTAR_ NOTES.md

Después de cada exportación, EXPORT_NOTES.md se incluye una lista de los artículos que requieren un seguimiento manual. Export escribe notas en EXPORT_ NOTES.md en el directorio del agente en las que se enumeran cada elemento, por qué necesita atención y qué hacer exactamente. Lea siempre EXPORT_ NOTES.md antes de realizar la implementación.

Opciones de implementación

Tras la exportación, puede implementar su agente en varios entornos de alojamiento:

  • AgentCore Tiempo de ejecución (administrado): agentcore deploy utilícelo para hospedar en AgentCore Runtime, que administra automáticamente la infraestructura, el escalado y el aprovisionamiento de credenciales.

  • Self-hosted- Implemente el agente de Python generado en cualquier lugar que sea compatible con Python 3.12+:

    • AWS servicios: Lambda, EC2 ECS/Fargate

    • clústeres de Kubernetes

    • On-premise servidores

    • Cualquier entorno contenerizado