スタジオ機能を使う
CoBrain のスタジオ機能を使うと、AI エージェントと一緒に要求仕様書を作成できます。
スタジオ機能について
参照文書（Word、PDF、テキストファイルなど）をアップロードするだけで、 AI エージェントが以下の成果物を段階的に作成します：
- システム境界とアクター - システムの責任範囲と利用者などのアクター
- 概念モデル - システムの概念モデル（Mermaid UML）
- ユースケース - 基本・代替・例外フローを含むユースケース
- 要求仕様 - 上記をもとにした要求仕様書
このチュートリアルでは、スタジオ機能を使って要求仕様書を作成する一連の流れを体験できます。
所要時間：約 15 分（AI 生成時間を含む）
事前準備
必要なもの
- CoBrain アカウント（ログイン方法を参照）
- 参照文書（以下のいずれか、最大 10 個）
- テキストファイル（.txt、.md）
- PDF（.pdf）
- Microsoft Word ファイル（.docx）
- Microsoft Powerpoint ファイル（.pptx）
- Webページの URL（公開されているページに限る）
まだログインしていない場合は、ログイン方法を参照して Web アプリにログインしてください。
注意事項
- スタジオの有効期限は作成から7 日間です
- 一日あたりのトークン消費量に上限があります
サンプル資料
手元に参照文書がない、トライアル中で機密情報を入力できないといった事情がある場合は、以下のサンプル資料を使ってスタジオ機能を体験できます。題材ごとに投入する参照文書の形式（Word・PowerPoint・PDF）が異なるので、試したい題材のファイルをダウンロードしてご利用ください。複数のファイルがある題材 [1] は、まとめて投入しても、1 つずつ投入して結果を比べても、自由な使い方でお試しいただけます。
| 題材 | 形式 | サンプルファイル |
|---|---|---|
| [1] パワーウィンドウ制御 | Word × 3 | SW仕様書・HW仕様書・部品仕様書 |
| [2] 在庫・生産管理システム | PowerPoint | 要件定義書（スライド） |
| [3] 在庫・生産管理システム | Word | 要件定義書（機能要件のみ）（[2]と同題材で形式の違いを比較できます） |
| [4] 自動販売機システム | 要件定義書（機能要件・運用要件） |
なお、作成したいシステムの概要を簡単なテキストファイルや Word ファイルにまとめたものでも始められます。たとえば「キッチンタイマーアプリ」を作りたい場合は、どんな機能が必要か・どんな人が使うか・どんな場面で使うか、などをメモした資料でもかまいません。
1. スタジオを作成する
「新しいスタジオ」をクリックすると、スタジオが作られて「参照文書」の画面に移動します。
2. 参照文書を追加する
「参照文書」の画面では、これから要件定義するときに必要となる入力文書をCoBrainにアップロードします。
- ファイル: 枠の中にドラッグ&ドロップするか、枠の上段をクリックしてファイルを選びます
- Webページ: 枠の下段の「WebページのURLから追加」を開き、URL を入力して「取り込む」をクリックします
- 最大 10 個まで追加できます。10 個に達すると枠の中に案内が出て、それ以上は追加できません。続けたい場合は不要な文書を削除してください
- 複数の資料がある場合は、関連性の高いものから順に追加することをおすすめします
- 必要な資料は最初にまとめて追加しましょう
- PDF・Word（.docx）・PowerPoint（.pptx）ファイルに含まれる画像は、AI が自動的にテキスト説明に変換します
- 認証（ログイン）が必要なページは正常に読み取れない場合があります
- サイトのロボット除外設定（
robots.txt）でアクセスが拒否されているページは取り込めません - 取り込み後、元ページが更新された場合は、ファイル一覧の更新ボタンから再取得できます
詳細は制約事項を参照してください。
追加を中止する
取り込み中は枠の上段が進み具合の表示に変わり、「停止」をクリックすると中断できます。時間がかかりすぎる場合や、誤ったファイルを選んでしまった場合にお使いください。ファイルと Web ページのどちらも停止できます。
Web ページは取得する前に大きさが分からないため、何パーセント終わったかは表示せず、取り込み中であることだけをお知らせします。
サイドバーからの追加操作
サイドバーの「参照文書」の行にある「+」をクリックすると、同じ枠がダイアログとして開きます。成果物を作りはじめたあとでも、画面を移らずに追加できます。
追加した文書を確認する
追加した文書は枠の下に一覧で並び、各行にファイルの大きさが表示されます。ファイル名をクリックすると、変換後の参照文書プレビューを確認できます。
こちらのリファレンスを参照してください。
3. 成果物を作成する
参照文書の追加が完了したら、各成果物を順番に作成していきます。 サイドバーに並んでいる成果物を上から順に作成してください（概念モデルの作成は任意です）
Step.1 システム境界とアクターを作成
最初に「システム境界とアクター」の「 作成」ボタンをクリックします。
AI エージェントが参照文書を分析し、以下を生成します：
- 開発するシステムの責任範囲
- 主アクター（システムを直接使う人）
- 副アクター（システムと連携する外部システムなど）
システム境界とアクターを作成すると、AI が考えたシステム名がスタジオ名として自動設定されます。
手動でスタジオ名を変更したい場合は、サイドバーから編集できます。
Step.2 概念モデルを作成（任意）
次に「概念モデル」の「作成」ボタンをクリックします。
AI エージェントが「もの」や「イベント」に着目した概念モデルを Mermaid UML 形式で作成します。
Step.3 ユースケースを作成
「ユースケース」の「作成」ボタンをクリックします。
AI エージェントがユースケースの概要を洗い出し、続けて各ユースケースについて以下をまとめて作成します。
- 基本フロー（正常系の流れ）
- 代替フロー（別のパターン）
- 例外フロー（エラー時の処理）
Step.4 要求仕様を作成
最後に「要求仕様」の「作成」ボタンをクリックします。
これまでに作成したシステム境界、ユースケースをもとに、 AI エージェントが USDM 形式の要求仕様を作成します。
すべてのユースケースの要求の作成が完了すると、続けて仕様を作成するかどうかを、次の工程のボタンで選んでそのまま進められます。
4. 成果物を管理する
バージョン管理
成果物を編集すると、枠が青くなり「ドラフト状態」になります。
- 保存ボタン（ディスクアイコン）：ドラフトの変更を新しいバージョンとして保存
- 破棄ボタン（消しゴムアイコン）：ドラフトの変更を取り消し
ドラフトの成果物が表示されているときにブラウザの「戻る」操作、あるいは再読み込みを行うとその内容は消失します。 こまめに保存することをおすすめします。
過去のバージョンへのロールバック
成果物を過去のバージョンに戻したい場合：
- 戻したいバージョンを選択
- 「現在のバージョンを最新にする」を選択
選択したバージョンと同じ内容をコピーしたものが新しいバージョンとして保存されます。
5. 成果物をダウンロードする
作成した成果物は、ZIP ファイルとしてダウンロードできます。
「ダウンロード」を選択します。
成果物が ZIP ファイルとして保存されます。
6. 要求仕様をレビューする
「要求仕様」へ移動し、ヘッダーの「レビ ュー」をクリックすると、別のタブでレビュー画面が開きます。
- 編集モードのあいだは「レビュー」が出ません。編集を終えてからクリックしてください
- 開くのは、そのとき選んでいるバージョンの要求仕様です
- レビューの実行中にタブを閉じようとすると確認が出ます。閉じるとレビューは中断されます
レビューの実行と指摘の確認は、仕様書をレビューすると同じ操作です。 どの観点で指摘されるかは、主なレビュー観点を参照してください。
よくある質問
スタジオの有効期限が切れたらどうなりますか？
スタジオは作成から 7 日間で有効期限が切れます。期限が切れる前に、必要な成果物をダウンロードしておくことをおすすめします。
途中で参照文書や画像を追加できますか？
どちらも追加できます。追加する場所が分かれています。
- 参照文書: サイドバーの「参照文書」の行にある「+」から追加のダイアログを開きます。成果物を作成している画面からでも、画面を移らずに追加できます
- 画像: チャット入力欄の左にある「+」から「画像を追加」を選びます。モックアップ・図解・手書きスケッチなどを添付すると、システム境界やユースケースの生成・編集の参考情報として渡せます
この会話で参照する文書を絞り込みたい
チャット入力欄の「@参照文書」から、その会話で参照する文書を選び直せます。チェックを外した文書は一覧から消えず半透明で残るため、必要になったらいつでも再度参照に含められます。
成果物の作成順序を変えても大丈夫ですか？
アウトラインの上から下へ順に作成することを強く推奨します。 後の成果物は前の成果物の内容を参照して作成されるため、順序を守ることでより一貫性のある成果物が得られます。
作成に失敗する・途中で止まる場合はどうすればいいですか？
原因と対処は、トラブルシューティングのスタジオ機能のご利用時にまとめています。作成が途中で止まった場合の続きの指示方法や、使用量の上限に達した場合の対処を確認できます。