SuperAPI AI 工具集

stripe

办公与效率

查看项目

更新于 10-15 17:19

技能介绍

用途:借助已安装的 stripe CLI 管理商户 Stripe 账户中的客户、产品、优惠券、促销代码、付款、发票以及周期性订阅,用于账单计划调整等计费相关操作。

连接方式:先运行 stripe status 查看连接状态。若返回 not_connected,则运行 stripe authorize-url,并只把返回的 connect_url 提供给用户。OAuth 通过 authd 使用动态客户端注册和 PKCE,Stripe 为每个 VM 签发独立公共客户端,因此不会向系统引入共享凭据;凭据不得在对话中索要。OAuth 连接本身即可标识商户账户。

主要能力与用法:运行 stripe list-tools 查看当前可用的 provider 工具目录与 schema,然后用 stripe call-tool --name <tool> --arguments-json '<json-object>' 调用已公布的工具。list-tools 只暴露经审核的 Stripe 工具,并附带各自的 hatch_permission、hatch_action 与 hatch_permission_label;未知或新增的 provider 工具在审核完成前不可用。对于 stripe_api_write,返回的 schema 会列出经审核的 stripe_api_operation_id 及其对应的操作级权限覆盖,未列出的操作 ID 不可用。读取权限遵循用户的连接器设置;Stripe API 写入与反馈需要细粒度审批,敏感操作还可能要求通过 provider URL 确认。

账户上下文:不要向用户索要已连接账户的 acct_... ID。若其他工具需要 stripe_context,先以空参数对象调用已公布的 list_available_accounts_or_orgs 工具,并使用其返回的上下文。若有多个上下文匹配所请求的 live 或 test 模式,应展示其名称并让用户选择,而不是让其粘贴账户 ID。不得自行虚构上下文,也不得在没有 Stripe 返回上下文的情况下调用账户范围工具。

限制:写入或超时失败时不要自动重试,因为其副作用可能已经完成。