用途:aixyz 用于从零搭建 AI Agent 项目、向已有 Agent 添加工具、配置 x402 微支付、接入 A2A 与 MCP 协议端点,以及部署到 Vercel。
主要能力:通过 bunx create-aixyz-app 脚手架生成标准项目(含 aixyz.config.ts、app/agent.ts、app/tools/、package.json、vercel.json);每个工具文件默认导出一个 Vercel AI SDK tool,并用 zod 定义输入;agent 使用 ToolLoopAgent。协议端点自动提供:/.well-known/agent-card.json 用于 A2A 发现,/agent 提供 JSON-RPC 与 x402 支付门控,/mcp 向 MCP 客户端共享工具。app/agents/ 下可放置子 Agent,各自获得独立 A2A 端点与 agent card。
支付:通过在 agent 或工具文件导出 accepts 控制是否收费,例如 { scheme: "exact", price: "$0.001" } 或 { scheme: "free" };未导出 accepts 则不注册支付门控。默认 facilitator 为 https://x402.use-agently.com/facilitator,可在 app/accepts.ts 中自定义。配置需提供 x402.network(无回退值)与 x402.payTo。
使用方式:bun run dev 启动开发服务器(默认 http://localhost:3000,可用 -p 改端口);bun run build 生成 Vercel Build Output API v3,再 vercel deploy 部署。环境变量按 Next.js 优先级加载,常用有 X402_PAY_TO、X402_NETWORK、X402_FACILITATOR_URL、OPENAI_API_KEY。默认模型适配器为 @ai-sdk/openai,可替换为 Anthropic、Google、Bedrock 等 AI SDK 适配器。可选的 aixyz erc-8004 register/update 命令支持 --url、--chain-id、--keystore、--broadcast 等参数。
限制:x402.network、x402.payTo 必须显式提供;以 _ 开头的工具文件会被忽略;agent card 若无 skills 则不易被发现;非 TTY 环境下提示会被跳过,需依赖命令行参数或环境变量。具体收费金额、平台支持与效果以实际配置为准,资料未提供定价信息。