AI 工具設定

Coze

將 Coze 接上 Felo 模型 API 與 Data API：模型 API 用於生成內容，獨立的 HTTP 工具用於查詢外部資料。

開始前準備

先建立 API key 並確認帳戶有可用額度。本文以 Tavily 搜尋介面為例；其他 Data API 的參數和價格以各自文件為準。

在應用程式中設定

開啟 Plugins → Create → Import OpenAPI → Workflow / Agent，依下表填寫並儲存，再執行一次測試請求。不同版本的介面名稱可能不同。

將查詢設為 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 請求。API key 儲存在應用程式的憑證設定；將 query 作為任務輸入，把 results 傳給後續步驟。

OpenAPI JSON

Data API 請求範例

Field	Value
Method	`POST`
URL	`https://openapi.felo.ai/v1/beta/tavily/search`
Authorization	`Bearer YOUR_FELO_API_KEY`
OpenAPI credential	`X-API-Key: YOUR_FELO_API_KEY`
Content-Type	`application/json`
query	`Felo API Platform documentation`
max_results	`3`
Output	`results[].title`, `results[].url`, `results[].content`

{
  "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，依下表填寫並儲存，再執行一次測試請求。不同版本的介面名稱可能不同。

Field	Value
Base URL	`https://openapi.felo.ai/api/v1`
API Key	`YOUR_FELO_API_KEY`
Model ID	`YOUR_MODEL_ID`
HTTP POST	`https://openapi.felo.ai/api/v1/chat/completions`
Output	`choices[0].message.content`

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 欄位。請 Agent 根據結果摘要並引用網址。空陣列也是有效結果，不代表失敗；到控制台確認本次 Felo API 用量。

疑難排解

401：檢查 key 與 Authorization；402：檢查餘額；400：檢查 JSON 與 query；429 或 5xx：退避重試。保留 request_id 供客服查核。Workspace 請檢查指令碼授權與文件權限；電腦工具請確認實際執行環境的 key。