AI ツール設定

Gemini Spark

Gemini Spark のタスクに Felo Data API の検索結果を渡します。エージェントは標準のモデルを使い続け、Felo がデータを提供します。

事前準備

API キーを作成し、利用可能な残高を確認してください。Tavily 検索を例にします。他の API の引数と料金は各ドキュメントで確認できます。

アプリの設定

Google Sheets → Extensions → Apps Script → Google Docs → Gemini

検索ツールの接続

Google Workspace を経由します。Apps Script が Felo Data API を呼び出し、スプレッドシートと Google ドキュメントに結果を保存します。エージェントはその出力を読み取ります。

felo-data-sheets.gs

Google スプレッドシートを作成し、拡張機能 → Apps Script でダウンロードしたコードを貼り付けます。保存し、setupFeloDataSheet を実行して承認します。
Queries!A2 に検索語を入力します。プロジェクトの設定 → スクリプトプロパティに FELO_API_KEY を追加します。セルやチャットにはキーを入力しないでください。
refreshFeloData を実行します。Results にタイトル・URL・要約が入り、Config!B1 に出力ドキュメントの URL が表示されます。再実行で同じ文書が更新されます。
エージェントに同じ Google アカウントを接続し、出力への読み取り権限を確認します。文書の URL を渡し、内容の要約と出典の引用を依頼してください。

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

動作確認

検索して results 配列の title・url・content を確認します。エージェントにその結果の要約と URL の引用を依頼し、コンソールでも Felo の使用量を確認してください。空の配列も有効な結果です。

トラブルシューティング

401 はキーと Authorization、402 は残高、400 は JSON と query を確認します。429・5xx は待機時間を増やして再試行します。request_id を保存してください。Workspace はスクリプトの承認と共有権限、実行ツールは同じ環境のキーも確認します。

アプリの公式ドキュメント

Gemini Spark