הגדרת כלי AI

Coze

חברו את Coze אל Felo Model API ליצירה ואל כלי HTTP נפרד של Data API לחיפוש.

לפני שמתחילים

צרו מפתח API ובדקו יתרה. הדוגמה משתמשת ב-Tavily Search; לממשקים אחרים פרמטרים ומחירים נפרדים.

הגדרת היישום

פתחו Plugins → Create → Import OpenAPI → Workflow / Agent, שמרו את הערכים להלן ובדקו בקשה. שמות עשויים להשתנות בין גרסאות.

חיבור כלי חיפוש

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

ייבאו קובץ 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 נפרד.

פתחו Coze Studio → model configuration → protocol: openai / base_url / api_key / model ID, שמרו את הערכים להלן ובדקו בקשה. שמות עשויים להשתנות בין גרסאות.

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 או מפתח סביבת הביצוע.