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

Coze

Kết nối Coze 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ở Plugins → Create → Import OpenAPI → Workflow / Agent, 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

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

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ở Coze Studio → model configuration → protocol: openai / base_url / api_key / model ID, 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.