Contoh - Amazon Q Developer
Agen kustom spesialis AWSAlur kerja pengembangan agen kustomAgen kustom ulasan kodeAgen kustom khusus proyekKiat untuk membuat agen kustom yang efektif

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

Contoh

Bagian ini memberikan contoh praktis konfigurasi agen kustom untuk alur kerja pengembangan umum dan kasus penggunaan.

Agen kustom spesialis AWS

Agen kustom ini dioptimalkan untuk tugas manajemen dan pengembangan infrastruktur AWS. Ini menyediakan akses yang telah disetujui sebelumnya ke alat AWS sambil menyertakan dokumentasi yang relevan.

contoh Konfigurasi agen kustom spesialis AWS
{
  "description": "Specialized custom agent for AWS infrastructure and development tasks",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "use_aws"
  ],
  "allowedTools": [
    "fs_read",
    "use_aws"
  ],
  "toolsSettings": {
    "use_aws": {
      "allowedServices": [
        "s3",
        "lambda",
        "cloudformation",
        "ec2",
        "iam",
        "logs"
      ]
    },
    "fs_write": {
      "allowedPaths": [
        "infrastructure/**",
        "scripts/**",
        "*.yaml",
        "*.yml",
        "*.json"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://infrastructure/**/*.yaml",
    "file://infrastructure/**/*.yml",
    "file://docs/aws-setup.md",
    "file://scripts/deploy.sh"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "aws sts get-caller-identity",
        "timeout_ms": 10000,
        "cache_ttl_seconds": 300
      }
    ]
  }
}

Kasus penggunaan untuk agen kustom ini:

  • Menyebarkan tumpukan CloudFormation

  • Mengelola bucket S3 dan fungsi Lambda

  • Memecahkan masalah layanan AWS

  • Meninjau dan memperbarui infrastruktur sebagai kode

Alur kerja pengembangan agen kustom

Agen kustom ini dirancang untuk tugas-tugas pengembangan perangkat lunak umum, termasuk peninjauan kode, pengujian, dan operasi Git.

contoh Alur kerja pengembangan konfigurasi agen kustom
{
  "description": "General development workflow custom agent with Git integration",
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "timeout": 30000
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@git"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status",
    "@git/git_log",
    "@git/git_diff"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@git/git_log": "log",
    "@git/git_diff": "diff"
  },
  "toolsSettings": {
    "fs_write": {
      "allowedPaths": [
        "src/**",
        "tests/**",
        "docs/**",
        "*.md",
        "*.json",
        "package.json",
        "requirements.txt"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://CONTRIBUTING.md",
    "file://docs/**/*.md",
    "file://package.json",
    "file://requirements.txt"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status --porcelain",
        "timeout_ms": 5000
      },
      {
        "command": "git branch --show-current",
        "timeout_ms": 3000
      }
    ]
  }
}

Kasus penggunaan untuk agen kustom ini:

  • Tinjauan dan analisis kode

  • Menulis dan memperbarui tes

  • Manajemen alur kerja Git

  • Pembaruan dokumentasi

  • Manajemen dependensi

Agen kustom ulasan kode

Agen khusus ini berfokus secara khusus pada tugas peninjauan kode, dengan alat dan konteks yang dioptimalkan untuk menganalisis kualitas kode, keamanan, dan praktik terbaik.

contoh Ulasan kode konfigurasi agen kustom
{
  "description": "Specialized custom agent for code review and quality analysis",
  "tools": [
    "fs_read",
    "execute_bash"
  ],
  "allowedTools": [
    "fs_read",
    "execute_bash"
  ],
  "toolsSettings": {
    "execute_bash": {
      "allowedCommands": [
        "grep",
        "find",
        "wc",
        "head",
        "tail",
        "cat",
        "diff",
        "git diff",
        "git log",
        "eslint",
        "pylint",
        "rubocop"
      ]
    }
  },
  "resources": [
    "file://CONTRIBUTING.md",
    "file://docs/coding-standards.md",
    "file://docs/security-guidelines.md",
    "file://.eslintrc.json",
    "file://.pylintrc",
    "file://pyproject.toml"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git diff --name-only HEAD~1",
        "timeout_ms": 5000,
        "max_output_size": 2048
      }
    ],
    "userPromptSubmit": [
      {
        "command": "find . -name '*.py' -o -name '*.js' -o -name '*.ts' | wc -l",
        "timeout_ms": 3000,
        "cache_ttl_seconds": 60
      }
    ]
  }
}

