View a markdown version of this page

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

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 kerja Strands. Agen yang dihasilkan adalah agen AgentCore runtime normal: Anda memiliki kode, dapat memodifikasinya dengan bebas, dan menyebarkannya 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 yang berfungsi dan ingin:

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

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

  • Luluskan prototipe - mulailah dengan cepat dengan harness, lalu ekspor saat Anda siap berinvestasi dalam agen yang dirawat dengan tangan.

Jika konfigurasi harness sudah melakukan semua yang Anda butuhkan, Anda tidak perlu mengekspor - tetap 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)

  • Alat - Alat MCP Jarak Jauh, Gateway, alat fungsi sebaris, AgentCore Browser, Penerjemah AgentCore Kode, bawaan shell dan alat file_operations

  • Memori

  • Batas eksekusi

  • Pemotongan percakapan

  • Keterampilan (Jalur, S3, Git)

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

  • Konfigurasi Authorizer

Penggunaan CLI

Sintaks Perintah

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

Opsi

Bendera Deskripsi Default

--arn <arn>

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

arnatau name diperlukan

--name <name>

Nama harness untuk diekspor (digunakan 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 bangunan: 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

J agentcore export harness alan --name kan tanpa 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 defaultnya<harness>Agent.

    Beri nama agen runtime yang dihasilkan

  3. Pilih jenis build: CodeZip (paket sumber Python sebagai zip, default) atau Con tainer (buat gambar Docker melalui ECR dan CodeBuild).

    Pilih tipe build

  4. Tinjau konfigurasi ekspor dan konfirmasikan.

    Tinjau dan konfirmasikan ekspor

Setelah ekspor, tinj EXPORT_NOTES.md au, lalu jalankan agentcore deploy untuk menerapkan agen yang dihasilkan.

Setelah ekspor

Terapkan agen runtime yang dihasilkan menggunakan AgentCore CLI.

contoh
AgentCore CLI
agentcore deploy

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

EKSPOR_ NOTES.md

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

Opsi Penerapan

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

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

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

    • AWS Layanan: Lambda, ECS/Fargate, EC2

    • Cluster Kubernetes

    • On-premise server

    • Lingkungan kontainer apa pun