プロジェクト：ソースとワークスペース
エグゼクティブ・ドシエ（Executive Dossier）は、AMBAの中核となるワークスペース設計です。文書を一時的なWebセッションやクラウドに保存する従来のチャットボットとは異なり、AMBAはお使いのPC上の実フォルダにプロジェクトを固定し、ソースと作業スペースの2つの領域に整理します。
すべての企業データはローカル環境で100%安全に保持・処理され、機密情報が外部クラウドに漏洩するリスクはありません。
📂 ソースと作業スペース
AMBAの各プロジェクトフォルダには2つの領域があります。
プロジェクトフォルダ /
├── 📥 ソース (sources/) (あなたやチャネルから届いたすべてのファイル — エージェントは読み取り専用)
│ ├── uploads/ 手動で追加したファイル
│ └── <ソース>/<YYYY-MM-DD>/ Telegram・Drive・フォルダから届いたファイル（日付別）
└── 🗂️ 作業スペース (それ以外のすべて — 自由に整理)
├── reports/ 既定の成果物の保存先（定期レポートは reports/<YYYY-MM>/）
└── workings/ 下書き・計画書・一時ファイル1. 📥 ソース — 厳格に保護された原本保管庫
すべての入力データはここに置かれます。
- 銀行の入出金明細データ（
.xlsx,.csv） - 請求書、支払台帳、領収書（
.pdf,.csv） - 顧客からのRFP要件定義書、契約書、業者見積書
- 媒体レート表や社内の業務規定ドキュメント
アプリで追加したファイルは sources/uploads/ に保存されます。接続したソース（Telegramグループ、Google Driveフォルダ、ローカルフォルダ）から届いたファイルは、ソースと対象日ごとに整理されます（例: sources/<ソース>/2026-10-07/）。ファイルツリーではソースごとに項目があり、その下に日付が並びます。ソースをクリックすると取り込み履歴（届いたもの、スキップしたものとその理由）を確認できます。
読み取り専用の安全保証
AMBAはソース（PC上の sources/ フォルダ）を、どのモードでもエージェントに対して厳格な読み取り専用として扱います。AIアシスタントは内容の読み取り・データ抽出・照会を行えますが、ソースのファイルを変更・上書き・移動・削除することは一切禁止されており、結果は常に作業スペースの新しいファイルに書き出されます。ソースのファイルをあなた自身が編集することはできます。AMBAは以前の版を保持し、そのファイルから取った数値を要再確認として表示します。
2. 🗂️ 作業スペース — 自由に整理できる領域
ソース以外のすべてが作業スペースです。必須のサブフォルダはなく、あなたとエージェントが自由に整理でき、成果物は指定した場所に保存されます。指定がない場合、AMBAは2つの慣例に従います。
- レポートフォルダ
reports/: 完成した成果物 — Excel（.xlsx）、Word文書（.docx）、スライド、PDFレポート。定期レポートは月ごとのフォルダ（例:reports/2026-10/）に保存されます。 workings/: アシスタントの作業台 — ステップごとの計画書（workings/plans/）、下書き（workings/drafts/）、数式検証用の作業シートや中間照合テーブル。
クリーンデスクモード
作業スペースを常に整然と保つため、AMBAはクリーンデスクモードを標準で有効化しています。workings/ 内の一時ログやデータベースファイルは自動で隠され、計画書や数値確認に必要な重要ファイルのみが表示されます。すべて表示 を押せばいつでもシステムファイルを確認できます。
3. ✅ 確定版はフォルダではなく状態
成果物は、プロセスによって配信されたとき、またはファイルツリーであなたが確定版に指定したときに確定版になります。保存場所は問いません。独自の final/ フォルダを使い続けることもできます。
実ファイル検証保証
タスク完了前に、システムはその実行が作業スペースに書き出した成果物をPC上で実地検証します。破損や中身のない空ファイルは弾かれ、ExcelやWord、PDFリーダーで即座に開いて活用できる本物のファイルのみを納品します。
バージョン 0.5.13 より前に作成したプロジェクト
以前のプロジェクトは3つの固定フォルダ（input/、workings/、output/）を使っていました。AMBAは一度だけ自動で移行しました。input/ のファイルはソース（sources/uploads/…、ソースから届いたファイルは sources/<ソース>/<日付>/）に移動し、workings/ と output/ は作業スペースの通常のフォルダとしてそのまま残っています。
⚙️ 洗練された3タブ構成のプロジェクト設定
AMBAのプロジェクト管理は、専門エンジニアでなくても直感的に操作できるように設計されています。ヘッダーのプロジェクト設定アイコンをクリックすると、要点に絞られた3つのタブが開きます：
- 基本設定（General）:
- プロジェクト名および概要。
- AIモデル: デフォルトに従う（…） は 設定 → AIモデル に従います。モデルを選ぶとプロジェクト独自のモデルになります。チャットでモデルを選んだエージェントはそれを使い続けます（エージェント → プロジェクト → デフォルト）。
- 成果物出力言語の選択（
ja,en,vi,ko）。 - PC上の実フォルダパスの確認と管理。
- 権限とセキュリティ（Permissions & Security）:
- 直感的な許可（Allow）・遮断（Deny）切り替えコントロール。
- ファイルシステム・サンドボックス、Web検索・最新情報取得、MCPツールの個別設定。
- 危険ゾーン（Danger Zone）:
- 誤操作を防ぐ2重確認セーフティを備えた安全なプロジェクト削除。
ネイティブ設計の利点
AMBAでは、スプレッドシートの数式計算やSQL分析エンジンは高速なRustランタイムに直接内蔵されており、業務のスケジュール管理は専門エージェントのプロファイル、プロセス、ソースによって自然に遂行されます。これにより、余分な技術設定タブを排除し、極めてシンプルで集中しやすい設定画面を実現しています。
🖱️ AMBA Studioでの直感的な操作
デスクトップアプリのスタジオ画面から、スムーズに操作できます。
- ドラッグ＆ドロップ: デスクトップからソースへファイルを直接ドラッグして追加（
sources/uploads/に保存されます）。 - フォルダを一発表示: ヘッダーのフォルダアイコンをクリックすれば、Finderやエクスプローラーで実際のフォルダを即座に開けます。
- ワンクリックプレビューと印刷: 最終成果物をクリックするだけで即座にプレビュー表示、既定アプリでの起動、またはPDF印刷がワンクリックで完了します。
🧠 エージェントがプロジェクトを把握する仕組み
エージェントはプロジェクトの中身を推測しません。実行のたびに、AMBA はこのパソコン上のファイルから作った、出典付きの簡潔な概要をエージェントに渡します。
- ファイル: ブックごとのシート、見出し行、列 (数値・日付・文字)、行数、日付の範囲、合計行。文書とスライドのタイトルと見出し。受信ファイルの営業日。通貨と数値の書式。
- ファイルで確認した数値: エージェントがツールで数値を読むと、出典 (ファイル・シート・セル) と一緒に記録します。AMBA はそのセルを開いて値を確かめてから保存します。完成した結果の主要数値も同じように保存されます。
- あなたのルール: チャットで伝えたこと (「会計年度は4月始まり」「常に円、小数なし」) は、あなたの言葉のまま保存されます。
ファイルが変わると、そこから取った数値は 再確認が必要 になり、エージェントはファイルを読み直します。一覧にないものはファイルから読むか確認し、推測はしません。
プロジェクトのヘッダー → エージェントが把握していること で全体を確認できます。誤りがあれば 削除 してください。プロジェクトフォルダ (.amba/context.json、隠しファイル) に保存されるのでプロジェクトと一緒に移動し、選んだ AI モデルへのリクエスト (プライバシーマスキング適用) 以外でパソコンの外に出ることはありません。
以前のバージョンのメモリ
以前のバージョンでは、別のメモリにメモを保存することもできました（回答の ナレッジを取り込む、設定 → メモリ）。現在の AMBA は新しいメモをそこに保存しません。プロジェクトについてエージェントが知るべきことは エージェントが把握していること にあります。
- 以前に保存したメモは残り、引き続き参照されることがあります。メモを使った回答には 使用したメモリ（n） が表示されます。開くと各メモが見え、誤りや古いものは削除できます。
- チャットのセッションをリセットするときに、そのエージェントまたはプロジェクト全体のメモリを消去できます。
- あるプロジェクトのメモが、別のプロジェクトで作業するエージェントに渡されることはありません。