Thiết lập công cụ AI

Dify

Kết nối Dify với Felo Model API để tạo nội dung và công cụ HTTP Data API riêng để tìm kiếm.

Chuẩn bị

Tạo API key và kiểm tra số dư. Ví dụ dùng Tavily Search; API khác có tham số và giá riêng.

Cấu hình ứng dụng

Mở Studio → Workflow → HTTP Request, lưu các giá trị bên dưới và thử yêu cầu. Tên mục có thể khác theo phiên bản.

Kết nối tìm kiếm

Start.query → HTTP Request.body.query
HTTP Request.body → LLM context → Output
LLM model → Felo (OpenAI-API-compatible)

Nhập tệp OpenAPI hoặc tạo HTTP POST JSON. Lưu key trong thông tin xác thực; nhận query và chuyển results sang bước sau.

OpenAPI JSON

Yêu cầu 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
}'

Kết nối Model API

Sao chép Model ID từ danh mục và dùng Base URL tương thích OpenAI. Cấu hình Data API trong công cụ HTTP riêng.

Mở Settings → Model Providers → OpenAI-API-compatible, lưu các giá trị bên dưới và thử yêu cầu. Tên mục có thể khác theo phiên bản.

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
}'

Kiểm tra

Kiểm tra title, url, content trong results; yêu cầu tóm tắt có URL nguồn và xem mức sử dụng Felo trên console. Mảng rỗng vẫn hợp lệ.

Khắc phục lỗi

401: key và Authorization; 402: số dư; 400: JSON và query. Thử lại 429/5xx với thời gian chờ tăng dần. Giữ request_id. Kiểm tra quyền Workspace hoặc key trong môi trường chạy.