コンテンツにスキップ
これは最新の機能を備えた最新リリースですが、長期サポートは提供されません。サポートを継続するには、新しいリリースごとにアップグレードするか、四半期ごとの安定版リリースをご利用ください。

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

arctl init agent

Page as Markdown

新しいエージェントプロジェクトをスキャフォールドします

宣言型 YAML とフレームワークスタブを備えた新しいエージェントプロジェクトのスキャフォールドを作成します。

フレームワーク + 言語をインタラクティブに選択します (-framework / -language で指定することもできます)。次のファイルを書き込みます。

  • agent.yaml – v1alpha1 エンベロープ
  • arctl.yaml – ローカルビルド設定 (フレームワーク + 言語)
  • .env – 選択したフレームワークに必要な環境変数 (gitignore 対象)

ローカル開発用に arctl-init で作成した同階層の MCP プロジェクトを接続するには、-local-mcp を渡します。任意の URL にある MCP (リモート、または arctl で初期化していないローカル MCP) を使用する場合は、init 後に .env を編集して MCP_SERVERS_CONFIG エントリを追加します。例:

MCP_SERVERS_CONFIG=[{“name”:“my-remote”,“type”:“remote”,“url”:“https://mcp.example.com/sse"}]

使用方法

arctl init agent NAME [flags]

例:

arctl init agent myagent
arctl init agent myagent --framework adk --language python
arctl init agent myagent --local-mcp ../my-mcp

コマンド固有のフラグ

--description string: Agent description.
--framework string: Framework (e.g. adk). Skips picker.
--git string: Git repository URL.
--git-branch string: Git branch to record on the agent's source repository.
--git-commit string: Git commit SHA to pin the agent's source repository to.
--image string: Image tag override.
--language string: Language (e.g. python). Skips picker.
--local-mcp strings: Path to a sibling MCP project; wires it into .env so the local agent can reach it. Repeatable.
--mcp strings: Registry MCP server ref (name@version). Repeatable.
--model-name string: Model name.
--model-provider string: Model provider.

グローバルフラグ

-h, --help: Display help information for the command.
--output-dir string: Parent directory under which the project is created. Defaults to the current directory.