# Claude Duet

استخدم نتائج Felo Data API في Claude Duet. يحتفظ الوكيل بنموذجه الأصلي.

استخدم نتائج Felo Data API في Claude Duet. يحتفظ الوكيل بنموذجه الأصلي.

## قبل البدء

أنشئ مفتاح 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)

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

**Google Sheets → Extensions → Apps Script → Google Docs → Claude Google Drive connector → Duet**

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

عبر Google Workspace: يستدعي Apps Script واجهة Felo Data API ويكتب النتائج في جدول ومستند Google ليقرأها الوكيل.

[felo-data-sheets.gs](https://openapi.felo.ai/docs-assets/integrations/felo-data-sheets.gs)

1. افتح Extensions → Apps Script في جدول Google. احفظ الشيفرة المنزّلة وشغّل setupFeloDataSheet وامنح الأذونات.
2. أدخل البحث في Queries!A2. احفظ FELO_API_KEY في Project Settings → Script Properties، وليس في الخلايا أو الدردشة.
3. شغّل refreshFeloData. البيانات في Results ورابط المستند في Config!B1. التشغيل مجددًا يحدّث المستند نفسه.
4. اربط حساب Google نفسه بالوكيل وامنحه القراءة وأرسل رابط المستند ليلخصه مع المصادر.

```text
setupFeloDataSheet()
refreshFeloData()
```

## طلب 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
}'
```

## التحقق

تحقق من 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)

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

- [Claude Duet](https://support.claude.com/en/articles/17631495-get-started-with-claude-duet)

- [Google Apps Script: UrlFetchApp](https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app)
- [Google Apps Script: PropertiesService](https://developers.google.com/apps-script/reference/properties/properties-service)
