開発プロセスと設計書フォーマットを編集する
Acsim Desktopのプロジェクトのエージェント設定で、開発プロセスのエージェントと設計書フォーマットを追加・編集し、グループやオーケストレーター指示を整える方法を説明します。
プロジェクトの「エージェント設定」では、AIポータルで使うエージェントの中身を編集できます。エージェントは「開発プロセス」と「設計書」の 2 種類に分かれ、それぞれのタブで編集します。
| 種類 | 何を決めるか | 主な使われ方 |
|---|---|---|
| 開発プロセス | エージェントへの指示(何をどの手順で進めるか)、入力例、AIポータルに出すかどうか | AIポータルの右のエージェント一覧から選んで依頼する |
| 設計書 | 設計書フォーマット(章立てと記載項目のテンプレート)、表示する画面、出力先 | 開発プロセスのエージェントが設計書を作るときの雛形になる |
この画面で編集するのは、今開いているプロジェクトのエージェントだけです。ほかのプロジェクトと共通のひな型を作る場合は エージェント管理とプロジェクトのエージェント設定を使い分ける、ほかのプロジェクトのエージェントを取り込む場合は エージェントをAIで作成し、エージェントセットで共有する を参照してください。
エージェント設定を開く
- 対象のプロジェクトを開きます。
- サイドバー下部の「プロジェクト設定」を選びます。
- 「エージェント設定」を選びます。
左の一覧の上で「開発プロセス」と「設計書」のタブを切り替えます。左にグループの一覧、右に選んだグループのエージェントの一覧が表示され、エージェントを選ぶと編集画面に変わります。
開発プロセスのタブで「要件定義」のグループを選んだ例。左の一覧の先頭に「オーケストレーター指示」があります。
画面上部の見出しの横には、このプロジェクトの元になったエージェントセット(「元のセット: Acsim 標準セット」など)が表示されます。
開発プロセスのエージェントを編集する
開発プロセスのエージェントを選ぶと、次の項目を編集できます。
| 項目 | 内容 |
|---|---|
| 名称 | AIポータルのエージェント一覧に表示される名前 |
| 説明 | このエージェントが何をするか |
| 所属グループ | AIポータルの一覧での分類。「個別エージェント」にもできます |
| ポータル表示 | 「AI ポータルの一覧に出す」をオフにすると、AIポータルのエージェント一覧に表示されなくなります |
| 自動実行 | 「自動実行の対象にする」をオンにすると、「自動実行」の画面から実行できるようになります(自動実行を設定・確認する) |
| 入力例 (プロンプト案) | AIポータルでこのエージェントを選んだときに、入力欄の上に表示される依頼の例 |
| 設計書フォーマット | このエージェントが作る設計書フォーマット。複数選べます。空の場合は依頼内容から自動で選ばれます |
| 指示 (プロンプト) | エージェントへの指示。進め方、確認する観点、出力の形式などを書きます |
編集したら、画面下部の「保存」を選びます。保存した内容は、次にAIポータルで依頼するときから使われます。
開発プロセスのエージェントの編集画面。下にスクロールすると、入力例、設計書フォーマット、指示を編集できます。
プロジェクト固有の変更の例:
- 顧客固有の用語や、レビューで確認する基準を指示に足す
- 今回のプロジェクトで使わないエージェントを「AI ポータルの一覧に出す」からオフにする
- よく使う依頼を入力例に足す
- 特定の設計書だけを作るエージェントにするため、設計書フォーマットを 1 つに絞る
設計書フォーマットを編集する
「設計書」のタブでは、設計書フォーマットを編集します。設計書フォーマットを選ぶと、次の項目を編集できます。
| 項目 | 内容 |
|---|---|
| 名称・説明 | 設計書フォーマットの名前と、どんな設計書かの説明 |
| 所属グループ | 設計書のタブでの分類。「未分類」にもできます |
| 種別 | 作った設計書を表示する画面(基本設計書/技術仕様書/テスト仕様書) |
| 出力フォルダ | 作った設計書を置くフォルダ。種別のフォルダからの相対パスで指定します(例: 03_画面設計/詳細)。空欄の場合は種別のフォルダの直下に置かれます |
| ファイル名の接頭 | ファイル名の先頭に付ける番号(例: 10 → 10_画面一覧.md)。空欄の場合は付きません |
| 設計書テンプレート | 設計書の章立てと記載項目の雛形。設計書を作るときは、この構成に沿って本文が作られます |
設計書フォーマットの編集画面。「設計書テンプレート」に章立てと記載項目を書きます。
設計書フォーマットで編集できるのはテンプレートだけです。設計書を作るときの進め方の指示は、開発プロセスのエージェントと、後述のオーケストレーター指示に書きます。
社内の既存の設計書の書式を使いたい場合は、「エージェントを追加」→「ファイルからエージェントを追加」で手元の設計書を素材にしてフォーマットを作るか、「AIでエージェントを作成」で AI に作らせます(エージェントをAIで作成し、エージェントセットで共有する)。
作った設計書フォーマットを使うには、開発プロセスのエージェントの「設計書フォーマット」で選びます。選ばない場合も、依頼内容に合うフォーマットが自動で選ばれます。
グループを整える
左のグループの一覧の上にある「+」(グループを追加)から、新しいグループを作れます。グループの中のエージェントは、ドラッグで並び替えられます。並び順は、AIポータルのエージェント一覧の並びに反映されます。
オーケストレーター指示を編集する
「開発プロセス」のタブで左の一覧の先頭にある「オーケストレーター指示」では、プロジェクト全体の進め方を AI に伝える「オーケストレーター指示」を編集できます。個々のエージェントの指示よりも広く、プロジェクトのすべての依頼で使われます。
書いておくとよい内容の例:
- プロジェクトの前提(対象業務、スコープ、関係者)
- 成果物の書き方のルール(用語、敬体/常体、図の書き方)
- 確認が必要なときの進め方(途中で確認するか、まとめて提案するか)
AI に編集を頼む
エージェント設定の画面では、右の AI ポータルで「このエージェントの指示に、〇〇の確認を足してください」のように頼むこともできます。AI の変更は変更提案として画面上部に表示され、内容を確認して「適用」すると反映されます。詳しくは AIの変更提案を確認する を参照してください。
元に戻す・ほかのプロジェクトで使う
画面上部の「⋮」から、次の操作ができます。
- エージェント初期化: このプロジェクトのエージェントを、選んだエージェントセットの内容に戻します。自分で追加・編集したエージェントもすべて置き換わります。
- 元のセットへ反映: このプロジェクトのエージェント設定で、元のエージェントセットを置き換えます。元のセットがあるプロジェクトだけに表示されます。
今のプロジェクトのエージェントをほかのプロジェクトでも使う場合は、画面上部の「エージェントセットに追加」を使います。詳しくは エージェント管理とプロジェクトのエージェント設定を使い分ける を参照してください。
編集できないとき
- 閲覧権限では、エージェント設定を変更できません。
- 契約によっては、エージェント機能が使えない場合があります。
- Acsim Web と同期しているプロジェクトで、ほかの人が先に同じエージェントを更新していた場合は、残す内容を選ぶ画面が表示されます。