📥 プロジェクトのソース：届いたファイルを日ごとに

どのプロジェクトにも 2 つの領域があります。

• ソース — あなたやチームが提供したすべてのファイル。Telegram グループ、Google ドライブのフォルダ、このパソコンのフォルダから届いたファイル、Drive ソースが ファイルを一度だけ取り込む… で取り込んだファイル、あなたが自分で追加したファイルです。ディスク上ではプロジェクトの sources/ フォルダです。
• 作業 — それ以外のすべて。あなたとエージェントが自由に整理でき、決まったフォルダはありません。定期レポートは、別の場所を指定しない限り reports/<YYYY-MM>/ に保存されます。

プロジェクトには隠しフォルダ .amba/ もあり、AMBA 自身の状態（プロジェクトについて把握した内容、ファイルの以前の版）を保管しています。開く必要はありません。

ファイルツリーでは 2 つの領域が ソース（取得元 → 日付）と 作業（自由なツリー）として表示されます。

---

1. エージェントはソースを決して変更できません

エージェント、プロセス、Office 処理エンジン、モデルが書いたスクリプト、テスト実行は、ソースを 読む ことはできますが、ソースや .amba/ の中で書き込み・移動・名前の変更・削除は一切できません。これはすべてのファイル操作で、すべてのモードでアプリが強制するもので、設定ではありません。どんな権限や承認でも解除できません。結果は常に作業領域の新しいファイルとして保存されます。

プロジェクトの外にあるファイル（Drive のフォルダ、パソコンのフォルダ）はソースに コピー され、元のファイルはそのまま残り、手を加えられることはありません。

2. あなたはソースのファイルを編集できます

ソースが読み取り専用なのはエージェントに対してだけで、あなたに対してではありません。あなたがファイルを修正した場合（たとえば Excel で）:

• AMBA は以前の版を保管します。ファイルツリーではそのファイルに履歴アイコンが付き、⋯ → ファイルの履歴 で以前の版を確認できます。
• 以前の版に基づく数値やレポートは、再確認が必要として印が付きます。そのファイルの日には 「「…」はレポート「…」で使われた後に変更されました — もう一度実行してください」 と もう一度実行 ボタンが表示されます。

アプリからソースのファイルを削除することもできます。その内容は履歴に残ります。

3. 「最終版」はフォルダではなく状態です

プロセスが届けたファイル、またはあなたが印を付けたファイル（ファイルツリーの 最終版にする、取り消しは 最終版を解除）が 最終版 です。最終版のファイルは保存場所にかかわらず 最終版 バッジが付きます。自分用の final/ フォルダを使い続けてもかまいません。

4. ファイルの種類

ファイルが届くと、AMBA は AI を使わずに次の情報を記録します。

• ファイルが属する 営業日（内容、タイトル、ファイル名、添えられたメッセージ、受信時刻から判断）
• 種類（例：「売上報告」「経費」）。ファイルの構造（シート名、列、タイトル）から判別します
• 送信者、重複か、すでに受け取ったファイルの新しい版か
• どのプロセスの実行やレポートで、いつ使われたか

新しい構造のファイルが初めて届くと、AMBA は一度だけ これはどんな種類のファイルですか？ と候補付きで尋ねます（Telegram のあなたのチャットでも）。一度名前を付ければ、以後その種類のファイルは自動で判別されます。デモの店舗では、2 つの種類に名前を付けるだけで 43 件すべてのファイルが分類されました。プロジェクト設定 → ファイルの種類 で、AMBA が覚えた種類の名前を変えたり、まとめたりできます。

5. ソースはファイルツリーの項目です

ファイルツリーの ソース の下で、取得元ごとに 1 つの項目になります。例：Telegram · 経理グループ、Drive · 支店レポート、フォルダー · 請求書。項目には状態の点があります。緑は 受信中、黄色は要確認（まだファイルなし、一時停止、一時的なエラー）、赤は受信が止まった状態（再ログインが必要、ボットがグループを読めない、フォルダーがない）です。自分で追加したファイルは 自分でアップロード にあります。

