SuperAPI AI 工具集

lucid-client-api

智能体与模型

查看项目

更新于 10-15 20:34

技能介绍

用途:该技能用于与 Lucid Client API(多智能体运行时,位于 lucid-client 代码库)交互,支持以程序化方式管理智能体、调用入口点以及处理调用支付。

主要能力:智能体管理(列表、创建、获取、更新、删除,以及按 slug 获取公开智能体);智能体调用(获取 A2A 兼容的 agent card 清单、列出入口点、调用入口点);支付处理(入口点需要付费时返回 402 Payment Required,并在响应头中给出 X-Payment-Required、X-Payment-Price、X-Payment-Network、X-Payment-PayTo,客户端完成 x402 支付后携带 PAYMENT-REQUIRED、PAYMENT-SIGNATURE、PAYMENT-RESPONSE 重试);密钥管理(列表、创建、获取、更新、删除智能体密钥);分析(汇总与交易查询);调用记录(列表、单条、统计);身份(重试注册、更新元数据);排行榜(获取与 SSE 流式获取);健康与统计(/health、/health/redis、/api/stats/network);OpenAPI 文档(GET /doc 返回 JSON,Swagger UI 在服务时通常位于 /swagger)。

使用方式:API 基地址开发环境通常为 http://localhost:8787,生产环境通过 VITE_API_URL 环境变量配置。多数端点需通过 Better Auth 认证,会话 Cookie 自动随请求发送;受保护路由为 /api/agents/* 与 /api/secrets/*,公开路由为 /agents/{slug} 与 /agents/{agentId}/.well-known/agent-card.json。代码中请求需设置 credentials: 'include' 并携带 Content-Type: application/json。典型流程包括:GET /api/agents?page=1&limit=10&search=query&enabled=true 列出智能体;POST /api/agents 创建智能体;PUT /api/agents/{agentId} 更新;DELETE /api/agents/{agentId} 删除;POST /agents/{agentId}/entrypoints/{key}/invoke 调用入口点,请求体含 input 与可选 metadata。

适用场景:需要以程序化方式管理智能体、调用入口点、处理付费调用、查询分析或排行榜、管理智能体密钥的场景。

限制:智能体操作均限定于已认证所有者;运行时无状态,智能体由存储的定义动态构建;付费使用 x402(HTTP 原生支付)协议;错误响应为标准结构(error、message、可选 details),常见状态码包括 400、401、402、404、409、500。该 API 位于 lucid-client 代码库而非 lucid-agents,使用 Hono 与 OpenAPI 校验。其他收费、价格、平台与效果等事实资料暂未提供。