AI 工具設定
Make
將 Make 接上 Felo 模型 API 與 Data API:模型 API 用於生成內容,獨立的 HTTP 工具用於查詢外部資料。
將 Make 接上 Felo 模型 API 與 Data API:模型 API 用於生成內容,獨立的 HTTP 工具用於查詢外部資料。
開始前準備
先建立 API key 並確認帳戶有可用額度。本文以 Tavily 搜尋介面為例;其他 Data API 的參數和價格以各自文件為準。
在應用程式中設定
開啟 Scenario → HTTP → Make a request → POST → application/json → Run once,依下表填寫並儲存,再執行一次測試請求。不同版本的介面名稱可能不同。
將查詢設為 Agent 工具
Trigger → HTTP request → JSON results[] → next action / agent context匯入下方 OpenAPI 檔案,或依表格建立 JSON 格式的 HTTP POST 請求。API key 儲存在應用程式的憑證設定;將 query 作為任務輸入,把 results 傳給後續步驟。
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 工具中。
開啟 Scenario → HTTP → Make a request → POST → /api/v1/chat/completions,依下表填寫並儲存,再執行一次測試請求。不同版本的介面名稱可能不同。
| 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": "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。