各ソースの下には日付が並び、右側の小さなバッジは そのソースの ファイルだけを数えます。

バッジ	意味	クリックすると
✓	その日のファイルがレポートで使われた	どのレポートで、いつ、どの実行か
種類不明 N	新しい形式のファイルがある	このファイルの種類は? — その場で回答
日付待ち N	日付がはっきりしないファイルがある	日付を選ぶ（または 日付なし）
⚠	ファイルはあるがレポートがない、またはレポート後にファイルが変わった	理由と対処ボタン：今すぐ実行、再実行、プロセスを見る、再ログイン

バッジにマウスを重ねると理由が読めます。どの対処もツリーから 2 クリック以内です。種類が不明なファイルには小さな点が付きます。ファイルの ⋯ → ファイルの履歴 で、そのファイルを使ったレポートと AMBA が保管した以前の版を確認できます。

ソースを開く

ソースをクリックすると、ファイルと同じようにタブで開きます（閉じる、開き直す、切り替える）。メイン部分は 取り込み履歴 で、新しい順・日付ごとです。AMBA がソースを確認するたびに、時刻と 1 つの結果が 1 行になります。

• ✓ 新しいファイル N 件 — ファイル名と送信者（Telegram グループ）または「フォルダーから」
• – 新しいファイルなし — 何もない確認が続くと 1 行にまとめます：新しいファイルなし (17 回)
• ⚠ N 件をスキップ — 理由付き：既存ファイルと同じ内容、大きすぎる（Telegram のボットは最大 20 MB まで）、AMBA が読まない種類（インストーラー）、Office の一時ファイル（~$…）、ダウンロードできない Google ファイル
• ✗ N 件をダウンロードできませんでした — 次の「ファイルを取得」で再試行します — ネットワークの切断、Telegram や Google の一時的な障害、他のプログラムが開いているファイルなど。AMBA はそのファイルを覚えておき、次の ファイルを取得 のたびに最初にもう一度試します。取得できると新しい行に 再試行で N 件を取得 と表示され、ファイルは送信された日に入ります。5 回再試行しても取得できない場合は、ファイル名と 再試行 ボタンが表示されます。意図してスキップしたファイル（重複、大きすぎる、読まない種類）は再試行しません。
• ✗ エラー — 例：Google に再ログインが必要です、再ログイン ボタン付き。同じエラーの繰り返しはまとめます：06:00 から 12 回繰り返し

種類が不明なファイルの行には 分類 ボタンがあります。下にスクロール（または さらに表示）で古い履歴を表示します。履歴は 90 日間保管されます。

タブ右側の 設定 ボタンで設定パネルを開閉します。選んだ状態は記憶されます。パネルの内容はソースの種類によります。

• Telegram グループ — ボット、グループ（名前で選択）、日付が不明なら尋ねる（あなた、ディレクトリの誰か、誰にも尋ねない）、Telegram でファイルの種類を尋ねる
• Google ドライブのフォルダー — アカウント（Google が求めたらその場で再ログイン）、フォルダー（名前で選択）、既存ファイルも取り込む
• このコンピューターのフォルダー — パス、既存ファイルも取り込む

どの種類にも ファイルの整理方法 があります。AMBA は Drive フォルダーやこのコンピューターのフォルダーのすべての階層のサブフォルダーを読み取ります。上の階層を指すフォルダーは一度だけ読み、1 回の ファイルを取得 は最大 5,000 ファイルです（残りはもう一度押してください）。

下部には 確認、一時停止 / 再開、ソースを削除 があります。

ファイルの整理方法

ファイルの整理方法 は、ソースのファイルをそのソース自身のフォルダー内のどのフォルダーに置くかを決めます。

• 日ごと（既定）— 業務日ごとに 1 フォルダー（2026-10-07）
• 月ごと — 月ごとに 1 フォルダー（2026-10）
• 年ごと — 年ごとに 1 フォルダー（2026）
• 元のフォルダーのまま（Drive フォルダーとこのコンピューターのフォルダーのみ）— ソース内と同じフォルダー構成（例：Kế toán/Tháng 10/…）

