AgentCore CLIをインストールしよう
この章では、AgentCore CLIのインストールをハンズオン形式で学習します。これにより、Amazon Bedrock AgentCoreへのエージェントデプロイを1コマンドずつ実行するCLIの準備ができるようになります。
1. AgentCore CLIのインストール
AgentCore CLI は Node.js の npm 経由で配布されるため、前章 Node.jsをインストールしよう が完了していることを前提としています。
ターミナル（Windows: コマンドプロンプト / PowerShell、Mac: ターミナル）で以下のコマンドを実行し、AgentCore CLI をグローバルインストールします。Windows と Mac で共通です。
npm install -g @aws/agentcore
-g（グローバル）オプションを付けることで、システム全体で agentcore コマンドが使えるようになります。パッケージのダウンロードと展開で数十秒かかります。
2. インストールの確認
インストールが完了したら、以下のコマンドでバージョンを確認します。
agentcore --version
以下のようにバージョン番号が表示されれば、AgentCore CLI のインストールは成功です。
@aws/agentcore/x.x.x
利用可能なサブコマンド（create / dev / deploy / invoke / remove など）を確認したい場合は、以下を実行します。
agentcore --help
⚠️ command not found: agentcore と表示される場合 |
|---|
AgentCore CLI がインストールされていない、または npm のグローバルインストール先が PATH に含まれていない可能性があります。まず npm list -g @aws/agentcore を実行して、インストール状態を確認してください。インストール済みの場合は、ターミナルを一度閉じて開き直してから agentcore --version を再度実行してください。それでも解決しない場合は、npm config get prefix で表示されるパスが PATH 環境変数に含まれているかを確認してください。 |
⚠️ npm: command not found と表示される場合 |
|---|
| Node.js がインストールされていません。AgentCore CLI は npm 経由で配布されるため、先に Node.js のインストールが必要です。Node.jsをインストールしよう を完了してから、本章の手順に戻ってください。 |
3. まとめ
この章では、AgentCore CLI のインストールを体験しました。
- AgentCore CLI は Node.js の npm 経由で配布されるため、先に Node.js をインストールしておく
npm install -g @aws/agentcoreにより、グローバルインストールできるagentcore --versionにより、インストールを確認できるcommand not found: agentcoreの場合は、ターミナルを開き直すか、npmのグローバル先がPATHに含まれているかを確認する
これで環境構築は一通り終了です。ここまでで、講座を通じて使う一連のツールを手元にそろえられました。