翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AgentCore CLI リファレンス
このリファレンスは、パブリック Amazon Bedrock AgentCore CLI リリースを文書化しています。
プロジェクトのライフサイクル
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコアの作成
agentcore create [options]
新しい AgentCore プロジェクトを作成する
パラメータ
-
--name <name>(オプション) -
リソース名 [非インタラクティブ]
-
--project-name <name>(オプション) -
プロジェクト名 (文字で始まる、英数字のみ、最大 23 文字) [非インタラクティブ]
-
--no-agent(オプション) -
エージェントの作成をスキップする [非インタラクティブ]
-
--defaults(オプション) -
デフォルト設定でハーネスプロジェクトを作成する (デフォルト) [非インタラクティブ]
-
--build <type>(オプション) -
ビルドタイプ: CodeZip またはコンテナ (デフォルト: CodeZip) [非インタラクティブ]
-
--language <language>(オプション) -
ターゲット言語: Python または TypeScript (デフォルト: Python) [非インタラクティブ]
-
--framework <framework>(オプション) -
エージェントフレームワーク (ストランド、LangChain_LangGraph、GoogleADK、OpenAIAgents、VercelAI) [非インタラクティブ]
-
--model-provider <provider>(オプション) -
モデルプロバイダー (Bedrock、Anthropic、OpenAI、Gemini) [非インタラクティブ]
-
--api-key <key>(オプション) -
非 Bedrock プロバイダーの API キー [非インタラクティブ]
-
--memory <option>(オプション) -
メモリオプション (なし、shortTerm、longAndShortTerm) [非インタラクティブ]
-
--protocol <protocol>(オプション) -
プロトコル: HTTP、MCP、A2A、AGUI (デフォルト: HTTP) [非インタラクティブ]
-
--type <type>(オプション) -
エージェントタイプ: create または import (デフォルト: create) [非インタラクティブ]
-
--agent-id <id>(オプション) -
Bedrock エージェント ID ( タイプのインポートに必要) [非インタラクティブ]
-
--agent-alias-id <id>(オプション) -
Bedrock エージェントエイリアス ID ( タイプのインポートに必要) [非インタラクティブ]
-
--region <region>(オプション) -
Bedrock エージェントの AWS リージョン ( タイプのインポートに必要) [非インタラクティブ]
-
--network-mode <mode>(オプション) -
ネットワークモード (PUBLIC、VPC) [非インタラクティブ]
-
--subnets <ids>(オプション) -
カンマ区切りサブネット IDs (VPC モードに必要) [非インタラクティブ]
-
--security-groups <ids>(オプション) -
カンマ区切りのセキュリティグループ IDs (VPC モードに必要) [非インタラクティブ]
-
--vpc-id <id>(オプション) -
VPC ID (VPC モードのコンテナビルドに必要) [非インタラクティブ]
-
--idle-timeout <seconds>(オプション) -
アイドルセッションの秒単位のタイムアウト (60～28800) [非インタラクティブ]
-
--max-lifetime <seconds>(オプション) -
秒単位の最大インスタンス有効期間 (60～28800) [非インタラクティブ]
-
--session-storage-mount-path <path>(オプション) -
/mnt のセッションファイルシステムストレージの絶対マウントパス (/mnt/data など) [非インタラクティブ]
-
--efs-access-point-arn <arn>(オプション) -
EFS アクセスポイント ARN (反復可能、--efs-mount-path とペア) [非インタラクティブ] (デフォルト: [])
-
--efs-mount-path <path>(オプション) -
EFS マウントパス (例: /mnt/tools、--efs-access-point-arn とペア) [非インタラクティブ] (デフォルト: [])
-
--s3-access-point-arn <arn>(オプション) -
S3 ファイルアクセスポイント ARN (反復可能、--s3-mount-path とペア) [非インタラクティブ] (デフォルト: [])
-
--s3-mount-path <path>(オプション) -
S3 ファイルマウントパス (例: /mnt/datasets、--s3-access-point-arn とペア) [非インタラクティブ] (デフォルト: [])
-
--with-config-bundle(オプション) -
エージェントテンプレートに有線接続された設定バンドルを作成する [非インタラクティブ]
-
--output-dir <dir>(オプション) -
出力ディレクトリ (デフォルト: 現在のディレクトリ) [非インタラクティブ]
-
--skip-git(オプション) -
git リポジトリの初期化をスキップする [非インタラクティブ]
-
--skip-python-setup(オプション) -
Python 仮想環境のセットアップをスキップする [非インタラクティブ]
-
--skip-install(オプション) -
すべての依存関係のインストールをスキップする (npm インストール、uv 同期) [非インタラクティブ]
-
--dry-run(オプション) -
変更を加えずに作成される内容をプレビューする [非インタラクティブ]
-
--json(オプション) -
JSON として出力 [非インタラクティブ]
-
--model-id <id>(オプション) -
ハーネスのモデル ID [非インタラクティブ]
-
--api-key-arn <arn>(オプション) -
Bedrock 以外のハーネスプロバイダーの API キー ARN [非インタラクティブ]
-
--api-base <url>(オプション) -
ハーネスモデルプロバイダー API エンドポイントの基本 URL (lite_llm) [非インタラクティブ]
-
--additional-params <json>(オプション) -
JSON オブジェクトとしてのプロバイダー固有のハーネスパラメータ (lite_llm) [非インタラクティブ]
-
--no-harness-memory(オプション) -
ハーネスのメモリを無効にする (デフォルト) [非インタラクティブ]
-
--max-iterations <n>(オプション) -
エージェントループの最大反復回数 (ハーネス) [非インタラクティブ]
-
--max-tokens <n>(オプション) -
反復あたりの最大トークン (ハーネス) [非インタラクティブ]
-
--timeout <seconds>(オプション) -
秒単位の最大実行時間 (ハーネス) [非インタラクティブ]
-
--truncation-strategy <strategy>(オプション) -
切り捨て戦略: sliding_window または要約 (ハーネス) [非インタラクティブ]
-
--container <uri-or-path>(オプション) -
コンテナイメージ URI または Dockerfile パス (ハーネス) [非インタラクティブ]
エージェントコアのデプロイ
agentcore deploy|dp [options]
CDK AWS を介してプロジェクトインフラストラクチャを にデプロイします。
パラメータ
-
--target <target>(オプション) -
デプロイターゲット名 (デフォルト: "デフォルト") [非インタラクティブ]
-
-y, --yes(オプション) -
プロンプトの自動確認、env [非インタラクティブ] からの認証情報の読み取り
-
-v, --verbose(オプション) -
リソースレベルのデプロイイベントを表示する [非インタラクティブ]
-
--json(オプション) -
JSON として出力 [非インタラクティブ]
-
--dry-run(オプション) -
[非インタラクティブ] をデプロイせずにデプロイをプレビューする
-
--diff(オプション) -
[非インタラクティブ] をデプロイせずに CDK 差分を表示する
エージェントコア開発
agentcore dev|d [options] [prompt]
ローカル dev サーバーを起動するか、エージェントをローカルで呼び出します。
パラメータ
-
prompt -
実行中の dev サーバーにプロンプトを送信する [非インタラクティブ]
-
-p, --port <port>(オプション) -
開発サーバーのポート。明示的に設定されている場合はそのまま使用されます。デフォルトは、複数ランタイムプロジェクトのランタイムインデックスによってオフセットされます (デフォルト: "8080")。
-
-r, --runtime <name>(オプション) -
実行または呼び出すランタイム (複数のランタイムの場合は必須)
-
-s, --stream(オプション) -
[非インタラクティブ] を呼び出すときのストリームレスポンス
-
-l, --logs(オプション) -
stdout [非インタラクティブ] へのログを使用して dev サーバーを実行する
-
--exec(オプション) -
実行中の開発コンテナでシェルコマンドを実行する (コンテナエージェントのみ) [非インタラクティブ]
-
--tool <name>(オプション) -
MCP ツール名 (「call-tool」プロンプトで使用) [非インタラクティブ]
-
--input <json>(オプション) -
JSON としての MCP ツール引数 (--tool で使用) [非インタラクティブ]
-
--skip-deploy(オプション) -
開発サーバーを起動する前に自動リソースデプロイをスキップする
-
-H, --header <header>(オプション) -
エージェントに転送するカスタムヘッダー (形式: "名前: 値"、繰り返し可能) [非インタラクティブ] (デフォルト: [])
-
-b, --no-browser(オプション) -
ウェブベースのチャット UI の代わりにターミナル TUI を使用する
-
--no-traces(オプション) -
ローカル OTEL トレースコレクションを無効にする
エージェントコアパッケージ
agentcore package|pkg [options]
デプロイせずにエージェントアーティファクトをパッケージ化します。
パラメータ
-
-d, --directory <path>(オプション) -
エージェントコア設定を含むプロジェクトディレクトリ
-
-r, --runtime <name>(オプション) -
指定されたランタイムのみをパッケージ化する
エージェントコアのエクスポート
agentcore export [options] [command]
Strands ランタイムエージェントにハーネスをエクスポートします。
エージェントコアの更新
agentcore update [options] [command]
CLI の更新を確認してインストールする
パラメータ
-
-c, --check(オプション) -
をインストールせずに更新を確認する
エージェントコアの検証
agentcore validate [options]
エージェントコア/設定ファイルを検証します。
パラメータ
-
-d, --directory <path>(オプション) -
エージェントコア設定を含むプロジェクトディレクトリ
-
--json(オプション) -
JSON として出力 [非インタラクティブ]
呼び出しとランタイム
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコア呼び出し
agentcore invoke|i [options] [prompt]
デプロイされたエージェントエンドポイントを呼び出します。
パラメータ
-
prompt -
エージェントに送信するプロンプト。プロンプトが指定されておらず、stdin が TTY [非インタラクティブ] でない場合、パイプ処理された stdin も受け入れます
-
--prompt <text>(オプション) -
エージェントに送信するプロンプト [非インタラクティブ]
-
--prompt-file <path>(オプション) -
ファイルからプロンプトを読み取る (シェル制限を超える長いペイロードまたは構造化ペイロードの場合) [非インタラクティブ]
-
--runtime <name>(オプション) -
特定のランタイムを選択する [非インタラクティブ]
-
--gateway <name>(オプション) -
ゲートウェイを介して を呼び出す [非インタラクティブ]
-
--gateway-target-name <name>(オプション) -
ゲートウェイの HTTP ランタイムターゲット [非インタラクティブ]
-
--target <name>(オプション) -
デプロイターゲットの選択 [非インタラクティブ]
-
--session-id <id>(オプション) -
会話の継続性に特定のセッション ID を使用する
-
--user-id <id>(オプション) -
ランタイム呼び出しのユーザー ID (デフォルト: "default-user")
-
--api-base <url>(オプション) -
ハーネス呼び出しの LiteLLM API ベース URL オーバーライド。非インタラクティブモード
lite_llmの でのみ使用できます。 -
--additional-params <json>(オプション) -
ハーネス呼び出し用の JSON オブジェクトとしての追加の LiteLLM パラメータ。非インタラクティブモード
lite_llmの でのみ使用できます。 -
--payment-user-id <id>(オプション) -
エンドユーザー/ウォレット所有者 ID (デフォルトは --user-id)
-
--payment-instrument-id <id>(オプション) -
支払い手段 (ウォレット) ID
-
--payment-session-id <id>(オプション) -
予算追跡用の支払いセッション ID
-
--auto-session(オプション) -
テスト用の支払いセッションの自動作成/再利用
-
--json(オプション) -
JSON として出力する
-
--stream(オプション) -
リアルタイムでレスポンスをストリーミングする
-
--tool <name>(オプション) -
MCP ツール名 (「call-tool」プロンプトで使用)
-
--input <json>(オプション) -
MCP ツール引数を JSON として (--tool で使用)
-
--exec(オプション) -
ランタイムコンテナでシェルコマンドを実行する
-
--timeout <seconds>(オプション) -
--exec コマンドの秒単位のタイムアウト
-
-H, --header <header>(オプション) -
カスタムヘッダー「名前: 値」 (繰り返し可能)
-
--bearer-token <token>(オプション) -
CUSTOM_JWT 認証のベアラートークン (SigV4 をバイパス)
-
--harness <name>(オプション) -
呼び出す特定のハーネスを選択する
-
--harness-arn <arn>(オプション) -
ARN でハーネスを呼び出す (プロジェクトは不要)
-
--region <region>(オプション) -
AWS リージョン (--harness-arn で必須)
-
--verbose(オプション) -
詳細なストリーミング JSON イベントを印刷する
-
--model-id <id>(オプション) -
モデルを上書きする
-
--model-provider <provider>(オプション) -
モデルプロバイダー。有効な値:
bedrock、open_ai、またはgemini -
--api-key-arn <arn>(オプション) -
open_ai/gemini の API キー ARN
-
--tools <tools>(オプション) -
ツールの上書き (カンマ区切り)
-
--allowed-tools <tools>(オプション) -
許可されたツールを上書きする (カンマ区切り)
-
--skills <paths>(オプション) -
スキル (カンマ区切りパス)
-
--system-prompt <text>(オプション) -
システムプロンプトを上書きする
-
--actor-id <id>(オプション) -
メモリアクター ID を上書きする
-
--max-iterations <n>(オプション) -
最大反復を上書きする
-
--max-tokens <n>(オプション) -
最大トークンを上書きする
-
--harness-timeout <seconds>(オプション) -
タイムアウト秒を上書きする
エージェントコア実行
agentcore exec [options] [command...]
インタラクティブシェルを開くか、デプロイされたエージェントコンテナでワンショットコマンドを実行します。
パラメータ
-
command -
実行するコマンド (ワンショットモード、非インタラクティブ)
-
--it(オプション) -
インタラクティブ PTY シェルセッションを開く
-
--runtime <name|arn>(オプション) -
ターゲットエージェント名またはランタイム ARN (エージェントピッカーをスキップ)
-
--harness <name|arn>(オプション) -
ターゲットハーネス名またはハーネス ARN (エージェントピッカーをスキップ)
-
--session-id <id>(オプション) -
特定のランタイムセッション/VM へのピン留め
-
--shell-id <id>(オプション) -
既存のシェルに再接続する
-
--region <region>(オプション) -
AWS リージョン
-
--bearer-token <token>(オプション) -
CUSTOM_JWT 認証用のベアラートークン (SigV4 をスキップ)
-
--target <name>(オプション) -
デプロイターゲット名 (agentcore.json から)
-
--timeout <seconds>(オプション) -
ワンショットコマンドの秒単位のタイムアウト
-
--json(オプション) -
結果を JSON として出力する (ワンショットモードのみ、--it と互換性がありません)
エージェントコア実行
agentcore run [options] [command]
評価、バッチ評価、または最適化の推奨事項を実行します。
エージェントコアログ
agentcore logs|l [options] [command]
エージェントランタイムログをストリーミングまたは検索します。
パラメータ
-
--runtime <name>(オプション) -
特定のランタイムを選択する
-
--since <time>(オプション) -
開始時刻 — 検索モードでのデフォルトは 1 時間前です (例：「1h」、「30m」、「2d」、ISO 8601)
-
--until <time>(オプション) -
終了時刻 — デフォルトで検索モードになりました (例：「現在」、ISO 8601)
-
--level <level>(オプション) -
ログレベル (エラー、警告、情報、デバッグ) でフィルタリングする
-
-n, --limit <count>(オプション) -
返されるログ行の最大数
-
--query <text>(オプション) -
サーバー側のテキストフィルター
-
--json(オプション) -
JSON 行として出力する
エージェントコアトレース
agentcore traces|t [options] [command]
エージェントトレースを表示およびダウンロードします。
エージェントコアのステータス
agentcore status|s [options]
デプロイされたリソースの詳細とステータスを表示します。
パラメータ
-
--runtime-id <id>(オプション) -
ID で特定のランタイムを検索する
-
--target <name>(オプション) -
デプロイターゲットを選択する
-
--type <type>(オプション) -
リソースタイプ (エージェント、ランタイムエンドポイント、メモリ、認証情報、ゲートウェイ、評価者、オンライン評価、支払い、ポリシーエンジン、ポリシー、config-bundle、データセット、ナレッジベース、ハーネス) でフィルタリングする
-
--state <state>(オプション) -
デプロイ状態 (デプロイ済み、ローカルのみ、保留中の削除) でフィルタリングする
-
--runtime <name>(オプション) -
特定のランタイムにフィルタリングする
-
--name <name>(オプション) -
単一のリソースの詳細を名前で表示する (knowledge-base)
-
--json(オプション) -
JSON として出力する
エージェントコアフェッチ
agentcore fetch [options] [command]
デプロイされたリソースのアクセス情報を取得します。
エージェントコアビュー
agentcore view [options] [command]
ジョブ履歴と詳細を表示する
リソース管理
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコアの追加
agentcore add [options] [command] [subcommand]
プロジェクト設定にリソースを追加します。
エージェントコアの削除
agentcore remove [options] [command] [subcommand]
プロジェクト設定からリソースを削除します。
エージェントコアのインポート
agentcore import [options] [command]
このプロジェクトにランタイム、メモリ、またはスターターツールキットをインポートします。
パラメータ
-
--source <path>(オプション) -
.bedrock_agentcore.yaml 設定ファイルへのパス
-
--target <target>(オプション) -
デプロイターゲット名 (プロジェクトに複数のターゲットがある場合にのみ必要)
-
-y, --yes(オプション) -
プロンプトの自動確認
評価とデータセット
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコアの評価
agentcore evals [options] [command]
過去の実行から保存された評価とバッチ評価の結果を表示します。
エージェントコアのバッチ評価
agentcore batch-evaluations [options] [command] <id>
バッチ評価ジョブとその結果を表示します。
パラメータ
-
id -
表示するバッチ評価ジョブ ID
-
--json(オプション) -
JSON として出力する
エージェントコアデータセット
agentcore dataset [options] [command]
データセットのコンテンツとバージョンを管理する
最適化と設定バンドル
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコア設定バンドル
agentcore config-bundle|cb [options] [command]
設定バンドルの管理 (ID ではなく agentcore.json のバンドル名を使用)
エージェントコアの昇格
agentcore promote [options] [command]
リソースの昇格
エージェントコアアーカイブ
agentcore archive [options] [command]
サービスのバッチ評価またはレコメンデーションをアーカイブ (削除) し、ローカル履歴をクリアします。
オペレーションと設定
v0.28.1 @aws/agentcore から自動生成 — 手動で編集しないでください。
エージェントコアの一時停止
agentcore pause [options] [command]
デプロイされたリソースを一時停止します (オンライン評価設定、A/B テスト）。
エージェントコアの再開
agentcore resume [options] [command]
一時停止したリソースを再開します (オンライン評価設定、A/B テスト）。
エージェントコアの停止
agentcore stop [options] [command]
実行中のバッチ評価または A/B テストを停止します。
エージェントコア設定
agentcore config [options] [key] [value]
テレメトリのオプトアウトステータスなどのグローバル設定を調整する
パラメータ
-
key -
ドット表記の Config キー (例: telemetry.enabled)
-
value -
設定する値
エージェントコアテレメトリ
agentcore telemetry [options] [command]
匿名使用状況分析の設定を管理します。
エージェントコアのフィードバック
agentcore feedback [options] [message]
AgentCore CLI に関するフィードバックをチームに送信します。
パラメータ
-
message -
フィードバックメッセージ [非インタラクティブ]
-
--screenshot <path>(オプション) -
PNG または JPG スクリーンショットへのパス (最大 100MB) [非インタラクティブ]
-
--json(オプション) -
結果を JSON [非インタラクティブ] として出力する
