Sine Powers 是独立的工具目录和执行入口。选择组织后即可进入,无需创建项目、准备实例或配置自己的供应商账号。工具的可用性、价格、授权和实际执行能力仍需分别满足。
执行第一个工具
- 登录 Console,选择组织并打开 Powers。
- 在 工具目录 搜索工具,打开工具端点(Endpoint)详情,阅读说明、版本、输入输出契约及运行时支持状态。
- 选择 调用 Endpoint 进入调试,默认使用平台执行。
- 按工具的实际 schema 填写必需参数,核对输入 JSON、价格、可用余额和可选项目归属。
- 明确执行,在结果区和 调用记录 中核对保存的状态、结果与财务详情。
平台执行不需要提交供应商密钥。某个工具出现在目录中,不代表已经有可用执行路由或适用价格;不支持的工具仍可保留在目录并显示原因。
正确填写输入
输入沿用工具契约,按需要提供 body、queryParams、pathParams。字段名称和结构取决于具体 Endpoint,不存在适用于所有工具的通用请求体。pathParams 中的值必须是字符串,完整请求最多 64 KiB。
支持对象字段 schema 的工具可使用页面中的输入助手。助手仅填入契约明确声明的默认值;数组和对象使用 JSON。填入后仍应审阅最终输入,复杂字段可以直接编辑 JSON。
项目是可选的调用归属,不会创建独立凭据目录。Endpoint ID 可能包含 # 或 /;程序接入时必须对整个 ID 编码,不能把一部分当作 URL 片段。
选择自己的供应商账户
要使用自己的供应商账户与凭据,打开 高级 BYOK(自有密钥)。该区域向组织所有者和管理员开放,并受连接写入权限限制。
- 添加当前运行时支持的原厂供应商连接,按表单填写账户标识和凭据。
- 保存后仅显示连接元数据,明文凭据不再返回。保存成功不证明供应商一定接受凭据。
- 回到工具调试页,展开 高级设置:使用自己的账户,明确选择兼容的组织账户。
- 核对费用和输入后执行;回到默认选项才会改用平台执行。
组织 BYOK 不支持自行配置聚合提供商。自有账户调用失败时不会自动切换到平台付费路径或其他供应商。凭据停用可以恢复,撤销不可恢复;更换账户使用新的连接身份。
BYOK 的供应商账单和 Cloud 平台费分开核对。选择自有账户不等于所有费用为零,执行前以页面显示的价格与组织账务为准。
恢复不确定的调用
ACCEPTED、RUNNING、UNKNOWN 都不表示成功。工具可能修改外部数据,因此不要新建请求来“确认”原请求是否成功。
- 已有 Run ID:查询原调用记录或使用 恢复原请求。
- 尚无 Run ID:先检查调用历史;需要恢复提交时,沿用原请求标识、输入、Endpoint 版本、项目和原先选择的自有账户。
- 页面刷新后缺少输入:补回完全相同的原始输入。恢复标识不会保存工具输入、凭据或结果正文。
离开页面不取消服务器执行。只有明确开始另一项工作时才选择“新调用”,并考虑旧任务仍可能运行。运行结果和财务结算是不同状态,应分别查看。
程序接入与用量
打开 API 与 CLI,使用选中 Endpoint 的实际版本和输入契约生成示例。默认平台示例不需要实例参数或供应商连接标识。创建 API 密钥 时,执行授予 toolRun,读取目录授予 catalogRead,读取调用记录授予 runRead;按需要分别增加权限。
调用记录提供当前用户有权查看的组织记录。项目选择不切割该历史目录;按项目核对 Cloud 用量应进入组织 用量 页。工具次数、时长和原生计量保持独立,缺失值不视为零,当前页条数也不是总用量。