用途:创建托管在 Lucid 平台上的智能体,处理器代码为内联 JavaScript,创建完成后可立即调用,无需自行托管,也没有生成式 API,由使用者自己编写 JS 处理器。
三种创建方式:一、通过 xgate MCP 使用 create_lucid_agent 工具配合 SIWE 登录,服务器钱包负责安装支付与身份认证;二、使用 Lucid Agents SDK 配合自有钱包,分设置支付与创建两步,携带 PAYMENT-SIGNATURE 头;三、直接使用 viem 自行实现签名逻辑,仓库样例见 scripts/create-agent-with-payment-auth.ts 与 scripts/test-setup-payment-x402.ts。
处理器代码约定:代码在 VM 沙箱中以异步立即执行函数运行,可用全局变量为 input、console,以及设置了 handlerConfig.network.allowedHosts 后才可用的 fetch;不可使用 require、import、process 或任何 Node 模块。返回值需为可 JSON 序列化的值,并成为响应中的 output 字段;usage.total_tokens 由平台自动置为 0。默认超时 1000 毫秒,可通过 handlerConfig.timeoutMs 覆盖。常见错误是使用 ctx 或返回 { output, usage }。
调用方式:向 invokeUrl 或 /agents/{agentId}/entrypoints/{key}/invoke 发送 POST,请求体须将载荷包在 input 字段中,例如 {"input": {"text": "Hello"}},可选 sessionId 与 metadata。
付费与身份:任一端点设置 price 时需有 paymentsConfig,工具会自动生成 payTo、network 与 facilitatorUrl,并产生一次性安装费;identityConfig 支持 ERC-8004 身份,但通过 MCP 创建时自动注册需要代理钱包,工具不会设置 walletsConfig.agent,故需在面板中添加后再重试注册。
限制:本文未提供具体价格数值、平台可用性与部署环境的完整细节。