用途:让智能体读取用户 Link 关联的金融数据,回答交易、支出模式、账户余额、已连接钱包来源及基本汇总等问题,也可使用预计算的购买模式与偏好洞察。全部命令为只读,不移动资金、不发起支付、不修改账户、不暴露支付凭据。
主要能力与命令:insights list-available-types 列出可用洞察及其访问要求;insights list --insight <id> 获取指定洞察;transactions list 查询交易,可用 --start-date、--end-date、--category、--origin、--source 过滤;balances list 查询余额,可用 --source 过滤;sources list 查询已连接账户与来源元数据。
使用方式:先检查认证状态 link-cli auth status --format json,检查 authorization_details 中 type: "source" 的所需动作。未认证时用 auth login 申请所需最小动作;已认证但缺少动作时用 auth upgrade 保留现有会话。示例:link-cli auth login --client-name "<your-agent-name>" --source-actions read_link_transactions --source-actions read_balances --source-actions read_external_transactions --source-actions read_source_details --format json;升级示例:link-cli auth upgrade --client-name "<your-agent-name>" --source-actions read_balances --format json。把返回的 verification_url 交给用户,并按 _next 指令或轮询 link-cli auth status --interval 5 --max-attempts 60 --format json,认证成功前不要继续。
数据要点:金额均为最小货币单位整数,需按 ISO 4217 小数位格式化,不能默认除以 100;仅 transactions.amount 用负号表示支出、正号表示入账,余额字段不适用该语义。balance 的 type 为 cash 或 credit,current 为待处理交易前余额,cash.available 与 credit.used 按币种映射,as_of 可能延迟。source_id 可用于跨命令关联数据。
输出与分页:解析、过滤、汇总时优先 --format json;各列表命令支持 --limit(1–100)、--starting-after、--ending-before,has_more 为 true 时取末项 id/source_id 作游标并保持过滤条件不变,无可用游标则停止。
适用场景:查询某月餐饮支出、当前余额、已连接账户,或结合洞察进行商户选择,但洞察结果只表示历史观察,非确定偏好。
限制:不移动资金、不发起支付、不修改来源、不检索无关数据、不请求超出需要的动作、不暴露凭据与完整支付信息;不得默认运行所有列表命令。若洞察状态为 pending 表示未就绪,no_data 需查看 error_code、error_message 与 authorization_remediation;当设置 LINK_ACCESS_TOKEN 时,说明缺失权限但不要通过 CLI 升级。其他功能、收费与平台支持暂未提供。