mcpField
A
agnes-free-text

agnes-free-text

github.com/kangarookingエージェントワークフロー20052 回インストール21 週間前に更新
リポジトリ

agnes-free-text について

Agnes APIを通じてSapiens AIのAgnes-2.0-Flashテキストモデルを呼び出すスキルです。再利用可能なPythonスクリプトで、チャット、複数ターンのメッセージ、ストリーミング、ツール定義に対応します。

主な機能

  1. 01チャット補完リクエスト
  2. 02システムプロンプトと複数ターンのメッセージ
  3. 03ストリーミング応答
  4. 04JSON形式のツール定義と選択
  5. 05ドライランによるリクエスト形式の検証
  6. 06生の応答JSONの保存

活用シーン

  1. 01簡潔なテキスト応答の生成
  2. 02複数ターンにわたる会話コンテキストの送信
  3. 03API呼び出し前のリクエスト形式確認
  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 キーは環境変数から読み取ってください。プロンプト、スクリプト、スキルファイル、コミット、シェル履歴にキーをハードコードしないでください。

推奨変数：

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. ツール呼び出しでは、インライン JSON 配列または JSON ファイルへのパスを --tools-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 対応