開発プロセスと設計書フォーマットを編集する

最終更新日: 2026年11月7日

Acsim Desktopのプロジェクトのエージェント設定で、開発プロセスのエージェントと設計書フォーマットを追加・編集し、グループやオーケストレーター指示を整える方法を説明します。

対象製品:Acsim Desktop

プロジェクトの「エージェント設定」では、AIポータルで使うエージェントの中身を編集できます。エージェントは「開発プロセス」と「設計書」の 2 種類に分かれ、それぞれのタブで編集します。

種類何を決めるか主な使われ方
開発プロセスエージェントへの指示(何をどの手順で進めるか)、入力例、AIポータルに出すかどうかAIポータルの右のエージェント一覧から選んで依頼する
設計書設計書フォーマット(章立てと記載項目のテンプレート)、表示する画面、出力先開発プロセスのエージェントが設計書を作るときの雛形になる

この画面で編集するのは、今開いているプロジェクトのエージェントだけです。ほかのプロジェクトと共通のひな型を作る場合は エージェント管理とプロジェクトのエージェント設定を使い分ける、ほかのプロジェクトのエージェントを取り込む場合は エージェントをAIで作成し、エージェントセットで共有する を参照してください。

エージェント設定を開く

  1. 対象のプロジェクトを開きます。
  2. サイドバー下部の「プロジェクト設定」を選びます。
  3. 「エージェント設定」を選びます。

左の一覧の上で「開発プロセス」と「設計書」のタブを切り替えます。左にグループの一覧、右に選んだグループのエージェントの一覧が表示され、エージェントを選ぶと編集画面に変わります。

開発プロセスのタブで「要件定義」のグループを選んだ例。左の一覧の先頭に「オーケストレーター指示」があります。

画面上部の見出しの横には、このプロジェクトの元になったエージェントセット(「元のセット: Acsim 標準セット」など)が表示されます。

開発プロセスのエージェントを編集する

開発プロセスのエージェントを選ぶと、次の項目を編集できます。

項目内容
名称AIポータルのエージェント一覧に表示される名前
説明このエージェントが何をするか
所属グループAIポータルの一覧での分類。「個別エージェント」にもできます
ポータル表示「AI ポータルの一覧に出す」をオフにすると、AIポータルのエージェント一覧に表示されなくなります
自動実行「自動実行の対象にする」をオンにすると、「自動実行」の画面から実行できるようになります(自動実行を設定・確認する)
入力例 (プロンプト案)AIポータルでこのエージェントを選んだときに、入力欄の上に表示される依頼の例
設計書フォーマットこのエージェントが作る設計書フォーマット。複数選べます。空の場合は依頼内容から自動で選ばれます
指示 (プロンプト)エージェントへの指示。進め方、確認する観点、出力の形式などを書きます

編集したら、画面下部の「保存」を選びます。保存した内容は、次にAIポータルで依頼するときから使われます。

開発プロセスのエージェントの編集画面。下にスクロールすると、入力例、設計書フォーマット、指示を編集できます。

プロジェクト固有の変更の例:

  • 顧客固有の用語や、レビューで確認する基準を指示に足す
  • 今回のプロジェクトで使わないエージェントを「AI ポータルの一覧に出す」からオフにする
  • よく使う依頼を入力例に足す
  • 特定の設計書だけを作るエージェントにするため、設計書フォーマットを 1 つに絞る

設計書フォーマットを編集する

「設計書」のタブでは、設計書フォーマットを編集します。設計書フォーマットを選ぶと、次の項目を編集できます。

項目内容
名称・説明設計書フォーマットの名前と、どんな設計書かの説明
所属グループ設計書のタブでの分類。「未分類」にもできます
種別作った設計書を表示する画面(基本設計書/技術仕様書/テスト仕様書)
出力フォルダ作った設計書を置くフォルダ。種別のフォルダからの相対パスで指定します(例: 03_画面設計/詳細)。空欄の場合は種別のフォルダの直下に置かれます
ファイル名の接頭ファイル名の先頭に付ける番号(例: 10 → 10_画面一覧.md)。空欄の場合は付きません
設計書テンプレート設計書の章立てと記載項目の雛形。設計書を作るときは、この構成に沿って本文が作られます

設計書フォーマットの編集画面。「設計書テンプレート」に章立てと記載項目を書きます。

設計書フォーマットで編集できるのはテンプレートだけです。設計書を作るときの進め方の指示は、開発プロセスのエージェントと、後述のオーケストレーター指示に書きます。

社内の既存の設計書の書式を使いたい場合は、「エージェントを追加」→「ファイルからエージェントを追加」で手元の設計書を素材にしてフォーマットを作るか、「AIでエージェントを作成」で AI に作らせます(エージェントをAIで作成し、エージェントセットで共有する)。

作った設計書フォーマットを使うには、開発プロセスのエージェントの「設計書フォーマット」で選びます。選ばない場合も、依頼内容に合うフォーマットが自動で選ばれます。

グループを整える

左のグループの一覧の上にある「+」(グループを追加)から、新しいグループを作れます。グループの中のエージェントは、ドラッグで並び替えられます。並び順は、AIポータルのエージェント一覧の並びに反映されます。

オーケストレーター指示を編集する

「開発プロセス」のタブで左の一覧の先頭にある「オーケストレーター指示」では、プロジェクト全体の進め方を AI に伝える「オーケストレーター指示」を編集できます。個々のエージェントの指示よりも広く、プロジェクトのすべての依頼で使われます。

書いておくとよい内容の例:

  • プロジェクトの前提(対象業務、スコープ、関係者)
  • 成果物の書き方のルール(用語、敬体/常体、図の書き方)
  • 確認が必要なときの進め方(途中で確認するか、まとめて提案するか)

AI に編集を頼む

エージェント設定の画面では、右の AI ポータルで「このエージェントの指示に、〇〇の確認を足してください」のように頼むこともできます。AI の変更は変更提案として画面上部に表示され、内容を確認して「適用」すると反映されます。詳しくは AIの変更提案を確認する を参照してください。

元に戻す・ほかのプロジェクトで使う

画面上部の「⋮」から、次の操作ができます。

  • エージェント初期化: このプロジェクトのエージェントを、選んだエージェントセットの内容に戻します。自分で追加・編集したエージェントもすべて置き換わります。
  • 元のセットへ反映: このプロジェクトのエージェント設定で、元のエージェントセットを置き換えます。元のセットがあるプロジェクトだけに表示されます。

今のプロジェクトのエージェントをほかのプロジェクトでも使う場合は、画面上部の「エージェントセットに追加」を使います。詳しくは エージェント管理とプロジェクトのエージェント設定を使い分ける を参照してください。

編集できないとき

  • 閲覧権限では、エージェント設定を変更できません。
  • 契約によっては、エージェント機能が使えない場合があります。
  • Acsim Web と同期しているプロジェクトで、ほかの人が先に同じエージェントを更新していた場合は、残す内容を選ぶ画面が表示されます。

関連ページ