SuperAPI AI 工具集

graphql

编程与开发

查看项目

更新于 10-16 02:21

技能介绍

GraphQL Skill 提供 GraphQL 开发能力,主要面向 Golden Armada AI Agent Fleet Platform。

一、用途 该技能在涉及以下工作时激活:GraphQL schema 设计、resolver 实现、query 与 mutation 编写、subscriptions、GraphQL 客户端集成。可用于 GraphQL 服务端、客户端以及 API 设计相关场景。

二、主要能力 技能资料给出了一个围绕 Agent 与 Task 的完整 schema 示例。Query 中包含按 id 查询 agent、分页查询 agents、按 id 查询 task;Mutation 中包含创建、更新、删除 agent 以及执行 task;Subscription 中包含 agent 状态变更与 task 完成事件。类型定义包括 Agent、Task、AgentConnection、AgentEdge、PageInfo,枚举包括 AgentType(CLAUDE、GPT、GEMINI、OLLAMA)、AgentStatus(IDLE、ACTIVE、ERROR、OFFLINE)、TaskStatus(PENDING、RUNNING、COMPLETED、FAILED),输入类型包括 CreateAgentInput、UpdateAgentInput、ExecuteTaskInput、AgentFilter,以及 DateTime、JSON 两个 scalar。

三、使用方式 服务端方面,资料提供了 Python(Strawberry)与 Node.js(Apollo)两种实现示例。Python 示例通过 @strawberry.type、@strawberry.field、@strawberry.mutation、@strawberry.subscription 定义类型与操作,构建 schema 后通过 GraphQLRouter 集成到 FastAPI。Node.js 示例使用 ApolloServer,配合 @graphql-tools/schema 与 graphql-subscriptions 的 PubSub,定义 typeDefs 与 resolvers,并在 Mutation 中发布事件、在 Subscription 中订阅事件。 客户端方面,资料提供了多个 GraphQL 查询示例,包括获取单个 agent 及其 tasks、带分页的 agents 列表、创建 agent 的 mutation、订阅 agent 状态变更的 subscription;另提供 React(Apollo)客户端示例,使用 useQuery、useMutation、useSubscription 与 gql,并在 useMutation 中通过 refetchQueries 刷新列表。

四、适用场景 适用于需要设计 GraphQL schema、实现 resolver、编写查询/变更/订阅以及进行 GraphQL 客户端集成的项目,示例场景为 AI Agent 平台中的 agent 与 task 管理。

五、限制 资料未提供该技能的收费、价格、支持平台、实际运行效果或完整安装步骤等信息,暂未提供。