راه‌اندازی ابزارهای AI

Dify

Dify را برای تولید محتوا به Felo Model API و برای جستجو به ابزار HTTP جداگانه Data API وصل کنید.

پیش از شروع

کلید API بسازید و اعتبار را بررسی کنید. نمونه از Tavily Search استفاده می‌کند؛ سایر APIها پارامتر و قیمت خود را دارند.

تنظیم برنامه

Studio → Workflow → HTTP Request را باز کنید، مقادیر زیر را ذخیره و درخواست را آزمایش کنید. نام‌ها با نسخه فرق دارند.

اتصال ابزار جستجو

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

فایل OpenAPI را وارد یا JSON HTTP POST بسازید. کلید را در اطلاعات احراز هویت ذخیره کنید؛ 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
}'

اتصال Model API

Model ID را از فهرست کپی و Base URL سازگار با OpenAI را وارد کنید. Data API را در ابزار HTTP جدا تنظیم کنید.

Settings → Model Providers → OpenAI-API-compatible را باز کنید، مقادیر زیر را ذخیره و درخواست را آزمایش کنید. نام‌ها با نسخه فرق دارند.

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

بررسی اتصال

title، url و content را در results بررسی کنید. خلاصه با نشانی منابع بخواهید و مصرف Felo را در کنسول ببینید. آرایه خالی هم معتبر است.

رفع مشکل

401: کلید و Authorization؛ 402: اعتبار؛ 400: JSON و query. 429/5xx را با تأخیر افزایشی تکرار و request_id را نگه دارید. مجوزهای Workspace یا کلید محیط اجرا را هم بررسی کنید.