Referensi konfigurasi

File konfigurasi agen kustom adalah dokumen JSON yang menentukan bagaimana agen kustom berperilaku. Bagian ini memberikan gambaran umum tentang konsep konfigurasi dan pola umum.

Referensi konfigurasi

Untuk detail selengkapnya tentang format file konfigurasi agen kustom, bidang yang tersedia, dan sintaks, lihat dokumentasi CLI Pengembang Amazon Q tambahan:

• Format konfigurasi agen - Referensi lengkap untuk semua opsi konfigurasi

• Referensi alat bawaan - Dokumentasi untuk semua alat bawaan dan opsi konfigurasinya

Anda juga dapat melihat skema JSON untuk file konfigurasi agen kustom dengan menjalankan:

/agent schema

Konsep konfigurasi

File konfigurasi agen kustom berisi beberapa bagian kunci yang mengontrol berbagai aspek perilaku agen kustom:

Metadata dasar

Setiap agen kustom dapat menyertakan metadata dasar untuk identifikasi dan dokumentasi:

• Nama - Pengidentifikasi agen kustom (berasal dari nama file jika tidak ditentukan)

• Deskripsi - Penjelasan yang dapat dibaca manusia tentang tujuan agen kustom

Konfigurasi alat

Konfigurasi alat mengontrol alat mana yang tersedia untuk agen kustom dan bagaimana perilakunya:

alat

Daftar semua alat yang berpotensi digunakan agen kustom, termasuk alat bawaan dan alat server MCP

AllowedTools

Menentukan alat mana yang dapat berjalan tanpa konfirmasi pengguna, meningkatkan efisiensi alur kerja

Toolaliases

Menyediakan nama alternatif untuk alat, berguna untuk menyelesaikan konflik penamaan atau membuat pintasan

ToolsSettings

Mengonfigurasi perilaku khusus untuk alat individual, seperti jalur file yang diizinkan atau izin layanan

Konfigurasi server MCP

mcpServersBagian ini mendefinisikan server Model Context Protocol mana yang dapat diakses oleh agen kustom. Setiap konfigurasi server meliputi:

• Command - Perintah yang dapat dieksekusi untuk memulai server MCP

• Argumen - Argumen baris perintah untuk server

• Variabel lingkungan - Pengaturan lingkungan untuk proses server

• Pengaturan batas waktu - Minta konfigurasi batas waktu

Untuk informasi selengkapnya tentang integrasi MCP, lihat Menggunakan MCP dengan Pengembang Amazon Q.

Sumber daya dan konteks

Agen kustom dapat secara otomatis menyertakan konteks yang relevan melalui dua mekanisme:

sumber daya

File dan direktori untuk disertakan dalam konteks agen kustom, mendukung pola glob untuk pemilihan file yang fleksibel

kait

Perintah untuk dijalankan pada titik pemicu tertentu (seperti startup agen kustom atau input pengguna), dengan output disertakan dalam konteks

Pola konfigurasi umum

Konfigurasi agen kustom minimal

Agen kustom sederhana yang menyediakan operasi file dasar dengan akses baca yang telah disetujui sebelumnya:

{
"name": "basic-ops",
  "description": "Basic file operations custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash"
  ],
  "allowedTools": [
    "fs_read"
  ]
}

Agen kustom alur kerja khusus

Agen khusus yang dikonfigurasi untuk manajemen infrastruktur AWS dengan izin alat khusus:

{
"name": "infra-manage",
  "description": "AWS infrastructure management custom agent",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "use_aws"
  ],
  "allowedTools": [
    "fs_read",
    "use_aws"
  ],
  "toolsSettings": {
    "use_aws": {
      "allowedServices": ["s3", "lambda", "cloudformation"]
    }
  },
  "resources": [
    "file://README.md",
    "file://infrastructure/**/*.yaml",
    "file://docs/deployment.md"
  ]
}

Agen kustom khusus proyek dengan kait

Agen khusus yang menyertakan konteks proyek melalui file statis dan perintah dinamis:

{
  "name": "project-dev",
  "description": "Project development custom agent with git context",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@git"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status"
  ],
  "resources": [
    "file://README.md",
    "file://CONTRIBUTING.md",
    "file://src/**/*.md"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status --porcelain",
        "timeout_ms": 10000
      }
    ]
  }
}

Agen kustom dengan integrasi server MCP

Agen kustom yang mengintegrasikan alat eksternal melalui server MCP:

{
"name": "custom-dev",
  "description": "Development custom agent with external tool integration",
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "timeout": 30000
    },
    "fetch": {
      "command": "fetch-mcp-server",
      "args": ["--timeout", "10"]
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "@git",
    "@fetch/fetch_url"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status",
    "@fetch/fetch_url"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@fetch/fetch_url": "get"
  }
}