Agnes 2.0 Flash 文本生成
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_69c32a7b/agnes-text。
技能介绍
要解决什么问题
在 Agent 或脚本里接文本模型时,常见需求是:接口形态与 OpenAI Chat Completions 一致,这样现有 SDK、流式解析和 tools 字段可以少改代码。Agnes 2.0 Flash 是 Sapiens AI 提供的快速文本模型,本技能把 Base URL、模型 ID(agnes-2.0-flash)和鉴权方式 收敛成可复用的调用约定,避免每次手写 endpoint 与 header。
技能如何工作
- 鉴权:从环境变量
AGNES_API_KEY读取密钥,请求头使用Authorization: Bearer <key>。 - 基础对话:向
https://apihub.agnes-ai.com/v1/chat/completions发送POST,body 为标准的messages数组(system/user/assistant)。 - 流式输出:请求体设
stream: true,响应为与 OpenAI 相同格式的 SSE 事件流。 - 工具调用:传入
tools与tool_choice,响应中的tool_calls字段与 OpenAI function calling 对齐,便于接现有 agent 循环。 - bundled 脚本:仓库内
scripts/chat.py适合单轮问答,读环境变量后直接打印模型回复;更完整的参数与错误码见references/api_reference.md。
适用边界与注意点
定价为 免费但受 RPM 限制,适合开发、原型与轻量自动化,不宜当作无配额保障的生产 SLA 唯一后端。多轮对话需在应用层自行维护 messages 历史;若你已有 OpenAI 客户端,通常只需改 base URL 与 model 名 即可切换。
使用场景
- 已有 OpenAI Chat Completions 代码,只想改 base URL 与 model 名,用免费端点做联调与回归。
- 在本地 Agent 循环里接 `tools` / `tool_choice`,验证模型返回的 `tool_calls` 能否驱动现有函数执行。
- 需要 SSE 流式打印回复时,对同一 endpoint 设 `stream: true`,按 OpenAI 事件格式解析增量内容。
- 单轮问答或冒烟测试时,用 bundled 的 `scripts/chat.py` 读 `AGNES_API_KEY` 快速看模型输出。
适合人员
- 维护内部自动化脚本、希望用 OpenAI SDK 但不想绑死单一厂商密钥的后端工程师
- 正在搭多轮对话原型、需要在应用层自行拼接 `messages` 历史的 Agent 开发者
- 把 LLM 接进 CI 或本地工具链、只需轻量文本补全且能接受 RPM 限额的集成同学
- 已有 function calling 管线、想对照 Agnes 响应格式做兼容性验证的插件作者