Configuración de herramientas de IA

Magpie

Configura Magpie como puerta de entrada a los modelos de Felo API Platform, para que su gateway local se los sirva a Codex, Claude Code y otros agentes.

Usa esta guía si utilizas Magpie —la app de barra de menús con gateway local que reúne los modelos de todos los proveedores en una sola lista para agentes de código— y quieres añadir a esa lista los modelos de Felo API Platform. Magpie ejecuta un gateway en 127.0.0.1:3425 y reescribe la configuración de cada agente para que lo llame, así que el agente nunca necesita la clave ni la dirección de Felo.

Antes de empezar

Necesitas una clave de Felo API Platform. La misma clave sirve para los protocolos de modelo, los clientes de agente y las API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page y SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Instala Magpie si aún no lo tienes:

curl -fsSL https://usemagpie.ai/install.sh | sh

Añadir Felo como provider

Una clave de Felo atiende Chat Completions, Responses y Anthropic Messages. Pasa a Magpie todas las bases que pueda usar:

magpie provider add felo \
  url=https://openapi.felo.ai/api/v1 \
  responses=https://openapi.felo.ai/api/v1 \
  anthropic=https://openapi.felo.ai/api \
  key="$FELO_API_KEY"

En la app, Providers → Add provider acepta los mismos datos: nombre felo, la clave y la base compatible con OpenAI https://openapi.felo.ai/api/v1. Para un provider compatible con Anthropic, usa https://openapi.felo.ai/api.

En cuanto guardas la clave, Magpie pide a Felo la lista de modelos. Aparecen en el selector de cada agente como felo/<model-id>.

magpie provider models felo   # volver a pedir la lista de Felo
magpie models                 # lo que pueden elegir los agentes, incluido felo/<model>

Elegir un modelo de Felo en un agente

magpie claude felo/claude-sonnet-5-5
magpie codex felo/gpt-5.6-sol

También puedes elegirlo en la página Agents. Como Felo expone los tres protocolos, cada agente mantiene el suyo: Claude Code sigue en Anthropic Messages, Codex en Responses, y ambos llegan a Felo.

Campos del cliente

Campo	Valor
Nombre / id del provider	`felo`
Base OpenAI Chat Completions	`https://openapi.felo.ai/api/v1`
Base OpenAI Responses	`https://openapi.felo.ai/api/v1`
Base Anthropic Messages	`https://openapi.felo.ai/api`
API key	Tu `FELO_API_KEY`
Modelo	`felo/claude-sonnet-5-5`

Verificar la configuración

magpie provider test felo

Magpie envía una petición pequeña por protocolo e informa de la latencia. Después haz una pregunta breve a un agente con un modelo felo/ seleccionado; si responde, el camino agente → gateway de Magpie → Felo funciona.

Solución de problemas

Problema	Qué revisar
No aparecen modelos en `felo`	Comprueba la clave y ejecuta `magpie provider models felo`
`Model not found`	Escribe `felo/<model-id>` exactamente como lo muestra `magpie models`
Falla la autenticación	Vuelve a introducir la clave con `magpie provider key felo <key>`
Fallan las llamadas a Anthropic	La base debe ser `https://openapi.felo.ai/api`, sin `/v1`
Codex ignora el modelo	Reinicia Codex; lee su lista de modelos al arrancar