http-request:让 Agent 在对话里直接发 HTTP 请求

前言

调试接口、拉取公开 API、向 webhook 投递数据时,开发者往往要在终端或 Postman 里单独发请求,再把响应贴回给 AI。Agent 本身通常不能直接访问任意 URL。若希望模型在完成任务时「顺手」完成一次 GET 或 POST,并把响应体带回上下文,需要一个明确的 HTTP 请求 Skill。

下面介绍 SkillHub 社区技能 http-request(坐标 @user_57562667/http-request):在 Agent 侧封装发起 GET/POST 并返回响应结果的能力,且标注 requires_api_key=false,不依赖额外 API Key 配置。

这是什么

http-request 是 SkillHub 上分类为 ai-agent 的社区技能(来源 community),当前页面版本为 v1.0.2,由发布者 user_57562667 维护。

官方一句话说明:HTTP 请求技能,发起 GET/POST 请求并返回响应结果。定位很直白——给 Agent 一条可复用的 HTTP 调用约定,而不是替代 curl、网关或生产级 HTTP 客户端库。

核心功能

根据 SkillHub 页面与 API 摘要,目前能核实的能力只有下列几项:

  1. 支持 GET、POST 两类 HTTP 方法。
  2. 执行请求后,将 响应结果 返回给 Agent(便于后续解析、总结或写入任务上下文)。
  3. 标签 requires_api_key=false:安装与使用不要求在 Skill 层单独配置 API Key(具体目标 URL 若需要鉴权,仍由请求头、Cookie 或环境变量等常规方式处理,以 Skill 内说明为准)。

页面未公开更细的参数表(超时、重试、自定义 Header 等)。未在官方资料中出现的能力,本文不展开。

安装与启用

SkillHub 提供两种常见安装路径:用 CLI 装到当前 Agent 的 skills 目录,或把安装提示词交给 AI 按官方文档执行。

方式一:SkillHub CLI

先确认本机是否已有 skillhub(完整步骤见 SkillHub 安装与优先源配置)。安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录,否则默认落在 ./skills/,Agent 可能读不到。

command -v skillhub && skillhub --version
skillhub install @user_57562667/http-request --dir <skills 目录>

各客户端 skills 目录示例(摘自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下的 .agents/skills/

装好后按你所用 Agent 的惯例刷新或重启,使 Skill 被加载。

方式二:让 AI 按文档安装

SkillHub 页面给出的提示词为:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_57562667/http-request`。

将上述内容发给支持 Skill 安装的 Agent,由它按 skillhub.md 完成 CLI 检查与 install 命令。

典型用法

公开页面未附带完整的 SKILL.md 正文或逐步示例。从简介可推断的用法模式如下(具体触发话术以安装后 Skill 内指令为准):

  1. 在对话中说明要访问的 URL 与 方法(GET 或 POST)。
  2. 若为 POST,补充请求体格式(如 JSON)及必要 Header。
  3. Agent 调用本 Skill 发起请求,并将响应内容返回,供你或模型继续处理。

复现前请先完成安装,并在同一会话中确认 Agent 已加载 @user_57562667/http-request。

适用场景与注意

适合:

  • 需要 Agent 拉取公开 HTTP API、健康检查地址或文档型 JSON。
  • 向测试环境 webhook、表单接口发送 POST,并把响应交给模型解读。
  • 希望减少「你手动 curl → 粘贴响应」的往返。

注意:

  • 仅核实到 GET/POST;复杂认证、文件上传、流式响应等是否支持,需以 Skill 实际说明为准。
  • Agent 发起的 HTTP 会走运行环境网络策略;内网地址、敏感生产接口应自行评估风险。
  • SkillHub 统计(以抓取资料为准):评分 100000,下载 623,安装 2;社区技能更新节奏取决于发布者,使用前可在页面确认 v1.0.2 是否仍是最新。

结尾

http-request 把「发 GET/POST 并拿回响应」收敛成 Agent 可调用的一项能力,适合在开发与联调场景里减少上下文切换。安装与坐标以 SkillHub 为准。

  • SkillHub 页面:https://www.skillhub.cn/skills/user_57562667/http-request
  • API 摘要:https://api.skillhub.cn/user_57562667/http-request
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