mcpField
A
agnes-free-text

agnes-free-text

github.com/kangarookingAgent 工作流20052 次安装21 周前更新
代码仓库

关于 agnes-free-text

一项通过 Agnes API 调用 Sapiens AI 的 Agnes-2.0-Flash 文本模型的技能。它使用可重复运行的 Python 脚本，支持聊天、多轮消息、流式响应和工具定义。

主要功能

  1. 01聊天补全请求
  2. 02系统提示词与多轮消息
  3. 03流式响应
  4. 04基于 JSON 的工具定义与选择
  5. 05干运行验证请求格式
  6. 06保存原始响应 JSON

适用场景

  1. 01生成简短文本回复
  2. 02跨多轮请求传递对话上下文
  3. 03调用 API 前检查请求格式
  4. 04使用工具定义请求模型响应

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/kangarooking/agnes-free-model-skills --skill agnes-free-text

安装后在 Claude Code 中输入/agnes-free-text确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
api.md
scripts/
agnes_text.py

详细介绍

Agnes Free Text

使用此技能，通过 Agnes API 调用 Sapiens AI 的 Agnes-2.0-Flash 文本模型。

凭据规则

从环境变量中读取 API 密钥。不要将密钥硬编码到提示词、脚本、技能文件、提交记录或 shell 历史记录中。

首选变量：

export AGNES_API_KEY="..."

此辅助工具也接受 AGNES_TOKEN 作为备用变量。

快速开始

运行常规聊天补全：

python3 scripts/agnes_text.py chat \
  --prompt "用三句话解释 Agent 为什么需要工具调用"

使用系统提示词并保存原始响应 JSON：

python3 scripts/agnes_text.py chat \
  --system "You are a concise technical writer." \
  --prompt "Explain tool calling for a beginner." \
  --output-json ./outputs/agnes-free-text/response.json

从 JSON 传入工具定义：

python3 scripts/agnes_text.py chat \
  --prompt "Decide whether a weather tool is needed." \
  --tools-json ./tools.json \
  --tool-choice auto

验证请求格式，无需调用 API：

python3 scripts/agnes_text.py chat \
  --prompt "Write a short product intro." \
  --max-tokens 300 \
  --dry-run

工作流

  1. 确认用户需要直接回答、类似 JSON 的结构化输出、编码帮助还是流式输出。
  2. 使用 scripts/agnes_text.py 执行可重复调用。参数较复杂时，优先先使用 --dry-run。
  3. 除非 API 文档已更新，否则将模型固定为 agnes-2.0-flash。
  4. 对于多轮上下文，传入多个 --message role:content 值，而不是将对话压平为一个提示词。
  5. 如需调用工具，请将 --tools-json 设置为内联 JSON 数组或 JSON 文件路径。

说明

  • 端点：POST https://apihub.agnes-ai.com/v1/chat/completions
  • 模型：agnes-2.0-flash
  • 请求格式与 OpenAI Chat Completions 兼容。
  • 支持的功能包括系统提示词、多轮消息、流式输出、工具定义和工具选择。
  • 如果 API 返回授权错误，请先检查 AGNES_API_KEY。

参考

需要了解端点详情、响应字段、工具调用格式或流式输出示例时，请阅读 references/api.md。

评论

支持 Markdown