Kasus penggunaan untuk agen kustom ini:

  • Meninjau permintaan tarik untuk kualitas kode

  • Mengidentifikasi kerentanan keamanan

  • Memeriksa kepatuhan terhadap standar pengkodean

  • Menganalisis kompleksitas dan pemeliharaan kode

  • Menyarankan peningkatan dan peluang refactoring

Agen kustom khusus proyek

Contoh ini menunjukkan cara membuat agen kustom yang disesuaikan dengan proyek tertentu, termasuk alat khusus proyek, dokumentasi, dan proses pembuatan.

contoh Konfigurasi agen khusus proyek
{
  "description": "Custom agent for the mobile app backend project",
  "mcpServers": {
    "docker": {
      "command": "docker-mcp-server",
      "args": ["--socket", "/var/run/docker.sock"]
    },
    "database": {
      "command": "postgres-mcp-server",
      "args": ["--connection", "postgresql://localhost:5432/myapp"],
      "env": {
        "PGPASSWORD": "$DATABASE_PASSWORD"
      }
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@docker",
    "@database"
  ],
  "allowedTools": [
    "fs_read",
    "@docker/docker_ps",
    "@docker/docker_logs",
    "@database/query_read_only"
  ],
  "toolAliases": {
    "@docker/docker_ps": "containers",
    "@docker/docker_logs": "logs",
    "@database/query_read_only": "query"
  },
  "toolsSettings": {
    "fs_write": {
      "allowedPaths": [
        "src/**",
        "tests/**",
        "migrations/**",
        "docker-compose.yml",
        "Dockerfile",
        "requirements.txt"
      ]
    },
    "execute_bash": {
      "allowedCommands": [
        "npm test",
        "npm run build",
        "python manage.py test",
        "docker-compose up",
        "docker-compose down"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://docs/api-documentation.md",
    "file://docs/database-schema.md",
    "file://docker-compose.yml",
    "file://requirements.txt",
    "file://src/config/settings.py"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "docker-compose ps",
        "timeout_ms": 10000,
        "cache_ttl_seconds": 30
      },
      {
        "command": "git status --porcelain",
        "timeout_ms": 5000
      }
    ]
  }
}

Kasus penggunaan untuk agen kustom ini:

  • Mengelola kontainer dan layanan Docker

  • Menjalankan kueri dan migrasi database

  • Membangun dan menguji aplikasi

  • Masalah produksi debugging

  • Memperbarui dokumentasi API

Kiat untuk membuat agen kustom yang efektif

  • Mulai sederhana - Mulailah dengan konfigurasi alat dasar dan tambahkan kompleksitas sesuai kebutuhan

  • Gunakan nama deskriptif - Pilih nama agen khusus yang dengan jelas menunjukkan tujuannya

  • Sertakan konteks yang relevan - Tambahkan dokumentasi proyek dan file konfigurasi ke sumber daya

  • Pra-menyetujui alat yang aman - Sertakan alat berisiko rendah yang sering digunakan di AllowedTools

  • Gunakan kait untuk konteks dinamis - Sertakan status sistem saat ini melalui kait perintah

  • Batasi cakupan alat - Gunakan ToolsSettings untuk membatasi akses alat ke jalur dan layanan yang relevan

  • Uji secara menyeluruh - Verifikasi bahwa konfigurasi agen kustom Anda berfungsi seperti yang diharapkan

  • Dokumentasikan agen kustom Anda - Gunakan deskripsi yang jelas untuk membantu anggota tim memahami tujuan agen kustom