エージェントの作成と構成
開始方法を選び、エージェントの職責・能力・実行方法・Access を定義します。
エージェントを作成するには、先に使えるランタイムが必要です。ランタイムは、そのエージェントがどのコンピュータとどの AI コーディングツールを使うかを決めます。エージェント側は、長く使うアイデンティティ、指示、能力を保持します。
ワークスペースの エージェント ページで 新規エージェント をクリックします。
開始方法の選択
作成ページには 2 つの方法があります。
| 方法 | 向いている場合 |
|---|---|
| Start blank | エージェントの職責がすでに決まっていて、各項目を自分で記入したい。 |
| Build with AI | まず目標を説明し、Agent Builder に重要な点を確認させてドラフトを生成させたい。 |
Build with AI には、Builder との対話のためにオンラインのランタイムが必要です。どちらの方法でも、作成前に最終的な構成を確認して修正できます。
必須項目
エージェントの作成に必要なのは 2 つだけです。
- 名前 — ワークスペース内で一意である必要があります。
- ランタイム — 実際に作業を実行する環境です。
他の項目はデフォルトのまま作成し、後から調整できます。新しいエージェントは、デフォルトでは作成者だけが実行できます。
説明と指示
説明はチーム向けの短い紹介文です。エージェントの一覧と詳細にだけ表示され、AI コーディングツールのプロンプトには入りません。
指示は毎回の実行時にエージェントへ提供されます。通常は次の内容を書きます。
- 何を担当し、何を担当しないか
- 仕事を受け取ったら最初に何を確認するか
- どの内容の変更を許可するか
- 結果をどう提出するか
- どんなときにメンバーへ確認するか
例：
あなたはフロントエンドの Pull Request をレビューします。
まず変更内容と関連テストを読み、次の点だけを確認します：
- React と TypeScript の正しさ
- アクセシビリティ
- 既存のコンポーネントパターンとの一貫性
コードを直接変更しないでください。指摘は重大度順に issue のコメントに書き、
ブロッカーがなければ、マージできると明確に述べてください。スキルの追加
作成時に、ワークスペースから 1 つ以上のスキルを選べます。
スキルは、エージェント間で再利用できる手法や資料の保存に向いています。このエージェントだけの長期的な要件は、指示に書いてください。
会話の開始例
最初のチャットメッセージを送る前に、このエージェントが得意なことを伝える会話の開始例を3件まで追加できます。新しいチャットを開いたときに、入力欄の上へ表示されます。各候補には短いラベルと完全なプロンプトがあります。選ぶと送信せずに入力欄へ入り、ユーザーが確認・編集できます。
エディターのすぐ下で、新しいチャットでの見え方をそのままプレビューできます。エージェントを編集できる人には、その空の状態に開始例をカスタマイズのリンクが表示され、ここへ直接戻れます。
空のままなら、チャットにはローカライズされた汎用の初期値が表示されます。エージェントの役割と境界に合わせた例のほうが通常は役立ちます。
ランタイム・モデル・思考レベルの選択
ランタイムは、それぞれ 1 つの AI コーディングツールに対応しています。ランタイムを選ぶと、そのツールがサポートするモデルと思考レベルを続けて選べます。一部のツール（Codex など）ではサービスティアも選べます。
- 空のままにすると、ランタイムまたはローカル CLI のデフォルトが使われます。
- モデルを設定すると、それ以降にこのエージェントが受け取る作業でその上書き値が使われます。
- 一部のランタイムはモデルを自分で管理するため、モデル選択は表示されません。
サポートするモデル、セッション再開、スキル、MCP の対応はツールごとに異なります。AI コーディングツール対応表を参照してください。
Access の設定
Access は、どのメンバーがこのエージェントを実行（割り当て、@メンション、チャット）できるかを決めます。
| Access | 意味 |
|---|---|
| Only me | 自分だけが実行できます。デフォルトです。 |
| Entire workspace | ワークスペースの全メンバーが実行できます。 |
| Specific people | 自分と選択したメンバーだけが実行できます。 |
Access を変更できるのはエージェントの owner だけで、ワークスペースの管理者にもできません。ワークスペースの owner と admin はその他の構成を管理できますが、管理者の立場を使って、許可されていないエージェントを実行することはできません。
作成後の設定項目
エージェントの詳細ページでは、続けて次の項目を調整できます。
| 設定 | 役割 |
|---|---|
| 同時実行上限 | 同じエージェントが同時に実行できる作業数。デフォルトは 6 で、上限に達すると以降の作業はキューで待機します。 |
| 環境変数 | AI コーディングツールの起動時に変数を注入します。 |
| カスタム引数 | AI コーディングツールの CLI 引数に 1 つずつ追加されます。 |
| MCP | 対応する AI コーディングツールに MCP サーバー構成を提供します。 |
| インテグレーション | このエージェントが使える外部サービスを接続します。 |
ランタイムが載っているデーモンにも全体の同時実行上限（デフォルト 20）があり、実際の同時実行数は 2 つの小さい方になります。
構成を変更しても、すでに実行中の作業は変わりません。以降の作業は、ランタイムが取得した時点で保存されていたエージェント構成を使います。
環境変数と認証情報
環境変数には、このエージェントが実行時に必要とする限定的な権限の認証情報が向いています。読み取り専用の API キーや、単一スコープのトークンなどです。
custom_env の値は Multica サーバーのデータベースに平文で保存されます。「このマシンから出ない」データではありません。エージェントの一覧・詳細エンドポイントは環境変数の値を一切返さず、キーの個数だけを返します。値のロック解除と変更ができるのはワークスペースの owner と admin だけで、読み取りや変更のたびに監査記録が残ります。実行中のエージェントが管理エンドポイントを呼び出して、他のエージェントの変数を読むことはできません。
本番データベースの管理者パスワードなど、価値の高い長期的な認証情報は使わないでください。
PATH、HOME、MULTICA_* などの実行環境の重要な変数は、ここから上書きできません。
カスタム引数と MCP
カスタム引数は配列として 1 つずつ AI コーディングツールに渡され、シェル展開は行われません。引数名が有効かどうかは対応するツールが判断します。専用フィールドがあるモデル設定を、ここで重ねて指定する必要はありません。
認証情報などのシークレットをカスタム引数に入れないでください。値は子プロセスの argv に残り、同じマシン上の別プロセスから ps や /proc を通じて見える可能性があります。代わりに環境変数（custom_env）を使用してください。デーモンログでは引数値をマスクしますが、OS のプロセス一覧までは保護できません。
MCP 構成にはトークンが含まれることがあり、保存と表示のルールは環境変数と同じです。この項目が表示されるのは、マネージド MCP 構成をサポートするランタイムだけです。サポートしないツールが、構成を保存しただけで MCP 機能を獲得することはありません。
エージェントの複製
複製すると、名前以外のほとんどの作業構成が引き継がれます。指示、会話の開始例、スキル、カスタム引数、アバター、同時実行上限、Access 設定が含まれます。モデル、思考レベル、サービスティアも一緒に引き継がれますが、元のランタイムが利用できず、複製がやむを得ず別のランタイムに移る場合、この 3 つはクリアされるため選び直しが必要です。
環境変数の値と MCP 構成は、どんな場合も複製されません。新しいエージェントで設定し直してください。複製では、元のエージェントのランタイム紐づけと Access 設定が保持されます。
CLI での作成
multica agent create \
--name "Frontend Reviewer" \
--runtime-id <runtime-id> \
--description "フロントエンドの Pull Request をレビューする" \
--instructions "まず変更とテストを読み、レビュー結果は issue のコメントだけに投稿する。"コマンドライン引数の平文はシェル履歴に残ります。stdin と権限を制限したファイルは残りません。
構成の近いエージェントがすでにあるときは、直接コピーできます。
multica agent copy <agent-id>デフォルトでは同じランタイムに複製されます。--runtime-id を付けると別のランタイムへ移せますが、同時に --model の指定が必要です。環境変数、MCP 構成、runtime_config は決して複製されません。ランタイムの紐づけ自体は保持されます。完全なフラグは CLI コマンドリファレンスを参照してください。
次のステップ
- エージェントにタスクを割り当てる — 実際の仕事で構成を検証する。
- スキル — チームの手法を作成、インポート、再利用する。
- デーモンとランタイム — オンライン状態と実行場所のトラブルシューティング。