Agent Guide

先了解这些

Agent 只处理你当前打开的账本。本地账本和共享账本使用相同能力，不会自动跨账本统计。
查询和计算以设备提交的当前账本数据为准。需要更早或更大范围时，Agent 会请求 App 补充数据。
新增、修改、删除、撤销、创建分类或修改账本设置，都会先显示确认预览。
目标或条件不明确时，Agent 会追问或给出候选，不会猜测后直接改账。

怎么使用

在账本对话里输入 @Agent 和你的需求。
回复一条账本卡片后再提问或修改，这条被引用的记录会成为最明确的目标。
Agent 等待选择或补充信息时，使用卡片里的选项，或者清楚回复“第 2 笔”“金额改成 58”等。
Agent 等待确认时，可以批准、取消，或说明要修改预览中的内容。
处理中可以停止。等待确认或补充信息的任务可以稍后回来继续。

当前能做什么

查询记录

按时间、标题或商户、备注、分类、标签、金额、币种、付款人、参与人、支付方式、支付渠道、订单号、交易号、卡尾号等条件查找。

查看具体字段

找到记录后，可以继续问金额、备注、支付方式、交易时间等，也可以查看已确认的改动摘要。

合计、计数和比较

计算总额、笔数、两段时间或两组记录的差异、预算剩余和最高或最低分组。最终数字由账本数据计算，不由模型猜测。

分组和图表

支持按分类、支付方式、币种、付款人或日期分组，并生成柱状图、折线图或饼图。

多步骤分析

可以先查范围，再筛选其中几笔，然后计算、比较或查看某笔字段。复杂任务会按步骤获取数据，不要求一句话只做一个动作。

AA、结算和报销

支持分摊、谁欠谁、还款或报销计算，也可以在确认后新增结算记录。缺少付款人、参与人或规则时会先追问。

多币种计算

可以按目标币种汇总。优先使用 App 随账本数据提供的参考汇率；缺少目标币种或汇率时会要求补充，不会自行编造。

新增一笔或多笔

可以新增支出或结算，也可以一次准备多笔新增。每笔至少需要金额，以及可识别的标题、商户或说明。

修改单笔或明确的一批

可以修改金额、币种、时间、标题或商户、分类、支付方式、支付渠道、备注和标签。批量修改只接受范围明确、数量有限的目标。

备注和删除

可以创建普通备注、给已有记录追加或替换备注，也可以删除单笔或明确的一批记录。删除始终需要确认。

分类和账本设置

可以创建分类、修改账本名称或默认币种。共享账本仍受 owner、editor、viewer 权限和归档状态限制。

撤销已确认改动

支持撤销可恢复的近期 Agent 改动。撤销本身也是一次新预览，需要再次确认；无法安全恢复时会明确说明。

图片记账

可以识别图片记录或附件并准备记账。图片由独立识别流程处理，识别结果仍要经过正常的预览和确认。

上下文怎么衔接

回复记录

回复具体账本卡片是最可靠的方式。可以直接问“备注是什么”或说“币种改成美元”。

继续上一轮结果

先查“本周交通”，再问“这些一共多少”“最大那笔备注是什么”，Agent 会继续使用刚得到的结果。

选择其中一部分

可以说“第一笔和第三笔”“排除第二笔”“金额最高的那笔”。选择只会在已经展示或刚查询到的有序结果中执行。

回到旧话题

明确说“回到刚才的旅行支出”或引用旧消息，Agent 才会恢复相应话题。新查询不会自动套用无关的旧结果。

多候选

如果“那笔”“第二笔”可能指向多组记录，Agent 会列出可理解的选项让你确认，不会私自选择。

数据已变化

历史结果只用于找回话题。真正回答或修改前，会再次核对当前设备里的记录；找不到时会请求补充范围。

写入、确认和恢复

确认页会展示操作类型、影响数量和主要变化。批量操作请重点核对目标数量。
批准后由 App 在当前设备上写入，服务端不会绕过 App 直接改账。
如果记录在预览后已被修改，版本检查会阻止旧预览覆盖新数据，并提示重新核对。
相关联的多步改动作为一个整体执行，不能完整完成时会整体回退。
App 暂时离线或意外关闭时，会保留必要的待处理状态并继续上报结果；不会因为上报异常重复写账。
停止、取消、权限不足、数据冲突或模型异常都会结束为明确状态，不应一直停留在处理中，也不会静默显示成功。

