# n8n

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

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

## 開始前準備

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

- [API Keys](https://openapi.felo.ai/console/api-keys)
- [Data APIs](https://openapi.felo.ai/zh-TW/apis)
- [Tavily](https://openapi.felo.ai/zh-TW/apis/tavily)

## 在應用程式中設定

開啟 **Workflow → HTTP Request → Import cURL / Send Body → JSON → Execute step**，依下表填寫並儲存，再執行一次測試請求。不同版本的介面名稱可能不同。

## 將查詢設為 Agent 工具

```text
HTTP Request → results[] → next node / agent context
JSON output: {{$json.results}}
```

匯入下方 OpenAPI 檔案，或依表格建立 JSON 格式的 HTTP POST 請求。API key 儲存在應用程式的憑證設定；將 query 作為任務輸入，把 results 傳給後續步驟。

[OpenAPI JSON](https://openapi.felo.ai/docs-assets/integrations/felo-data-search.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` |

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

```bash
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 工具中。

開啟 **Workflow → HTTP 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 ID](https://openapi.felo.ai/zh-TW/models) · [Protocols](https://openapi.felo.ai/zh-TW/docs/guides/protocols.md)

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

```bash
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。

## 更多 Felo 文件

- [Data API](https://openapi.felo.ai/zh-TW/docs/guides/data-api.md)
- [API Reference](https://openapi.felo.ai/zh-TW/docs/data-api)
- [Authentication](https://openapi.felo.ai/zh-TW/docs/authentication.md)
- [Apps & Agents](https://openapi.felo.ai/zh-TW/apps)

## 應用程式官方資料

- [n8n](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/)
