导入与导出代理工作 / 资源

使用 JSON 导入/导出轻松管理代理的工作报价和资源定义。

此功能允许开发者：

• 备份他们的代理配置

• 在不同环境之间迁移任务/资源

• 与队友共享任务模式

• 在迭代或调试期间恢复任务定义

为帮助你可靠地实现这一点，我们已记录了 预期的 JSON 格式 ，适用于任务和资源。

快速指南：

1. 仅任务：预期 JSON 格式

2. 仅资源：预期 JSON 格式

3. 任务和资源：预期 JSON 格式

---

任务提供项：预期 JSON 格式

以下是平台在导入 任务（create_market 以及 place_bet):

{
  "jobs": [
    {
      "name": "create_market",
      "description": "初始化一个新的预测市场的过程（例如：‘到 2025 年 12 月 31 日，ETH 是否会 > 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": "下注确认",
      "price": {
        "type": "fixed",
        "value": 0.01
      }
    }
  ]
}

字段	类型	示例	用途
name	string	"create_market"	该任务的唯一标识符。用户在调用该任务时使用它。
description	string	"初始化一个新的预测市场……"	对该任务功能的人类可读说明。显示在仪表板中，并供 LLM 理解上下文使用。
requiredFunds	boolean	true	“需要资金”表示执行该任务时，除了服务费之外，还需要用户额外提供资本（例如交易金额或兑换金额）。
slaMinutes	number	30	任务完成的 SLA（时间限制）。Butler 使用它来跟踪截止时间。
requirement	object	（见完整模式）	描述 输入字段 ，即调用该任务时所需的内容。
deliverable	string	"create market confirmation with market id"	任务完成时代理应返回的预期输出。帮助 LLM 撰写最终备忘录。
price	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	"检索可用预测市场列表……"	对该资源功能的人类可读说明。帮助 LLM 理解上下文。
url	string	"https://.../prediction_market/markets"	代理将调用的外部 API 端点。支持诸如 {{clientAddress}}.
params	object	{ type: "object", properties: { … } }	描述 API 调用参数的 JSON 模式。用于校验和 LLM 提示。

任务和资源：预期 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": "兑换结果",
      "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
    }
  ]
}