适合这样问

这些是自然语言示例，不是固定口令。

“查这周交通费，按日期汇总，告诉我哪天最多。”

“今天比昨天多花了多少？再告诉我今天最大那笔的备注。”

“找最近三笔打车，排除第二笔，算另外两笔一共多少。”

“记三笔：早餐 25、地铁 8、午饭 42，都是人民币。”

“把刚才查到的三笔都改成交通分类。”

“回复这条记录：金额改成 60，备注追加可报销。”

“这笔 120 里，80 保留为餐饮，另外新增 40 的交通记录。”

“撤销刚才确认的修改。”

“识别这张小票并准备记账。”

能力边界

不能在一次请求里自动读取所有账本；请先打开目标账本。
不会从云端后台、共享服务或导出文件另行读取账本明细。即使是云端或共享账本，事实仍来自设备提交的当前账本数据。
不能自动导入银行、信用卡或外部支付账单，也不会代替你访问外部账户。
图片内容只进入独立识别流程；主 Agent 使用识别结果，不直接处理图片字节。
不支持范围无限、目标不明的批量写入。多个互不相关的写入需求可能会要求拆成几次完成。
权限、只读状态、归档状态和当前数据版本始终优先于自然语言请求。
AI 可能理解错误。批准前请核对预览，重要统计也建议核对所用范围和记录。

最初に知っておくこと

Agent は現在開いているブックだけを扱います。ローカルブックと共有ブックで同じ機能を使えますが、複数ブックを自動で横断しません。
検索と計算は端末から送られた現在のブックデータに基づきます。より古い、または広い範囲が必要な場合は、App に追加データを求めます。
作成、変更、削除、取り消し、カテゴリ作成、ブック設定変更の前には確認プレビューを表示します。
対象や条件が曖昧な場合は質問または候補を表示し、推測だけで書き込みません。

使い方

ブックの会話で @Agent と依頼内容を入力します。
特定の記録カードに返信してから質問や変更を依頼すると、その記録が最も明確な対象になります。
選択や追加情報を待っている場合は、カードの選択肢を使うか、「2 番目」「金額を 58 に」など明確に答えます。
確認待ちでは、承認、キャンセル、またはプレビュー内容の修正を依頼できます。
処理中は停止できます。確認や追加情報待ちのタスクは後から再開できます。

現在できること

記録を検索

日時、タイトルや店舗、メモ、カテゴリ、タグ、金額、通貨、支払者、参加者、支払方法、支払チャネル、注文番号、取引番号、カード末尾などで検索できます。

項目を確認

検索後に、金額、メモ、支払方法、取引日時などを続けて確認できます。確定済みの変更概要も確認できます。

合計、件数、比較

合計、件数、期間やグループの差、予算残高、最大・最小グループを計算します。最終数値はブックデータから計算されます。

集計とグラフ

カテゴリ、支払方法、通貨、支払者、日付で集計し、棒、折れ線、円グラフを作成できます。

複数ステップの分析

範囲を検索し、その一部を選び、計算・比較・項目確認へ進めます。複雑な依頼では必要なデータを順番に取得します。

割り勘、精算、払い戻し

分担、誰が誰に支払うか、返済や払い戻しを計算し、確認後に精算記録を追加できます。不足する条件は先に質問します。

複数通貨

目標通貨で集計できます。App が提供する参考レートを優先し、不足する通貨やレートは確認します。

1 件または複数件を作成

支出や精算を 1 件または複数件まとめて準備できます。各記録には金額と、識別できるタイトル、店舗、説明のいずれかが必要です。

単一・限定一括変更

金額、通貨、日時、タイトルや店舗、カテゴリ、支払方法、支払チャネル、メモ、タグを変更できます。一括変更は明確で有限な対象だけです。

メモと削除

通常メモの作成、既存メモの追記・置換、単一または限定された複数記録の削除に対応します。削除には確認が必要です。

カテゴリとブック設定

カテゴリ作成、ブック名や既定通貨の変更ができます。共有ブックでは owner、editor、viewer の権限とアーカイブ状態が適用されます。

変更を取り消す

