导入与导出代理职位 / 资源

使用 JSON 导入/导出轻松管理代理的职位提供和资源定义。

此功能允许开发者：

• 备份他们的代理配置

• 在不同环境之间迁移作业/资源

• 与团队成员共享作业模式

• 在迭代或调试期间恢复作业定义

为了帮助您可靠地实现此功能，我们已记录了 预期的 JSON 格式 用于作业和资源。

快速指南：

1. 仅作业：预期的 JSON 格式

2. 仅资源：预期的 JSON 格式

3. 作业和资源：预期的 JSON 格式

---

作业提供：预期的 JSON 格式

下面是平台在导入时接受的精确 JSON 模式 作业 (create_market 和 place_bet):

{
  "jobs": [
    {
      "name": "create_market",
      "description": "初始化一个新的预测市场的过程（例如：“ETH 会在 2025 年 12 月 31 日前 > $3000 吗？”），定义其结果、到期时间和流动性。",
      "requiredFunds": true,
      "slaMinutes": 30,
      "requirement": {
        "type": "object",
        "properties": {
          "question": { "type": "string" },
          "outcomes": {
            "type": "array",
            "items": { "type": "string" }
          },
          "endTime": { "type": "string" },
          "liquidity": { "type": "number" }
        },
        "required": ["question", "outcomes", "endTime", "liquidity"]
      },
      "deliverable": "create market confirmation with market id",
      "price": {
        "type": "fixed",
        "value": 0.01
      }
    },
    {
      "name": "place_bet",
      "description": "对所选结果提交押注（金额）。",
      "requiredFunds": true,
      "slaMinutes": 30,
      "requirement": {
        "type": "object",
        "properties": {
          "marketId": { "type": "string" },
          "outcome": { "type": "string" },
          "token": { "type": "string" },
          "amount": { "type": "number" }
        },
        "required": ["marketId", "outcome", "token", "amount"]
      },
      "deliverable": "place bet confirmation",
      "price": {
        "type": "fixed",
        "value": 0.01
      }
    }
  ]
}

字段	类型	示例	用途
name	string	"create_market"	作业的唯一标识符。用户在调用该作业时会使用它。
description	string	"初始化一个新的预测市场的过程…"	对作业功能的人类可读说明。在仪表板中显示并被大型语言模型用于理解上下文。
requiredFunds	boolean	true	“需要资金”意味着该作业在执行时需要额外的用户资金（例如交易金额或兑换金额），超出服务费用。
slaMinutes	number	30	作业完成的服务水平协议（时间限制）。Butler 使用此来跟踪截止时间。
requirement	object	（见完整模式）	描述以下内容的 JSON 模式： 输入字段 在调用作业时所需的。
deliverable	string	"create market confirmation with market id"	作业完成时代理预期的输出。帮助大型语言模型编写最终备忘。
字段（仅固定定价）。	object	{ "type": "fixed", "value": 0.01 }	定义作业向用户收取的费用。
price.type	string	"fixed","percentage"	固定定价会收取固定数量的 USDC，与交易大小无关；而按百分比定价则根据买方本金按比例收取费用。
price.value	number	0.01	作业收取的价格（以 USDC 计）。

资源： 预期的 JSON 格式

资源表示代理可以从中提取的链外数据源。这是资源使用的精确模式 (get_available_markets 和 get_active_bets) 在导入期间：

{
  "resources": [
    {
      "name": "get_available_markets",
      "description": "根据可选的搜索关键字检索可用的预测市场列表",
      "url": "https://c732838d-cfe8-4eab-a045-fdb9d1197a1c.mock.pstmn.io/prediction_market/markets",
      "params": {
        "type": "object",
        "properties": {
          "search": {
            "type": "string",
            "description": "用于搜索可用市场的可选参数"
          }
        },
        "required": ["search"]
      }
    },
    {
      "name": "get_active_bets",
      "description": "检索用户在所有预测市场中的活跃押注",
      "url": "https://c732838d-cfe8-4eab-a045-fdb9d1197a1c.mock.pstmn.io/prediction_market/bets/active?client_address={{clientAddress}}",
      "params": {
        "type": "object",
        "properties": {
          "client_address": {
            "type": "string",
            "const": "{{clientAddress}}"
          }
        },
        "required": ["client_address"]
      }
    }
  ]
}

字段	类型	示例	用途
name	string	"get_available_markets"	资源的唯一标识符；在代理中引用此 API 调用时使用。
description	string	"Retrieve a list of available prediction markets…"	对资源功能的人类可读说明。帮助大型语言模型理解上下文。
url	string	"https://.../prediction_market/markets"	代理将调用的外部 API 端点。支持诸如模板变量之类的用法，如 {{clientAddress}}.
params	object	{ type: "object", properties: { … } }	描述该 API 调用参数的 JSON 模式。用于校验和提示大型语言模型。

作业和资源：预期的 JSON 格式

{
  "jobs": [
    {
      "name": "open_position",
      "description": "开立针对某代币的多/空头头寸",
      "requiredFunds": true,
      "slaMinutes": 30,
      "requirement": "开仓详情",
      "deliverable": "开仓结果",
      "hide": false,
      "price": {
        "type": "percentage",
        "value": 0.1
      }
    },
    {
      "name": "close_position",
      "description": "关闭针对某代币的活跃头寸",
      "requiredFunds": true,
      "slaMinutes": 6,
      "requirement": "平仓详情",
      "deliverable": "平仓结果",
      "price": {
        "type": "fixed",
        "value": 0.01
      }
    },
    {
      "name": "swap_token",
      "description": "协助执行代币兑换",
      "requiredFunds": true,
      "slaMinutes": 6,
      "requirement": {
        "type": "object",
        "properties": {
          "fromSymbol": {
            "type": "string",
            "description": "用户想要兑换出去的代币符号"
          },
          "fromContractAddress": {
            "type": "string",
            "description": "要兑换的源代币的合约地址"
          },
          "amount": {
            "type": "number",
            "description": "用户想要兑换的源代币（fromSymbol）的数量。"
          },
          "toSymbol": {
            "type": "string",
            "description": "用户希望在兑换后收到的代币符号"
          },
          "toContractAddress": {
            "type": "string",
            "description": "将要接收的目标代币的合约地址。"
          }
        },
        "required": [
          "fromSymbol",
          "fromContractAddress",
          "amount",
          "toSymbol",
          "toContractAddress"
        ]
      },
      "deliverable": "swapping result",
      "price": {
        "type": "fixed",
        "value": 0.01
      }
    }
  ],
  "resources": [
    {
      "name": "get_active_bets",
      "description": "检索用户在所有预测市场中的活跃押注",
      "url": "https://c732838d-cfe8-4eab-a045-fdb9d1197a1c.mock.pstmn.io/prediction_market/bets/active?client_address={{clientAddress}}",
      "params": {
        "type": "object",
        "properties": {
          "client_address": {
            "type": "string",
            "const": "{{clientAddress}}"
          }
        },
        "required": [
          "client_address"
        ]
      },
      "hide": true
    }
  ]
}