View a markdown version of this page

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

Esporta il cablaggio in codice

Export harness to code 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 supporti del file system dell'harness.

Quando usare Export

Usa l'esportazione quando hai un'imbracatura da lavoro e desideri:

  • Personalizza oltre a quanto consentito dalla configurazione dell'harness: aggiungi una logica di strumento personalizzata, modifica il loop dell'agente middleware/hooks, inietta o integra librerie non esposte dall'harness

  • Gestisci il codice: passa da una configurazione dichiarativa al codice sorgente che controlli, rivedi e modifichi come il resto dell'applicazione.

  • Sviluppa un prototipo: inizia velocemente con un cablaggio, quindi esporta quando sei pronto a investire in un agente gestito manualmente.

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

Cosa è supportato oggi

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

  • Linguaggio: solo Python

  • Tipi di build - CodeZip (impostazione predefinita) e contenitore

Sfrutta le funzionalità incluse nell'agente generato:

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

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

  • Memoria

  • Limiti di esecuzione

  • Troncamento della conversazione

  • Competenze (Path, S3, Git)

  • Supporti di file system (storage di sessione, 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 dell'harness da esportare (da utilizzare quando si esporta un harness creato al di fuori 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 richiesto

--target-agent-name <name>

Nome dell'agente di runtime generato

<harnessName>Agent

--build <type>

Tipo di build: CodeZip o Container

CodeZip

--json

Emetti i risultati 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, selezionate il cablaggio da esportare. (Con un solo cablaggio, il wizard salta questo passaggio.)

    Selezionate il cablaggio da esportare

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

    Assegna un nome all'agente runtime generato

  3. Scegli il tipo di build: CodeZip(pacchetto sorgente Python 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, esaminaEXPORT_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 un normale runtime, quindi viene distribuito insieme al resto del progetto CLI AgentCore .

ESPORTA_ NOTES.md

Dopo ogni esportazione, EXPORT_NOTES.md viene scritto un elenco degli articoli che richiedono un follow-up manuale. Export scrive note su EXPORT_ NOTES.md nella directory degli agenti elencando ogni elemento, il motivo per cui 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 ospitare nel AgentCore Runtime, che gestisce automaticamente l'infrastruttura, la scalabilità e il provisioning delle credenziali.

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

    • AWS servizi: Lambda, EC2 ECS/Fargate

    • cluster Kubernetes

    • On-premise server

    • Qualsiasi ambiente containerizzato