View a markdown version of this page

Ekspor harness ke kode - Batuan Dasar Amazon AgentCore
Kapan Menggunakan EksporApa yang didukung hari iniPenggunaan CLIEKSPOR_ NOTES.mdOpsi Penerapan

Ekspor harness ke kode

Ekspor harness ke kode mengambil konfigurasi harness terkelola dan menghasilkan agen yang setara sebagai kode sumber Python yang dapat diedit menggunakan kerangka Strands. Agen yang dihasilkan adalah agen AgentCore runtime normal: Anda memiliki kode, dapat memodifikasinya secara bebas, dan menerapkannya seperti agen lainnya. Agen yang dihasilkan mencerminkan model harness, alat, keterampilan, memori, batas eksekusi, dan pemasangan sistem file.

Kapan Menggunakan Ekspor

Gunakan ekspor saat Anda memiliki harness kerja dan ingin:

  • Sesuaikan di luar apa yang diizinkan oleh konfigurasi harness - tambahkan logika alat khusus, ubah loop agen, suntikkan middleware/hooks, atau integrasikan pustaka yang tidak diekspos oleh harness

  • Miliki kode - pindahkan dari konfigurasi deklaratif ke kode sumber yang Anda kontrol, tinjau, dan versi seperti aplikasi Anda lainnya.

  • Lulus prototipe - mulailah dengan cepat dengan harness, lalu ekspor ketika Anda siap untuk berinvestasi dalam agen yang dipelihara dengan tangan.

Jika konfigurasi harness sudah melakukan semua yang Anda butuhkan, Anda tidak perlu mengekspor - terus jalankan sebagai harness.

Apa yang didukung hari ini

  • Framework - Strands, dengan kerangka kerja lain seperti Claude Agents SDK segera hadir

  • Bahasa - hanya Python

  • Jenis build - CodeZip (default) dan Container

Fitur harness dibawa ke agen yang dihasilkan:

  • Penyedia model dan konfigurasi (Bedrock, OpenAI, Gemini - termasuk ID model dan referensi kunci API)

  • Tools - Alat MCP jarak jauh, Gateway, alat fungsi inline, AgentCore Browser, Penerjemah AgentCore Kode, built-in dan alat shell file_operations

  • Memori

  • Batas eksekusi

  • Pemotongan percakapan

  • Keterampilan (Jalur, S3, Git)

  • Dudukan sistem file (penyimpanan sesi, EFS, S3) untuk harness VPC

  • Konfigurasi otorisasi

Penggunaan CLI

Sintaks Perintah

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

Opsi

Bendera Deskripsi Default

--arn <arn>

ARN dari harness untuk diekspor (gunakan saat mengekspor harness yang dibuat di luar proyek CLI saat ini)

arnatau name diperlukan

--name <name>

Nama harness untuk diekspor (gunakan saat mengekspor harness yang dibuat dalam proyek CLI yang sama)

arnatau name diperlukan

--target-agent-name <name>

Nama untuk agen runtime yang dihasilkan

<harnessName>Agent

--build <type>

Jenis build: CodeZip atau Container

CodeZip

--json

Hasil keluaran sebagai JSON

False

Contoh

Ekspor dasar dengan default:

contoh
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

Jalankan agentcore export harness tanpa --name untuk meluncurkan wizard ekspor interaktif.

  1. Jika proyek memiliki lebih dari satu harness, pilih harness untuk diekspor. (Dengan satu harness, wizard melewatkan langkah ini.)

    Pilih harness untuk diekspor

  2. Masukkan nama untuk agen runtime yang dihasilkan, atau terima <harness>Agent defaultnya.

    Beri nama agen runtime yang dihasilkan

  3. Pilih tipe build: CodeZip(paket sumber Python sebagai zip, default) atau Container (buat image Docker melalui ECR dan). CodeBuild

    Pilih jenis build

  4. Tinjau konfigurasi ekspor dan konfirmasikan.

    Tinjau dan konfirmasikan ekspor

Setelah ekspor, tinjauEXPORT_NOTES.md, lalu jalankan agentcore deploy untuk menyebarkan agen yang dihasilkan.

Setelah ekspor

Terapkan agen runtime yang dihasilkan menggunakan CLI AgentCore .

contoh
AgentCore CLI
agentcore deploy

Agen yang diekspor ditambahkan sebagai runtime normal, sehingga digunakan bersama sisa proyek CLI AgentCore Anda.

EKSPOR_ NOTES.md

Setelah setiap ekspor, EXPORT_NOTES.md ditulis daftar item yang membutuhkan tindak lanjut manual. Export menulis catatan ke EXPORT_ NOTES.md di direktori agen yang mencantumkan setiap item, mengapa perlu perhatian, dan apa yang harus dilakukan. Selalu baca EXPORT_ NOTES.md sebelum menerapkan.

Opsi Penerapan

Setelah mengekspor, Anda dapat menyebarkan agen Anda ke beberapa lingkungan hosting:

  • AgentCore Runtime (managed) - Gunakan agentcore deploy untuk meng-host di AgentCore Runtime, yang mengelola infrastruktur, penskalaan, dan penyediaan kredenal secara otomatis.

  • Self-hosted- Menyebarkan agen Python yang dihasilkan di mana saja yang mendukung Python 3.12+:

    • AWS Layanan: Lambda, EC2 ECS/Fargate

    • Cluster Kubernetes

    • On-premise server

    • Setiap lingkungan kontainer