日・月・年で整理するとき、日付が不明なファイルは 日付未定 に入ります。各ファイルの業務日、種類、日ごとのバッジ、プロセスが読むものは整理方法に左右されません。月・年・元のフォルダーで整理すると、日ごとのバッジはソースのタブ上部（業務日ごと）にも表示され、ツリーの月・年フォルダーにはその日々のバッジがまとめて付きます。

新しい整理方法は新しいファイルに適用されます。セットアップで変更して保存すると、既存のファイルを 今すぐ並べ替える か 新しいファイルのみ にするかを尋ねます。並べ替え…（ツリーまたはタブのソースの ⋯）でもいつでも同じことができます。整理方法を選び、N 件のファイルを M 個のフォルダーへ移動します を確認して実行します。同じフォルダーに同名のファイルが 2 つあれば両方残し、2 つ目に (2) が付きます。ファクト、レポート、ファイル履歴、会話内の言及は新しい場所に追従します。変わるのはソース自身のフォルダーだけで、エージェントやプロセスは引き続きソース内のファイルを移動できません。

ソースとそのファイルを削除する

ソースは、自分で受け取ったファイルも一度だけ取り込んだファイルも含め、取り込んだファイルを所有します。ソースを削除 は確認を表示し、このソースが取り込んだ N 件のファイルも削除する（サイズ付き）に最初からチェックが入っています。

• チェックしたまま: それらのファイル、AMBA が保管していた以前の版、取り込み履歴が完全に削除されます。これらのファイルを使った事実やレポートがあれば、再確認が必要になることがダイアログに表示されます。
• チェックを外す: 新しいファイルの受け取りを止め、取り込み済みのファイルは 削除したソース · <名前> としてソースに残ります。この項目もタブで開き、あとで 削除 できます。

プロセスが読んでいるソースは削除できません。先にそのプロセスの ファイルを取得 ステップからソースを外してください。ほかのアプリで開かれていて削除できないファイルがあれば、AMBA はその名前を示し、次回の起動時に再試行します。自分でアップロード のファイルはこれまでどおり 1 件ずつ削除できます。エージェントやプロセスがソース内のものを削除することはありません。

自分でアップロード もタブで開き、追加したファイルを時刻順に表示します。

ファイルの取得

AMBA はバックグラウンドでソースを読みません。ファイルは、あなたが求めたとき、またはそのソースを読むプロセスが実行されたときにソースに入ります。

• ソースのタブ上部の ファイルを取得（またはファイルツリーのソース項目の ⋯ → ファイルを取得、右クリックでも可）で、そのソースを一度読みます。実行中は ファイルを取得中… と表示され、終わると結果（新しいファイルを 2 件取得しました、新しいファイルはありません）が出て、履歴に 手動で取得 の行が増えます。同じボットを使う Telegram グループは一緒に取得されます。
• ソース上部の ⋯ → すべてのソースからファイルを取得 は、プロジェクトの有効なソースを順に取得します。
• 以前のバージョンで「ファイルが届いたら実行」として作ったプロセス（現在は 詳細ステップ）は、取得したファイルが届いたときに引き続き開始されます。新しいプロセスは スケジュール どおりに動きます。
• Telegram はメッセージを約 24 時間しか保持しません。 Telegram ソースを 20 時間以上取得していないと、タブに 最終取得: N 時間前 — Telegram はメッセージを約 24 時間しか保持しません と表示され、点が黄色になります。24 時間を過ぎると赤になり 24 時間より古いメッセージは失われた可能性があります と表示されます。少なくとも 1 日 1 回取得してください。
• プロセスは「ファイルを取得」ステップで取得します。 プロセスがソースを読むのは、ファイルを取得 ステップが実行されたとき（スケジュールどおり、▶ プロセス全体を実行、またはそのステップの ▶（このステップを実行））だけです。ファイルを取得 ボタンとまったく同じで、すぐに取得し、待ちません。後でもう一度確認するには 待機 ともう 1 つの ファイルを取得 ステップを追加します。履歴には プロセス … が取得 と表示されます。手順ごとにテスト では、テスト前にファイルを取得 を選んだときだけソースを読みます。
• AMBA はまだ Telegram で質問を送りません（ファイルの日付や種類はアプリ内で確認します）。プロセスのオーナーとの Telegram のやり取りも引き続き一時停止中です（一時停止中（自動取得が必要））。

