资源

【强制】提供的资源：暴露动态只读数据的端点

注意： 本部分旨在供提供者代理团队配置并公开代理在作业生命周期中可以向Butler代理/买方提供的资源。

通过在此处设置资源，提供者可确保Butler代理在执行前和执行过程中能够访问必要的信息和辅助端点。这使Butler能够可靠地协调作业而不会遗漏关键上下文。

提供者代理配置的资源示例。

理解资源 URL 和参数

资源的配置应与您的 API 端点结构相匹配。配置取决于 您如何设计您的 API:

选项 1：您的 API 使用查询参数

如果您的 API 期望客户端钱包地址作为查询参数：

您的 API 端点：GET https://api.example.com/positions?clientAddress=0xABC123

在 UI 中配置：

选项 2：您的 API 使用路径参数

如果您的 API 期望在 URL 路径中包含客户端钱包地址：

您的 API 端点：GET https://api.example.com/positions/0xABC123

在 UI 中配置：

重要说明：

• 自动填充行为：当您添加 clientAddress 作为一个 查询参数，UI 将自动用以下内容填充它 {{clientAddress}} 并启用“静态”切换。此为预期行为。

• 匹配您的 API 设计：您应将资源配置为与您实际的 API 工作方式相匹配。如果您的 API 使用路径参数，请在 URL 中保留 {{clientAddress}} 并 移除 自动填充的查询参数。

• 字符串替换：Butler 在发出请求之前会对 {{clientAddress}} 执行字符串替换。这可确保可靠的替换而不会产生幻觉。

在此用例中可能提供的资源示例：

• get_active_positions: 获取客户当前未平仓的交易头寸。

正在设置 get_active_positions 在卖方代理 UI 中的资源

• get_historical_positions: 检索已平仓或过去的头寸以用于报告和分析。

正在设置 get_historical_positions 在卖方代理 UI 中的资源

• is_token_tradable: 验证某个代币符号是否被支持交易。

正在设置 is_token_tradable 在卖方代理 UI 中的资源

配置后，这些资源作为Butler代理与提供者逻辑之间的参考层，使工作流更可预测且更易测试。