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

Instinct

نتایج Felo Data API را در Instinct به کار ببرید. عامل مدل اصلی خود را حفظ می‌کند.

پیش از شروع

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

تنظیم برنامه

Google Sheets → Extensions → Apps Script → Google Docs → Instinct Google Workspace connection

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

از طریق Google Workspace: Apps Script رابط Felo Data API را فراخوانی و نتایج را در برگه و سند Google می‌نویسد تا عامل بخواند.

felo-data-sheets.gs

در برگه Google، Extensions → Apps Script را باز کنید. کد دانلودشده را ذخیره، setupFeloDataSheet را اجرا و مجوز بدهید.
Queries!A2 را پر کنید. FELO_API_KEY را در Project Settings → Script Properties بگذارید، نه سلول یا گفتگو.
refreshFeloData را اجرا کنید. داده در Results و لینک سند در Config!B1 است. اجرای مجدد همان سند را به‌روز می‌کند.
همان حساب Google را به عامل متصل کنید، اجازه خواندن بدهید و لینک را برای خلاصه با منابع ارسال کنید.

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`

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

بررسی اتصال

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

رفع مشکل

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

مستندات مرتبط Felo

مستندات رسمی برنامه

Instinct