Configuration des outils d'IA

Dify

Connectez Dify à Felo Model API pour la génération et à un outil HTTP Data API distinct pour la recherche.

Prérequis

Créez une clé API et vérifiez le crédit disponible. Cet exemple utilise Tavily Search ; les autres API ont leurs propres paramètres et tarifs.

Configurer l’application

Ouvrez Studio → Workflow → HTTP Request, enregistrez les valeurs ci-dessous puis testez la requête. Les libellés peuvent varier selon la version.

Connecter l’outil de recherche

Start.query → HTTP Request.body.query
HTTP Request.body → LLM context → Output
LLM model → Felo (OpenAI-API-compatible)

Importez le fichier OpenAPI ou créez une requête JSON HTTP POST. Enregistrez la clé dans les identifiants, transmettez query en entrée et results à l’étape suivante.

OpenAPI JSON

Requête 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
}'

Connexion Model API

Copiez un Model ID depuis le catalogue et utilisez la Base URL compatible OpenAI. Configurez Data API dans un outil HTTP séparé.

Ouvrez Settings → Model Providers → OpenAI-API-compatible, enregistrez les valeurs ci-dessous puis testez la requête. Les libellés peuvent varier selon la version.

Field	Value
Base URL	`https://openapi.felo.ai/api/v1`
API Key	`YOUR_FELO_API_KEY`
Model ID	`YOUR_MODEL_ID`
HTTP POST	`https://openapi.felo.ai/api/v1/chat/completions`
Output	`choices[0].message.content`

Model ID · Protocols

{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}

curl 'https://openapi.felo.ai/api/v1/chat/completions' \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "YOUR_MODEL_ID",
  "messages": [
    {
      "role": "user",
      "content": "Hello"
    }
  ],
  "stream": false
}'

Vérifier la connexion

Vérifiez title, url et content dans results. Demandez une synthèse avec les URL sources puis contrôlez l’usage Felo dans la console. Un tableau vide reste valide.

Résoudre les erreurs

401 : clé et Authorization ; 402 : crédit ; 400 : JSON et query. Réessayez 429/5xx avec attente progressive. Conservez request_id. Vérifiez aussi les autorisations Workspace ou les identifiants de l’environnement d’exécution.