日次営業レポート
プレイブックのレポートを使うプロセス
このページでは、上級財務アナリスト・コントローラー プレイブックの 日次営業レポート を プロセス として設定する方法を説明します。ファイル名と金額は例であり、測定結果ではありません。実際の結果はお使いのファイルと選択したモデルによって異なります。
対象: 経理担当から当日の売上・費用ファイルを受け取る店舗・カフェ・飲食店のオーナー 実行: 毎日 18:00（Asia/Ho_Chi_Minh）と 今すぐ実行 を押したとき 送付先: Excel ブックと短いレポート（PDF）をあなたの Telegram チャットへ
1. 一文で設定する
- カタログから 上級財務アナリスト・コントローラー エージェントをインストールし、店舗のプロジェクトを開きます。
- Telegram ボットを一度接続し（設定 → 連携アカウント → Telegram でトークンを貼り付け。外部アカウント連携 参照）、経理グループに追加します。オーナーはボットに一度
/startを送り、AMBA がオーナーのチャットに送れるようにします（下の最初の質問からボットを接続することもできます）。 - プロジェクトを開く → プロセス タブで、例えば次のように書きます：
毎日 18 時に経理グループが送るファイルから日次営業レポートを作って Telegram で私に送って。そこで質問したりボーナスを承認したりできるように。
- 質問にタップで答えます（最大 3 つ）：「経理グループ」はどれか、AMBA が判断できない場合は「私」が誰か（オーナーのチャットを名前で選ぶ）。通貨（VND）、スタッフ一覧ファイル（
sources/uploads/nhan_su.xlsx）、履歴ブック（workings/lich_su_kinh_doanh.xlsx）はプレイブックのレポートに含まれています。 - 各行と AMBAが行うこと を確認します。試してみる（任意）はプロジェクト内の既存ファイルを使い、試し実行用の別フォルダにだけ書き込み、送信される内容を表示します。何も送信されません。その後 オンにする を押します。オーナーのチャットが AMBA にとって初めての場合、先に短いテストメッセージが届きます。
- AMBA を動かし続けます。 プロセスは AMBA が起動中で、コンピューターがスリープしていないときだけ実行されます。設定 → 一般設定 → バックグラウンドとプロセス で バックグラウンドで動作を続ける と 時刻指定のプロセスのためにスリープを防ぐ をオンのままにし（どちらも既定でオン）、サインイン時に AMBA を起動 をオンにします。ウィンドウを閉じても AMBA はトレイ（Windows は通知領域、macOS はメニューバー）に残り、サイドバーに オンのプロセス と次回の実行が表示され、トレイのメニューからすべてのプロセスの一時停止や終了ができます。スリープ中や電源オフのコンピューターを AMBA が起こすことはできません。18:00 には店舗の PC をオンにしておいてください。オフだった場合は、AMBA が再び起動したとき 24 時間以内ならレポートが補完されます。
後から変えるときは、カードの下に書くか（「レポートを 19 時に移して」）、時刻の行をタップして +1時間 → 適用 を押します。
Telegram グループや Google Drive フォルダに送られたファイルは、ソースの sources/<source>/<YYYY-MM-DD>/ に保存されます（受信時に営業日がわかればその日、わからなければ undated/）。レポートはこのフォルダに頼らず、営業日のファイルを AMBA に問い合わせます。
ファイルはどの日のもの？
AMBA は AI を使わず、見つかった最も強い手がかりから判定します。ファイル内の日付列、「Ngày 07/10」のようなタイトル、ファイル名（「0710」「7.10」「ngay7」）、一緒に送られたメッセージ（「hôm qua」= 昨日）、最後に受信時刻（10:00 より前は前日扱い）です。複数日を含むファイルは行ごとに分けられ、重複ファイルや再送されたレポートの旧版は数えません。日付がわからないファイルはレポートの Cần xác nhận（要確認）に挙げられ、AMBA があなたのチャットで一度だけ「このファイルはどの日のもの？」と質問します。そのメッセージに日付で返信してください。ファイルツリーの ソース では、そのようなファイルがある日に 日付待ち N バッジが付き、クリックして日付を自分で設定できます（プロジェクトのソース を参照）。
2. プロセスの処理内容
- 当日の売上・費用ファイル（Excel または CSV）をすべて読み込みます。
1.234.000、1.234.000 ₫、(1.234)のようなベトナム式の金額は数値として読み取られ、金額として読めないセルは推測せずレポートに一覧表示されます。 - 売上、売上原価、その他費用、粗利益、純利益を（列があれば店舗別・商品別に）SQL クエリとブックの数式で計算し、推測はしません。前日および 7 日平均と比較します。
reports/YYYY-MM/YYYY-MM-DD_Bao_cao_kinh_doanh.xlsxと短いレポート（.mdと PDF コピー）を書き出します。workings/lich_su_kinh_doanh.xlsxに営業日ごとに 1 行（日付、売上、費用、利益、可能なら勤務時間と人件費、賞与案、承認済み賞与）を記録します。同じ日に再実行すると、その日の行と自分のレポートファイルだけが置き換わります。重複行は追加されず、他のファイルは上書きされません。- 18:00 にアプリが閉じていた場合、AMBA の再起動時（24 時間以内）に追いつき実行し、実行した日ではなく 実行できなかった日 のレポートを作成します。
3. オーナーが受け取るもの
当日の主要な数値、比較、注目すべき変化を、見出しの太字・箇条書き・列をそろえた小さな表で読みやすく整えた Telegram メッセージが届きます。実行で作成されたブックと PDF が「📊 Báo cáo kinh doanh ngày 11/10/2026」のようなキャプション付きで添付されます。賞与の提案は、エージェントが提案した日だけ表示されます。
送信前に、AMBA はメッセージ内の数値を実行時の Excel ファイルと照合します。矛盾する数値があると、誤った本文の代わりに短い警告が送られ (ファイルは添付されます)、チャットの実行ブロックの 送信に関するメモ に理由が表示されます。
4. 賞与のアドバイス — 助言のみ
利益が出た日には、レポートに 2〜3 案の賞与案 が加わります。各案には金額、当日の純利益に占める割合、賞与後の売上に対する人件費率、勤務時間・シフト・役割による配分（スタッフ一覧から）が示されます。エージェントは履歴ブック（利益の推移、人件費率、スタッフまたはシフトあたりの売上、過去に承認した賞与）に基づいて理由を説明し、履歴が 7 日未満の場合などの注意点も示します。
固定のルールはなく、あなたの代わりに何かが決まることはありません。各案は助言であり、「承認済み賞与」列はあなたが決めるまで空欄のままです。賞与を承認し支払うのはあなたです。
5. Telegram でエージェントに聞き返す
同じ文に書くか（「Telegram で質問したりボーナスを承認したりできるように」）、後からカードの下に一文で追加します（「Telegram で質問と承認ができるようにして」）。するとプロセスはレポートを受け取るのと同じチャットでオーナーに返信し、カードに いつでも — <オーナー> は Telegram で質問・承認できる の行が表示されます。
- オーナーがボットに送るテキストメッセージごとにエージェントが動き、約 1 分以内に同じチャットへ短く返信します（AMBA の起動が必要です）。これがオンになると、レポートの最後に返信を促す一行が付きます。
- 数値について質問できます（例:「sao hôm nay chi phí cao?」）。エージェントはプロジェクトのファイル、履歴ブック、最新のレポートからツールで読み取った数値で答え、ファイルや日付が足りないときは推測せずにそう伝えます。
- 賞与の判断をチャットで伝えられます（例:「duyệt phương án 2」「ok 1,5 triệu」「không thưởng」）。エージェントはあなたの言葉そのままで判断を記録し（エージェントが把握していること に「<あなたの名前>（Telegram）:「duyệt phương án 2」」と表示）、
workings/lich_su_kinh_doanh.xlsxのその日の行の 承認済み賞与 に金額を書き込み、一行で確認します。以降のレポートはこれを承認済みの賞与として扱います。 - やり取りはレポートのカードの下に <あなたの名前> とのやり取り として残るため、続けての質問も前の文脈を踏まえ、PC で全体を読み返せます。
- 「File … thuộc ngày nào?」への返信、他のチャットのメッセージ、ボットのメッセージは質問として扱われません。エージェントの返信中に届いたメッセージは、まとめて順番に答えます。