إعداد أدوات AI

Dify

اربط Dify مع Felo Model API للتوليد وأداة HTTP منفصلة من Data API للبحث.

قبل البدء

أنشئ مفتاح API وتحقق من الرصيد. يستخدم المثال Tavily Search؛ لبقية الواجهات معلمات وأسعار خاصة.

إعداد التطبيق

افتح 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 أو مفتاح بيئة التنفيذ.