復元可能な最近の Agent 変更を取り消せます。取り消しも新しいプレビューとして再確認が必要です。

画像から記帳

画像記録や添付を認識して記帳を準備できます。画像認識は独立して行われ、結果は通常のプレビューと確認を通ります。

文脈の引き継ぎ

記録への返信

記録カードへの返信が最も確実です。「メモは？」「通貨を USD に変更」のように続けられます。

直前の結果

「今週の交通費を検索」の後に「合計は？」「最大の記録のメモは？」と続けられます。

一部を選択

「1 件目と 3 件目」「2 件目を除く」「金額が最大の記録」のように、表示済みの順序付き結果から選べます。

以前の話題に戻る

「さっきの旅行支出に戻る」と明示するか、以前のメッセージに返信した場合にその話題を復元します。新しい検索に無関係な結果は混ぜません。

複数候補

「それ」「2 件目」が複数の結果を指せる場合、理解しやすい候補を表示して確認します。

データが変わった場合

過去の結果は話題を見つけるためだけに使われます。回答や変更の前に現在の端末データで再確認します。

書き込み、確認、復旧

確認画面には操作、影響件数、主な変更が表示されます。一括操作では対象件数を確認してください。
承認後の書き込みは App が端末上で行います。サーバーが App を迂回して記録を書き換えることはありません。
プレビュー後に記録が変更されていた場合、古い内容で上書きせず再確認を求めます。
関連する複数ステップの変更は一体で実行し、完全に完了できない場合は全体を戻します。
一時的なオフラインや App 終了時も必要な状態を保持し、結果送信を再試行します。同じ変更を重複実行しません。
停止、キャンセル、権限不足、データ競合、AI エラーは明確な状態で終了し、無期限に処理中のままにしません。

入力例

固定コマンドではなく、自然な依頼の例です。

「今週の交通費を日別に集計して、一番多い日を教えて」

「今日は昨日よりいくら多い？今日最大の記録のメモも見せて」

「最近のタクシー 3 件から 2 件目を除いて合計して」

「朝食 25、地下鉄 8、昼食 42 を CNY で記録」

「さっき見つけた 3 件をすべて交通カテゴリに変更」

「この記録を 80 の食費として残し、40 の交通記録を追加」

「さっき確定した変更を取り消して」

「このレシート画像を認識して記帳を準備して」

制限

一度に全ブックを自動集計できません。対象ブックを先に開いてください。
クラウドや共有サービスから別途明細を取得しません。共有ブックでも、事実は端末から送られた現在のブックデータに基づきます。
銀行、クレジットカード、外部決済明細を自動インポートせず、外部口座へアクセスしません。
画像データは独立した認識処理だけに送られ、メイン Agent は認識結果を使います。
無制限または曖昧な一括書き込みは行いません。互いに無関係な変更は複数回に分ける場合があります。
権限、読み取り専用、アーカイブ状態、現在のデータ版が自然言語の依頼より優先されます。
AI は誤ることがあります。承認前にプレビューを確認し、重要な集計は範囲と対象記録も確認してください。

What To Know First

Agent works only in the book you currently have open. Local and shared books use the same abilities, but Agent does not automatically combine books.
Searches and calculations use current book data submitted by your device. If an older or wider range is needed, Agent asks the app for more data.
Creating, updating, deleting, undoing, creating a category, or changing book settings always shows a confirmation preview first.
If a target or condition is unclear, Agent asks or presents choices instead of guessing and writing.

How To Use It

Type @Agent and your request in a book conversation.
Reply to an entry card before asking or changing something. The quoted entry becomes the strongest target.
When Agent needs a choice or more information, use the card options or answer clearly, such as “the second entry” or “change the amount to 58”.
When a preview is waiting, approve it, cancel it, or explain what should change in the preview.
You can stop active processing. Tasks waiting for confirmation or more information can be continued later.

Current Abilities

Search entries

Search by time, title or merchant, note, category, tag, amount, currency, payer, participant, payment method, payment channel, order number, transaction ID, card tail, and more.

Read a specific field

After finding entries, ask for the amount, note, payment method, transaction time, or a summary of confirmed Agent changes.

Totals, counts, and comparisons

Calculate totals, counts, differences between periods or groups, budget remaining, and highest or lowest groups. Final numbers are calculated from ledger data.

