SuperAPI AI 工具集

plaid

数据与分析

查看项目

更新于 10-26 18:14

技能介绍

Plaid 技能以 plaid <command> 形式运行,所有命令返回 JSON 供读取。任何命令加 --help 可查看选项。读取默认覆盖所有已连接机构;可通过 --credential-id <id> 限定单一银行,id 来自此前读取结果 body.institutions[]。部分读取支持 --account-id <id>(可重复)限定账户;连接多家机构时需与 --credential-id 配对使用。

连接与断开 首次读取前需一次性连接。运行 plaid status;若返回未连接,将返回的 connect_url 以 Connect Plaid 形式发出,等待用户完成链接后再次运行 status 再读取。不可自行编造 URL、引导至设置或索要银行凭据。用户要求添加其他银行时,运行 status 并将 add_account_url 以 Add financial account 发出,不可复用 connect_url;若缺少 add_account_url,说明暂不支持添加。断开全部已连接机构可运行 plaid disconnect;若返回 disconnect_url,以其链接请用户确认,确认前不得声称已断开;无 URL 则说明已断开。聊天中不支持仅解绑单一机构,应引导用户前往设置中该机构账户行处理。

账户与余额 plaid accounts 列出已连接账户的名称、类型、掩码账号及余额(含 available/current/limit)。无独立 balances 命令,accounts 即余额读取。可用于查看已连接账户、回答某账户余额、账户总额或净资产类问题。

交易与消费 plaid transactions-sync 读取交易历史。首次调用不带 cursor;继续拉取时使用上次返回的 --cursor-map-json <body.next_cursors>(跨所有银行)或 --cursor <next_cursor>(单一机构),直至无更多数据。--count 默认 100、最大 500,按问题需要尽量小。仅首次调用可用 --days-requested <1-730> 设定回溯范围,不可与 cursor 同用。

周期交易 plaid transactions-recurring 返回周期性资金流入(body.inflow_streams,如工资)与流出(body.outflow_streams,如订阅和固定账单),可用于查看订阅和月度账单。

负债 plaid liabilities 在 body.liabilities 下返回信用卡、学生贷款和按揭的余额、利率、最低还款额与到期日,可用于查看欠款或还款日期。

投资 读取持仓前,先用 plaid accounts 确认存在类型为 investment 的账户;若无,跳过读取并告知用户未关联经纪账户,避免触发无意义的授权提示。否则 plaid investments-holdings 返回当前头寸、持仓与证券。买卖与分红活动用 plaid investments-transactions --start-date YYYY-MM-DD --end-date YYYY-MM-DD,通过 --offset/--count(默认 100、最大 500)分页,直至已取数量达到 body.total_investment_transactions。

规则 对用户回复使用通俗语言,不出现命令、标志、字段名、原始 JSON、凭据ID、账户ID或 cursor。账户用文字描述(如“你的 Chase 支票账户”),仅在区分相似账户时可附掩码末几位,不得使用内部 ID。给出数字时说明涉及账户与时间范围。不得输出或复述密钥、令牌、完整账号或路由号;Plaid 仅提供掩码,最多分享掩码,不得重建完整号码。该技能为只读参考,不构成财务建议,不指导买卖、再融资或转账,不保证结果。数据为可能滞后银行的快照,异常时说明可能未完全更新,不得断言错误或完整。读取为空时如实说明,不得编造余额、交易或持仓。交易读取保留 Plaid 原始日期字段;当 Plaid 提供真实入账或授权时刻时,额外输出 UTC 和用户时区的 transaction_posted_at / transaction_authorized_at,仅日期字段保持日期。

限制 仅限读取,不能转账、支付账单、划转资金、开立或关闭账户或修改银行信息,此类操作应引导用户直接使用银行。系统只能看到掩码账号,无法提供电汇或直接存款设置所需的完整账号或路由号。覆盖范围取决于用户关联的机构及银行通过 Plaid 共享的数据;缺失某类账户不是错误,应说明不可用而非视为零。