AI 도구 설정

Gemini Spark

Gemini Spark 작업에 Felo Data API 검색 결과를 전달합니다. 에이전트의 기본 모델은 유지됩니다.

준비 사항

API 키와 잔액을 준비하세요. Tavily 검색 예제이며 다른 API의 매개변수와 가격은 해당 문서를 확인하세요.

앱 설정

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

검색 도구 연결

Google Workspace를 경유합니다. Apps Script가 Felo Data API를 호출하고 시트와 Google 문서에 저장한 결과를 에이전트가 읽습니다.

felo-data-sheets.gs

Google 시트의 Extensions → Apps Script에 다운로드한 코드를 저장하고 setupFeloDataSheet를 실행해 승인하세요.
Queries!A2에 검색어를 넣고 Project Settings → Script Properties에 FELO_API_KEY를 저장하세요. 셀이나 대화에 키를 넣지 마세요.
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
}'

작동 확인

results의 title, url, content를 확인하고 에이전트에 결과와 출처 URL을 사용하도록 요청하세요. 빈 배열도 정상입니다. 콘솔에서 Felo 사용량을 확인하세요.

문제 해결

401: 키와 Authorization, 402: 잔액, 400: JSON과 query를 확인하세요. 429·5xx는 지연 후 재시도하고 request_id를 보관하세요. 시트는 승인·공유 권한, 실행 환경은 키 설정도 확인하세요.

앱 공식 문서

Gemini Spark