Groups and charts

Group by category, payment method, currency, payer, or date, then create bar, line, or pie charts.

Multi-step analysis

Search a scope, select part of the result, then calculate, compare, or read one field. Complex requests may use several data steps.

Splits, settlements, and reimbursement

Calculate shares, who owes whom, repayments, and reimbursements, and create a settlement entry after confirmation. Missing people or rules are requested first.

Multiple currencies

Summarize into a target currency using reference rates supplied by the app. Missing target currency or rates are requested rather than invented.

Create one or many entries

Prepare one or several expenses or settlements. Each entry needs an amount and an identifiable title, merchant, or description.

Update one or a bounded batch

Change amount, currency, time, title or merchant, category, payment method, payment channel, note, and tags. Batch targets must be explicit and limited.

Notes and deletion

Create a normal note, append or replace an entry note, or delete one or a clearly bounded set of entries. Deletion always requires confirmation.

Related combined changes

To turn one entry into separate details, Agent combines update, delete, and create actions in one preview instead of using a separate split shortcut. Partial completion is rolled back.

Categories and book settings

Create a category, rename a book, or change its default currency. Shared books still enforce owner, editor, viewer, read-only, and archive rules.

Undo a confirmed change

Undo supported recent Agent changes. Undo is a new preview that must be confirmed again, and Agent explains when safe restoration is unavailable.

Image-based entry creation

Recognize an image entry or attachment and prepare an entry. Recognition is isolated, and its result still follows the normal preview and confirmation flow.

How Context Continues

Reply to an entry

Replying to a specific card is the most reliable option. Then ask “What is the note?” or say “Change the currency to USD.”

Continue the latest result

After “Find this week's transportation”, ask “What is the total?” or “What is the note on the largest entry?”

Select a subset

Say “the first and third”, “exclude the second”, or “the largest by amount”. Selection runs only on an ordered result already shown or just retrieved.

Return to an older topic

Explicitly say “Go back to the earlier travel expenses” or reply to the older message. A new search does not inherit unrelated old results.

Multiple candidates

If “that entry” or “the second one” could refer to more than one result, Agent presents understandable choices instead of choosing privately.

Data has changed

Old results only help recover the topic. Before answering or writing, Agent checks the entries against current device data and asks for a wider range if needed.

Writes, Confirmation, And Recovery

The confirmation view shows the operation, affected count, and main changes. Check the target count carefully for batch operations.
After approval, the app writes on the current device. The server does not bypass the app and directly change ledger rows.
If an entry changed after the preview was made, a version check blocks the old preview from overwriting newer data.
Related multi-step changes execute as one unit and roll back if the whole change cannot complete.
If the app goes offline or closes temporarily, it keeps the required pending state and retries reporting results without applying the same change twice.
Stop, cancel, insufficient permission, data conflict, and AI errors end in an explicit state. They should not leave the app loading forever or silently claim success.

Example Requests

These are natural-language examples, not fixed commands.

“Group this week's transportation spending by day and tell me which day was highest.”

“How much more did I spend today than yesterday? Then show the note on today's largest entry.”

“Find the latest three taxi entries, exclude the second, and total the other two.”

“Record three entries: breakfast 25, metro 8, lunch 42, all in CNY.”

“Change the three entries you just found to Transportation.”

“Reply to this entry: change the amount to 60 and append note reimbursable.”

“Keep 80 of this 120 entry as Food and create a new 40 Transportation entry.”

“Undo the change I just confirmed.”

“Recognize this receipt image and prepare an entry.”

Boundaries

Agent cannot automatically summarize every book in one request. Open the target book first.
It does not fetch ledger rows separately from a cloud database, shared service, or export. Even for cloud or shared books, ledger facts come from current book data submitted by the device.
It does not automatically import bank, credit card, or external payment statements or access external accounts for you.
Image bytes go only to an isolated recognition flow. The main Agent uses the recognition result rather than processing the image itself.
Unbounded or unclear batch writes are not supported. Several unrelated writes may need to be completed as separate requests.
Permissions, read-only or archived state, and current data versions always take priority over natural-language instructions.
AI can make mistakes. Review every preview before approval, and check the scope and entries behind important calculations.

Agent 使用帮助

Agent 使い方ガイド