Agnes AI API 统一调用
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a798dead/vtxf-agnes-api。
技能介绍
问题背景
如果你在 Agent 或对话式工具里要反复调用 Agnes AI 的 HTTP 接口,往往会遇到同一类麻烦:各接口的路径、请求体字段和返回结构不一致,助手每次都要靠上下文「现拼」调用方式,容易漏参数或混用不同版本写法。技能 @user_a798dead/vtxf-agnes-api 的定位,是把这类调用收敛成一套可在对话中直接引用的说明与约定,让助手按统一方式组织请求与解析响应。
技能如何工作
从资料与命名来看,本技能围绕 Agnes AI API 的统一调用 展开,核心能力是:
- 在技能说明中固定 Agnes API 的调用入口、常见参数与响应处理思路,减少每次对话从零检索文档;
- 让助手在需要生成代码、构造
curl/SDK 片段或解释错误码时,对齐同一套接口描述,而不是混用零散网页摘录; - 作为 SkillHub 上的可安装技能,与 官方安装指南 配合,在支持技能的助手里挂载后长期生效。
具体端点列表、鉴权方式与限额以 Agnes 官方文档为准;技能本身不负责托管密钥,也不替代官方 SDK 的二进制分发。
适用边界与注意点
- 适合:已在用或计划用 Agnes AI 做推理/多模态调用的工程师,希望在 Cursor、Claude 等环境里用自然语言驱动「按规范发请求」。
- 不适合:完全不接触 HTTP/API 集成、仅需要通用写作助手的场景;也不适合把技能当成 Agnes 账户开通或计费后台。
- 注意:
user_a798dead为技能发布来源,接口变更需以 Agnes 与技能仓库更新为准;生产环境仍应做密钥管理与错误重试,不要只在对话里明文传递长期有效的 Token。
使用场景
- 在 Cursor 里写后端时,要让助手按 Agnes 官方字段生成带鉴权头的 POST 请求体
- 联调多模态接口返回 4xx 时,用对话让助手对照技能里的统一参数名逐字段排查
- 把 Agnes 调用嵌进自有 Agent 流水线前,先让助手输出与技能约定一致的伪代码步骤
- 版本升级后对照技能说明,批量检查现有脚本里的 base URL 与路径是否仍匹配
适合人员
- 负责把 Agnes 接到内部微服务的后端工程师,希望减少每次对话重新查接口文档
- 做 AI Agent 原型的全栈开发者,需要在助手里稳定生成可复制的 HTTP 调用片段
- 维护测试环境的 QA,要按统一请求格式回归 Agnes 相关接口用例
- 技术负责人评估 Agnes 接入成本时,希望助手回答与团队已安装技能一致的接口描述