# Coze

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

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

## قبل البدء

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

- [API Keys](https://openapi.felo.ai/console/api-keys)
- [Data APIs](https://openapi.felo.ai/ar/apis)
- [Tavily](https://openapi.felo.ai/ar/apis/tavily)

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

افتح **Plugins → Create → Import OpenAPI → Workflow / Agent** واحفظ القيم أدناه ثم اختبر الطلب. قد تختلف الأسماء حسب الإصدار.

## ربط أداة البحث

```text
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](https://openapi.felo.ai/docs-assets/integrations/felo-data-search.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` |

```json
{
  "query": "Felo API Platform documentation",
  "max_results": 3
}
```

```bash
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](https://openapi.felo.ai/ar/models) · [Protocols](https://openapi.felo.ai/ar/docs/guides/protocols.md)

```json
{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}
```

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

## وثائق Felo ذات الصلة

- [Data API](https://openapi.felo.ai/ar/docs/guides/data-api.md)
- [API Reference](https://openapi.felo.ai/ar/docs/data-api)
- [Authentication](https://openapi.felo.ai/ar/docs/authentication.md)
- [Apps & Agents](https://openapi.felo.ai/ar/apps)

## الوثائق الرسمية للتطبيق

- [Coze](https://github.com/coze-dev/coze-studio/wiki/3.-%E6%A8%A1%E5%9E%8B%E9%85%8D%E7%BD%AE)
- [Coze Tools](https://www.coze.com/open/docs/guides/plugin_import)
