本文へ移動
cccskills
無料GitHub で公開

agnes-free-text

Call the free Agnes text model API for chat completions, streaming answers, coding help, tool-calling experiments, and OpenAI-compatible text generation. Use when the user asks for 免费文本, 免费的文本模型, free text API, Agnes text, Agnes-2.0-Flash, free LLM calls, or wants to use a free chat/completion model through an Agent skill.

kangarooking/agnes-free-model-skills
インストール方法を見る

含まれるファイル（4）

  • SKILL.md2.5 KB
  • agents/openai.yaml190 B
  • references/api.md2.8 KB
  • scripts/agnes_text.py8.3 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Agnes Free Text

Use this skill to call Sapiens AI's Agnes-2.0-Flash text model through the Agnes API.

Credential Rule

Read the API key from the environment. Do not hardcode keys in prompts, scripts, skill files, commits, or shell history.

Preferred variable:

export AGNES_API_KEY="..."

The helper also accepts AGNES_TOKEN as a fallback.

Quick Start

Run a normal chat completion:

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

Use a system prompt and save the raw response 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

Pass tool definitions from JSON:

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

Validate the request shape without calling the API:

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

Workflow

  1. Clarify whether the user wants a direct answer, JSON-like structured output, coding help, or streaming output.
  2. Use scripts/agnes_text.py for repeatable calls. Prefer --dry-run first when parameters are complex.
  3. Keep the model fixed to agnes-2.0-flash unless the API docs are updated.
  4. For multi-turn context, pass repeated --message role:content values instead of flattening the conversation into one prompt.
  5. For tool calling, pass --tools-json as either an inline JSON array or a path to a JSON file.

Notes

  • Endpoint: POST https://apihub.agnes-ai.com/v1/chat/completions
  • Model: agnes-2.0-flash
  • Request shape is compatible with OpenAI Chat Completions.
  • Supported features include system prompts, multi-turn messages, streaming, tool definitions, and tool choice.
  • If the API returns an authorization error, check AGNES_API_KEY first.

Reference

Read references/api.md when you need endpoint details, response fields, tool-calling shape, or streaming examples.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

agnes-free-image

無料

Generate free images with Agnes Image 2.1 Flash through the Agnes API, including text-to-image, image-to-image, high-density visual prompts, URL results, and local downloads. Use when the user asks for 免费图片, 免费的图片模型, free image API, Agnes image, Agnes Image 2.1 Flash, free AI image generation, image-to-image via Agnes, or wants a free image model Agent skill.

日本語の概要は準備中です。原文の説明を表示しています。

kangarooking/agnes-free-model-skills1992026年6月1日 更新

agnes-free-video

無料

Create free Agnes video generation tasks and retrieve video results through Agnes-Video-V2.0, including text-to-video, image-to-video, multi-image video, keyframe animation, async polling, and video download. Use when the user asks for 免费视频, 免费的视频模型, free video API, Agnes video, Agnes-Video-V2.0, text-to-video, image-to-video, keyframes, or wants a free video model Agent skill.

日本語の概要は準備中です。原文の説明を表示しています。

kangarooking/agnes-free-model-skills1992026年6月1日 更新

kangarooking のスキルをすべて見る

このスキルの問題を報告する