設定リファレンス - Amazon Q Developer
設定リファレンス設定の概念一般的な設定パターン

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

設定リファレンス

カスタムエージェント設定ファイルは、カスタムエージェントの動作を定義する JSON ドキュメントです。このセクションでは、設定の概念と一般的なパターンの概要を説明します。

設定リファレンス

カスタムエージェント設定ファイル形式、使用可能なフィールド、構文の詳細については、Amazon Q Developer CLI の補足ドキュメントを参照してください。

以下を実行して、カスタムエージェント設定ファイルの JSON スキーマを表示することもできます。

/agent schema

設定の概念

カスタムエージェント設定ファイルには、カスタムエージェントの動作のさまざまな側面を制御するいくつかのキーセクションが含まれています。

基本メタデータ

すべてのカスタムエージェントには、識別とドキュメントの基本的なメタデータを含めることができます。

  • 名前 - カスタムエージェントの識別子 (指定されていない場合はファイル名から派生）

  • 説明 - カスタムエージェントの目的に関する人間が読める説明

ツール設定

ツール設定は、カスタムエージェントで使用できるツールとその動作を制御します。

ツール

組み込みツールや MCP サーバーツールなど、カスタムエージェントが使用できる可能性のあるすべてのツールを一覧表示します。

allowedTools

ユーザーの確認なしで実行できるツールを指定し、ワークフロー効率を向上させる

toolAliases

ツールの代替名を提供します。命名競合の解決やショートカットの作成に役立ちます。

toolsSettings

許可されたファイルパスやサービスアクセス許可など、個々のツールに対する特定の動作を設定します。

MCP サーバーの設定

このセクションでは、カスタムエージェントがアクセスできるモデルコンテキストプロトコルサーバーmcpServersを定義します。各サーバー設定には以下が含まれます。

  • コマンド - MCP サーバーを起動するための実行可能コマンド

  • 引数 - サーバーのコマンドライン引数

  • 環境変数 - サーバープロセスの環境設定

  • タイムアウト設定 - リクエストタイムアウト設定

MCP 統合の詳細については、「Amazon Q Developer での MCP の使用」を参照してください。

リソースとコンテキスト

カスタムエージェントは、次の 2 つのメカニズムを使用して関連するコンテキストを自動的に含めることができます。

リソース

カスタムエージェントのコンテキストに含めるファイルとディレクトリ。柔軟なファイル選択のための glob パターンをサポート

hooks

特定のトリガーポイント (カスタムエージェントの起動やユーザー入力など) で実行し、出力をコンテキストに含めるコマンド

一般的な設定パターン

最小カスタムエージェント設定

事前承認された読み取りアクセスを持つ基本的なファイルオペレーションを提供するシンプルなカスタムエージェント。

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

特殊なワークフローのカスタムエージェント

特定のツールのアクセス許可を持つ AWS インフラストラクチャ管理用に設定されたカスタムエージェント。

{
"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"
  ]
}

フックを持つプロジェクト固有のカスタムエージェント

静的ファイルと動的コマンドの両方を通じてプロジェクトコンテキストを含むカスタムエージェント。

{
  "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
      }
    ]
  }
}

MCP サーバー統合によるカスタムエージェント

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"
  }
}