ソースを追加する

ソース見出しの ⋯ には ファイルをアップロード と ソースを追加 ▸ Telegram · Drive · フォルダー があります。ソースを追加 は設定パネル付きの新しいタブを開きます。ソースを追加 を押すとソースがツリーに現れ、タブがそのソースのタブになります。Telegram グループを追加すると、そのグループはプロジェクトのディレクトリにも（一度だけ）保存され、プロセスから名前で呼べます。

Drive から一度だけ取り込む。 Google Drive ソースを開き、タブ上部の ファイルを一度だけ取り込む… を押します。Drive ブラウザーがソースのフォルダーで開き、その Google アカウント内のどこからでも名前でファイルを選べます。ファイルはそのソースにコピーされ、受け取ったファイルと同じく日付ごとに整理・分類されます。取り込み履歴には 一度だけ取り込み: N 件 と表示されます。Drive ソースがまだなければ、先に追加してください。

以前 Drive から取り込んだファイル。 以前は一度だけの取り込みが別の項目に置かれていました。プロジェクトを開くと、同じ Google アカウントの Drive ソースがちょうど 1 つある場合、AMBA がそこへ自動で移します（プロセスや把握済みの事実も追従します）。そうでない場合は Drive から取り込み (以前) に表示され、ソースに移す… と 削除 を選べます。

特定の日に属さないファイル（社員名簿、価格表）は、ソースの 日付なし フォルダーか 自分でアップロード にあります。プロセス → ソースとファイルの取得元 も参照してください。

Telegram ソースにファイルが届かないとき

ソースのタブに理由が表示され、設定パネルに対処ボタンがあります。

• キーチェーンへのアクセスが許可されていません — macOS がボットトークンの読み取りをブロックしました。キーチェーンへのアクセスを許可 を押し、macOS に聞かれたら 常に許可 を選んで Mac のパスワードを入力します。確認 でも再試行します。「ファイルを取得」でも一度再試行します。
• 未接続 / ボットトークンが無効です — ボットトークンを再入力 を押し、@BotFather のトークンを貼り付けます。
• ボットが Webhook を使用中 — ボットのメッセージが別のサービスに送られています。確認後に Webhook を無効にする と AMBA がグループを読み取れます。そのサービスを使っていない場合のみ行ってください。
• 別のプログラムがこのボットを読み取り中 — そのプログラム（または起動中の別の AMBA）を停止するか、ボット で別のボットを選びます。ボットを変えるとグループを最初から読み取ります。
• グループが一覧にない — ボットをグループに追加（またはグループでメッセージや /start を送信）してから 再読み込み を押します。

一時的なエラー — 「ファイルを取得」でもう一度 と表示されるのは、ネットワークや Telegram の短い障害のときだけです。

6. バージョン 0.5.13 より前に作ったプロジェクト

以前のプロジェクトは 3 つの固定フォルダ（input/、workings/、output/）を使っていました。アップデート後の最初の起動時に、AMBA が一度だけ移行します。

• input/ のうち取得元から届いたファイルは、ソースのその取得元の日付へ移動します。
• input/ のその他のファイルは、サブフォルダを保ったまま sources/uploads/ へ移動します。
• workings/ と output/ はそのまま、作業領域の通常のフォルダとして残ります。

一度だけ表示されるお知らせ 受け取ったファイルはソースに移りました で、移したファイル数がわかります。プロセス、把握済みの事実、ファイルへの参照も同時に更新されるので、設定し直す必要はありません。移せないファイルがあった場合（たとえば同じ名前で内容の違うファイルがすでにソースにある場合）は何も移動せず、お知らせに理由が表示されます。