View a markdown version of this page

Esporta il cablaggio in codice - Fondamento Amazon AgentCore
Quando usare ExportCosa è supportato oggiUtilizzo della CLIESPORTA_ NOTES.mdOpzioni di distribuzione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Esporta il cablaggio in codice

L'esportazione di harness in codice richiede una configurazione di harness gestita e genera l'agente equivalente come codice sorgente Python modificabile utilizzando il framework Strands. L'agente generato è un normale agente AgentCore di runtime: sei il proprietario del codice, puoi modificarlo liberamente e distribuirlo come qualsiasi altro agente. L'agente generato rispecchia il modello, gli strumenti, le competenze, la memoria, i limiti di esecuzione e i montaggi del file system dell'harness.

Quando usare Export

Usa l'esportazione quando hai un'imbracatura funzionante e vuoi:

  • Personalizza oltre a ciò che consente la configurazione di harness: aggiungi una logica personalizzata per gli strumenti, modifica il loop dell'agente, inserisci o integra le librerie che l'harness non middleware/hooks espone

  • Gestisci il codice: passa da una configurazione dichiarativa a un codice sorgente che controlli, rivedi e modifichi come il resto della tua applicazione.

  • Realizza un prototipo: inizia subito con un'imbracatura, poi esporta quando sei pronto a investire in un agente che si occupa della manutenzione manuale.

Se la configurazione dell'imbracatura soddisfa già tutto ciò di cui hai bisogno, non devi esportare: continua a utilizzarla come imbracatura.

Cosa è supportato oggi

  • Framework - Strands, con altri framework come Claude Agents SDK in arrivo

  • Lingua: solo Python

  • Tipi di build: CodeZip (impostazione predefinita) e Container

Sfrutta le funzionalità inserite nell'agente generato:

  • Fornitore e configurazione del modello (Bedrock, OpenAI, Gemini, inclusi l'ID del modello e i riferimenti alle chiavi API)

  • Strumenti: strumenti MCP remoti, gateway, strumenti funzionali in linea, AgentCore browser, interprete di codice, strumenti e strumenti integrati AgentCore shell file_operations

  • Memoria

  • Limiti di esecuzione

  • Troncamento della conversazione

  • Competenze (Path, S3, Git)

  • montaggi di file system (archiviazione delle sessioni, EFS, S3) per cablaggi VPC

  • Configurazione dell'autorizzatore

Utilizzo della CLI

Sintassi dei comandi

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

Opzioni

Flag Description Predefinita

--arn <arn>

ARN del cablaggio da esportare (da utilizzare quando si esporta un harness creato all'esterno del progetto CLI corrente)

arno richiesto name

--name <name>

Nome del cablaggio da esportare (da utilizzare quando si esporta un cablaggio creato nello stesso progetto CLI)

arno name obbligatorio

--target-agent-name <name>

Nome dell'agente di runtime generato

<harnessName>Agent

--build <type>

Tipo di build: CodeZip o Container

CodeZip

--json

Risultati di output in formato JSON

False

Esempi

Esportazione di base con impostazioni predefinite:

Esempio
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

Esegui agentcore export harness senza --name avviare la procedura guidata di esportazione interattiva.

  1. Se il progetto ha più di un cablaggio, seleziona il cablaggio da esportare. (Con un solo cablaggio, la procedura guidata salta questo passaggio).

    Seleziona l'imbracatura da esportare

  2. Immettete un nome per l'agente di runtime generato o accettate il nome predefinito<harness>Agent.

    Assegna un nome all'agente di runtime generato

  3. Scegli il tipo di build: CodeZip (pacchetto Python source come zip, impostazione predefinita) o Container (crea un'immagine Docker tramite ECR e). CodeBuild

    Seleziona il tipo di build

  4. Rivedi la configurazione di esportazione e conferma.

    Rivedi e conferma l'esportazione

Dopo l'esportazione, rivediEXPORT_NOTES.md, quindi agentcore deploy esegui per distribuire l'agente generato.

Dopo l'esportazione

Distribuisci l'agente di runtime generato utilizzando la AgentCore CLI.

Esempio
AgentCore CLI
agentcore deploy

L'agente esportato viene aggiunto come normale runtime, quindi viene distribuito insieme al resto del progetto CLI. AgentCore

ESPORTA_ NOTES.md

Dopo ogni esportazione, EXPORT_NOTES.md viene scritto l'elenco degli articoli che richiedono un follow-up manuale. Export scrive delle note su EXPORT_ NOTES.md nella directory degli agenti elencando ogni articolo, perché richiede attenzione e cosa fare esattamente. Leggi sempre EXPORT_ NOTES.md prima della distribuzione.

Opzioni di distribuzione

Dopo l'esportazione, puoi distribuire il tuo agente in più ambienti di hosting:

  • AgentCore Runtime (gestito): agentcore deploy da utilizzare per l'hosting nel AgentCore Runtime, che gestisce automaticamente l'infrastruttura, la scalabilità e il provisioning delle credenziali.

  • Self-hosted- Implementa l'agente Python generato ovunque supporti Python 3.12+:

    • AWS servizi: Lambda, EC2 ECS/Fargate

    • Cluster Kubernetes

    • On-premise server

    • Qualsiasi ambiente containerizzato