Web3 Graphql译为：Web3 图形查询语言（Graphql） 或者更简洁的译法： Web3 Graphql

使用 Ask GraphQL MCP 解决 Web3/链上问题 本技能通过 Ask GraphQL MCP 和目标 GraphQL 端点解决 Web3/链上问题。 主要目标 使用 MCP 工具，通过转发自然语言任务并返回端点特定答案。 不要使用直接 GraphQL 调用作为默认行为。 首先使用 MCP。 硬性约束：无直接查询绕过 当此技能被触发时，始终通过 Ask GraphQL MCP（graphql_agent 或 MCP JSON-RPC 路径）执行，即使模型可以自行组成 GraphQL 查询。 直接 GraphQL 执行仅在用户明确请求绕过 Ask MCP 时允许。 所需输入 在分析之前收集以下输入： 用户问题或任务（必需） GraphQL 端点 URL（必需，执行时可以通过 graphql-endpoint-discovery 发现） 计划模式：默认免费；仅当免费层限制达到或用户明确要求时才切换到付费模式 API 密钥（付费模式必需） 可选 X-ENDPOINT-AUTHORIZATION，当上游端点为私有时 当端点 URL 缺失时： 运行预技能 graphql-endpoint-discovery 如果存在高置信度端点候选项，则自动继续 如果模糊，则要求用户在顶级候选项中确认 如果没有候选项，则要求用户提供端点 确定性调用规则 使用此确切路由逻辑： 如果任务与 Web3/链上相关且用户消息包含明确的端点 URL（http:// 或 https://）-> 直接调用此技能。 如果任务与 Web3/链上相关但端点 URL 缺失 -> 先调用 graphql-endpoint-discovery，然后仅当端点解析后返回此处。 如果任务明显非 Web3 和非链上 -> 不调用此技能。 在一个用户回合中，仅允许一个执行路径：直接 ask-graphql-mcp 或 graphql-endpoint-discovery 然后 ask-graphql-mcp 永远不要在运行 graphql-endpoint-discovery 之前要求用户提供端点。 永远不要将 ask-graphql-mcp 替换为手写的直接 GraphQL 执行，除非用户明确要求绕过 MCP。 MCP 连接策略 默认免费网关：https://ask-api.hermes-subnet.ai/mcp/graphql-agent 仅在需要时使用付费网关：https://ask-api.hermes-subnet.ai/mcp 始终将 X-ENDPOINT 设置为用户端点 仅当上游端点需要身份验证时设置 X-ENDPOINT-AUTHORIZATION 在付费模式下，包含 X-API-KEY 在需要发出复制准备就绪的 JSON 时，使用 references/config-templates.md 中的模板。 代理执行工作流 确认端点和用户目标。 如果端点缺失，先运行 graphql-endpoint-discovery。 更喜欢会话工具路径：如果 graphql_agent 在当前会话工具列表中可用，则使用它。 如果会话工具不可用，则使用 HTTP JSON-RPC 路径到 Ask MCP 网关，带有所需的头部（X-ENDPOINT、可选 X-ENDPOINT-AUTHORIZATION 和付费模式下的 X-API-KEY）。 以自然语言将用户任务发送到 MCP。 超时策略：当问题复杂性高时，允许 MCP/代理调用超时最长 2 分钟（120 秒）然后将其视为失败。 如果需要，向 MCP 发送一个后续澄清提示。 返回 MCP 结果，带有用户的简洁解释。 HTTP JSON-RPC 路径（当会话工具不可用时） 使用 MCP 网关端点： 免费：https://ask-api.hermes-subnet.ai/mcp/graphql-agent 付费：https://ask-api.hermes-subnet.ai/mcp 调用序列： tools/list 以验证 graphql_agent 由网关暴露 tools/call 带有： 名称： "graphql_agent" 参数。问题： <用户自然语言请求> 此路径仍然使用 MCP，而不是直接 GraphQL 查询。 Fallback 工作流 如果任务失败： 验证网关 URL 与当前模式（免费/付费）匹配。 验证 X-ENDPOINT 格式和可达性。 验证私有端点的 X-ENDPOINT-AUTHORIZATION。 验证付费模式下的 X-API-KEY。 使用最小已知良好配置重试。 如果 MCP 返回免费层速率限制/配额错误： 指导用户在 https://ask.hermes-subnet.ai/billing/api-keys/ 创建 API 密钥 将用户切换到付费网关 https://ask-api.hermes-subnet.ai/mcp，带有 X-API-KEY 明确要求用户现在提供 API 密钥，以便执行可以立即继续 在同一响应中提供带有 X-API-KEY 占位符的复制准备就绪的付费配置代码段 不要仅以 "稍后重试" 或 "等待重置" 结束；API 密钥请求必须首先 如果付费 API 密钥配额超出： 指导用户在 https://ask.hermes-subnet.ai/billing/ 检查使用情况/配额 响应标准 对于端点分析请求，结构化响应如下： 假设 MCP 答案摘要 MCP 提供的可选查询/详细信息 下一步（运行/验证/调试） 对于纯设置请求，提供一个复制准备就绪的 JSON 块以及一个简短的验证检查清单。 在提到配额/速率限制失败时，始终包含正确的计费链接： API 密钥创建：https://ask.hermes-subnet.ai/billing/api-keys/ 使用情况/配额检查：https://ask.hermes-subnet.ai/billing/ 对于免费层限制错误，将 API 密钥指南视为最高优先级的下一步操作： 第一行应明确要求用户提供 API 密钥 在同一消息中包含 API 密钥创建链接 包含付费模式下的 g