AI Tool Setup

Instinct

Use Felo Data API search results in Instinct. The agent keeps its own model; Felo supplies data for its tasks.

Before you start

Get an API key and check your available credits. This example uses the Tavily search endpoint; other Data APIs have their own parameters and prices.

Set up the application

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

Connect the data tool

This route uses Google Workspace: Apps Script calls Felo Data API, writes the results to a Sheet and a Google Doc, then the agent reads the output. It does not require a custom API setting in the agent.

felo-data-sheets.gs

Create a Google Sheet. Open Extensions → Apps Script, paste the downloaded script, save, run setupFeloDataSheet and authorize it.
Set Queries!A2 to your search query. In Project Settings → Script Properties, add FELO_API_KEY with your key; do not put it in cells or agent chat.
Run refreshFeloData. Results contains titles, URLs and summaries; Config!B1 links to the generated Google Doc. Re-run to refresh the same document.
Connect the same Google account in the agent, grant access to the output, and provide its URL. Ask the agent to read the document and cite its sources.

setupFeloDataSheet()
refreshFeloData()

Data API request

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

Verify the integration

Run one search and check for a real results array containing title, url and content. Ask the agent to summarize those results and cite the returned URLs. An empty array is a valid result, not proof of failure. Review the API usage record to confirm the request went through Felo.

Troubleshooting

401: check the key and Authorization header. 402: check credits. 400: check the JSON body and query field. 429 or 5xx: retry with backoff. Save the request_id for support. For Workspace, check script authorization and document sharing; for computer tools, check the key in that execution environment.

Official application documentation

Instinct