View a markdown version of this page

Kabelbaum in Code exportieren - Amazon Grundgestein AgentCore
Wann sollte Export verwendet werdenWas wird heute unterstütztCLI-VerwendungEXPORTIEREN_ NOTES.mdOptionen für die Bereitstellung

Kabelbaum in Code exportieren

Beim Exportieren von Harness to Code wird eine verwaltete Harness-Konfiguration verwendet und der entsprechende Agent als editierbarer Python-Quellcode mithilfe des Strands-Frameworks generiert. Der generierte Agent ist ein normaler AgentCore Runtime-Agent: Sie besitzen den Code, können ihn nach Belieben ändern und ihn wie jeden anderen Agenten einsetzen. Der generierte Agent spiegelt das Modell, die Tools, die Fähigkeiten, den Arbeitsspeicher, die Ausführungsgrenzen und die Dateisystem-Mounts des Harness wider.

Wann sollte Export verwendet werden

Verwenden Sie den Export, wenn Sie einen funktionierenden Kabelbaum haben und:

  • Anpassungen, die über das hinausgehen, was die Harness-Konfiguration zulässt — benutzerdefinierte Werkzeuglogik hinzufügen, die Agentenschleife ändern middleware/hooks, Bibliotheken einfügen oder integrieren, die der Kabelbaum nicht verfügbar macht

  • Besitzen Sie den Code — wechseln Sie von einer deklarativen Konfiguration zum Quellcode, den Sie wie den Rest Ihrer Anwendung kontrollieren, überprüfen und versionieren.

  • Entwickeln Sie einen Prototyp — beginnen Sie schnell mit einem Kabelbaum und exportieren Sie ihn dann, wenn Sie bereit sind, in einen von Hand gewarteten Agenten zu investieren.

Wenn die Kabelbaumkonfiguration bereits alles bietet, was Sie benötigen, müssen Sie sie nicht exportieren. Führen Sie sie weiterhin als Kabelbaum aus.

Was wird heute unterstützt

  • Framework — Strands, weitere Frameworks wie das Claude Agents SDK kommen bald

  • Sprache — nur Python

  • Build-Typen — CodeZip (Standard) und Container

Nutzen Sie Funktionen, die in den generierten Agenten übernommen wurden:

  • Modellanbieter und Konfiguration (Bedrock, OpenAI, Gemini — einschließlich Modell-ID und API-Schlüsselreferenzen)

  • Tools — Remote-MCP-Tools, Gateways, Inline-Funktionstools, AgentCore Browser, AgentCore Code-Interpreter, integrierte Tools und Tools shell file_operations

  • Arbeitsspeicher

  • Ausführungsbeschränkungen

  • Verkürzung der Konversation

  • Fähigkeiten (Pfad, S3, Git)

  • Dateisystem-Mounts (Sitzungsspeicher, EFS, S3) für VPC-Kabeln

  • Authorizer-Konfiguration

CLI-Verwendung

Befehlssyntax

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

Optionen

Flag Description Standard

--arn <arn>

ARN des zu exportierenden Kabelbaums (wird verwendet, wenn ein Kabelbaum exportiert wird, der außerhalb des aktuellen CLI-Projekts erstellt wurde)

arnoder name erforderlich

--name <name>

Name des zu exportierenden Kabelbaums (wird verwendet, wenn ein Kabelbaum exportiert wird, der im selben CLI-Projekt erstellt wurde)

arnoder name erforderlich

--target-agent-name <name>

Name für den generierten Runtime-Agenten

<harnessName>Agent

--build <type>

Build-Typ: CodeZip oder Container

CodeZip

--json

Ergebnisse als JSON ausgeben

Falsch

Beispiele

Grundlegender Export mit Standardeinstellungen:

Beispiel
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

agentcore export harnessOhne ausführen--name, um den interaktiven Exportassistenten zu starten.

  1. Wenn das Projekt mehr als einen Kabelbaum enthält, wählen Sie den Kabelbaum aus, den Sie exportieren möchten. (Bei einem einzelnen Kabelbaum überspringt der Assistent diesen Schritt.)

    Wählen Sie den Kabelbaum aus, den Sie exportieren möchten

  2. Geben Sie einen Namen für den generierten Runtime-Agenten ein, oder akzeptieren Sie die Standardeinstellung<harness>Agent.

    Geben Sie dem generierten Runtime-Agenten einen Namen

  3. Wählen Sie den Build-Typ: CodeZip(Paket Python-Quelle als Zip, Standard) oder Container (Erstellen Sie ein Docker-Image über ECR und CodeBuild).

    Wählen Sie den Build-Typ

  4. Überprüfen Sie die Exportkonfiguration und bestätigen Sie.

    Überprüfen und bestätigen Sie den Export

Überprüfen Sie nach dem Export den generierten Agenten und führen Sie agentcore deploy ihn anschließend ausEXPORT_NOTES.md, um ihn bereitzustellen.

Nach dem Export

Stellen Sie den generierten Runtime-Agenten mithilfe der AgentCore CLI bereit.

Beispiel
AgentCore CLI
agentcore deploy

Der exportierte Agent wird als normale Laufzeit hinzugefügt, sodass er zusammen mit dem Rest Ihres AgentCore CLI-Projekts bereitgestellt wird.

EXPORTIEREN_ NOTES.md

Nach jedem Export EXPORT_NOTES.md wird eine Liste mit Artikeln geschrieben, die manuell nachbearbeitet werden müssen. Export schreibt Notizen nach EXPORT_ NOTES.md im Agentenverzeichnis, in denen jedes Element aufgeführt wird, warum es bearbeitet werden muss und was genau zu tun ist. Lesen Sie vor der Bereitstellung immer EXPORT_NOTES.md .

Optionen für die Bereitstellung

Nach dem Export können Sie Ihren Agenten in mehreren Hosting-Umgebungen bereitstellen:

  • AgentCore Runtime (managed) — Wird agentcore deploy zum Hosten in der AgentCore Runtime verwendet, die Infrastruktur, Skalierung und Bereitstellung von Anmeldeinformationen automatisch verwaltet.

  • Self-hosted- Stellen Sie den generierten Python-Agenten überall bereit, wo Python 3.12+ unterstützt wird:

    • AWS dienstleistungen: Lambda ECS/Fargate, EC2

    • Kubernetes-Cluster

    • On-premise Server

    • Jede containerisierte Umgebung