異常取引一覧 - list-unusual-transactions

Moneytreeシステムによって異常または不審と判定された全ての取引を返します。異常取引の検出結果に、アカウントおよびカテゴリ情報を付加して返します。デフォルトでは直近12ヶ月分、最大120ヶ月分まで拡張できます。

プロンプトの例

• 「異常な取引はある？」
• 「Moneytreeが不審と判定した取引を教えて」

スキーマ

入力パラメータ

名前	型	任意	デフォルト	説明
locale	string	はい	ja	名称のローカライズに使用する言語。指定可能な値: ja, en。ゲストが英語で会話している場合は明示的に en を指定してください。
output	array<string>	はい	content	応答の返却方法を指定します。content はモデル向けのコンパクトなテキストペイロードを返します。structuredContent はプログラムから扱いやすい生の型付きデータを返します。両方を同時に指定することも可能です。指定可能な値: content, structuredContent。
start_date	string	はい	end_date の12ヶ月前	日付範囲の開始日（YYYY-MM-DD 形式、含む）。今日から120ヶ月以上前には設定できません。
end_date	string	はい	今日	日付範囲の終了日（YYYY-MM-DD 形式、含む）。最大期間は120ヶ月です。

出力構造

名前	型	任意	説明
transaction_total_count	number	いいえ	見つかった異常取引の総数。
transactions	array<object>	いいえ	指定した日付範囲内で異常と判定された取引の一覧。
transactions[].transaction_date	string	いいえ	取引が発生した日付。
transactions[].transaction_amount	number	いいえ	取引金額。支出は負数、収入は正数。
transactions[].transaction_description	string	いいえ	取引の説明。Moneytreeが可能な範囲で整形しています。
transactions[].transaction_merchant_name	string	いいえ	この取引について識別されたマーチャント名。
transactions[].account_nickname	string | null	いいえ	ゲストが設定したアカウントのニックネーム。アカウントが照合できない場合は null。
transactions[].institution_name	string | null	いいえ	金融機関の表示名。アカウントが照合できない場合は null。
transactions[].institution_account_name	string	いいえ	金融機関に登録されているアカウント名。account_nickname とは異なります。
transactions[].category_name	string | null	いいえ	カテゴリ名。未分類の場合は null。
transactions[].category_type	string | null	いいえ	expense（支出）または income（収入）。未分類の場合は null。
transactions[].category_parent_name	string | null	いいえ	サブカテゴリの場合、その親カテゴリ名。トップレベルのカテゴリ、または未分類の場合は null。
transactions[].category_entity_key	string | null	いいえ	カテゴリの安定した識別子。ゲスト定義カテゴリ、または未分類の場合は null。
transactions[].account_currency	string | null	いいえ	アカウントの ISO 4217 通貨コード（例: JPY, USD）。アカウントが照合できない場合は null。
transactions[].unusual_transaction_explanation_title	string	いいえ	この取引が異常と判定された理由を説明する短いタイトル。
transactions[].unusual_transaction_explanation	string	いいえ	この取引が異常と判定された理由の詳細な説明。

注記

• 通常の取引と合わせて異常取引を確認したい場合は、unusual_transaction_detection 拡張メトリクスを指定した list-transactions を使用してください。