Coze

Coze を Felo Model API と Data API に接続します。生成用モデルと検索用 HTTP ツールを個別に設定します。

事前準備

API キーを作成し、利用可能な残高を確認してください。Tavily 検索を例にします。他の API の引数と料金は各ドキュメントで確認できます。

• API Keys
• Data APIs
• Tavily

アプリの設定

Plugins → Create → Import OpenAPI → Workflow / Agent を開き、下表の値を設定して保存し、テストしてください。画面名はバージョンで異なります。

検索ツールの接続

Data API: Coze plugin → Import OpenAPI → X-API-Key credential → Agent tool / Workflow
Model API: self-hosted Coze Studio → custom OpenAI provider → model selection

下の OpenAPI ファイルをインポートするか、表に従って JSON の HTTP POST を作成します。キーは認証情報の設定に保存し、query を入力、results を次の処理に渡します。

OpenAPI JSON

Data API のリクエスト

{
  "query": "Felo API Platform documentation",
  "max_results": 3
}

export FELO_API_KEY='YOUR_FELO_API_KEY'
curl 'https://openapi.felo.ai/v1/beta/tavily/search' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "query": "Felo API Platform documentation",
  "max_results": 3
}'

モデル API の接続

モデル一覧から Model ID をコピーし、OpenAI 互換の Base URL を設定します。Data API は別の HTTP ツールに設定してください。

Coze Studio → model configuration → protocol: openai / base_url / api_key / model ID を開き、下表の値を設定して保存し、テストしてください。画面名はバージョンで異なります。

Model ID · Protocols

{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

curl 'https://openapi.felo.ai/api/v1/chat/completions' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'

動作確認

検索して results 配列の title・url・content を確認します。エージェントにその結果の要約と URL の引用を依頼し、コンソールでも Felo の使用量を確認してください。空の配列も有効な結果です。

トラブルシューティング

401 はキーと Authorization、402 は残高、400 は JSON と query を確認します。429・5xx は待機時間を増やして再試行します。request_id を保存してください。Workspace はスクリプトの承認と共有権限、実行ツールは同じ環境のキーも確認します。

関連する Felo ドキュメント

• Data API
• API Reference
• Authentication
• Apps & Agents

アプリの公式ドキュメント

• Coze
• Coze Tools