用途：该技能用于调用 Sapiens AI 的 Agnes-2.0-Flash 文本模型，支持聊天补全、流式回答、编程帮助与工具调用实验，请求结构与 OpenAI Chat Completions 兼容。
凭据：API Key 从环境变量读取，优先使用 AGNES_API_KEY，辅助脚本也接受 AGNES_TOKEN 作为回退；不要把密钥硬编码进提示、脚本或提交中。示例命令：export AGNES_API_KEY="..."。
主要能力：支持系统提示、多轮消息、流式输出、工具定义与工具选择。多轮对话用重复的 --message role:content 传递，而非把对话压平成单条 prompt；工具定义可通过 --tools-json 传入内联 JSON 数组或 JSON 文件路径，并用 --tool-choice 控制。
用法：核心脚本为 scripts/agnes_text.py。普通对话：python3 scripts/agnes_text.py chat --prompt "..."；带系统提示并保存原始 JSON：加 --system 与 --output-json ./outputs/agnes-free-text/response.json；工具调用：加 --tools-json ./tools.json --tool-choice auto；参数复杂时先用 --dry-run 校验请求结构。
接口与限制：端点为 POST https://apihub.agnes-ai.com/v1/chat/completions，模型固定为 agnes-2.0-flash（除非 API 文档更新）。若返回授权错误，优先检查 AGNES_API_KEY。需要端点细节、响应字段、工具调用结构或流式示例时，查阅 references/api.md。官方未在资料中说明收费、价格、配额或速率限制，暂未提供。