Configuración de herramientas de IA

Dify

Conecta Dify a Felo Model API para generar contenido y a una herramienta HTTP Data API independiente para buscar datos.

Antes de empezar

Crea una clave API y comprueba el saldo. El ejemplo usa Tavily Search; otras API tienen parámetros y precios propios.

Configurar la aplicación

Abre Studio → Workflow → HTTP Request, guarda los valores indicados y prueba la petición. Los nombres pueden variar según la versión.

Conectar la búsqueda

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

Importa el archivo OpenAPI o crea un POST HTTP JSON. Guarda la clave en las credenciales, usa query como entrada y pasa results al siguiente paso.

OpenAPI JSON

Petición 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
}'

Conectar Model API

Copia un Model ID del catálogo y usa la Base URL compatible con OpenAI. Configura Data API como herramienta HTTP aparte.

Abre Settings → Model Providers → OpenAI-API-compatible, guarda los valores indicados y prueba la petición. Los nombres pueden variar según la versión.

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

Verificar la conexión

Comprueba title, url y content en results. Pide un resumen con las URL devueltas y revisa el uso de Felo en la consola. Una lista vacía es válida.

Solución de problemas

401: clave y Authorization; 402: saldo; 400: JSON y query. Reintenta 429/5xx con espera progresiva y guarda request_id. Comprueba también los permisos de Workspace o la clave en el equipo de ejecución.