Felo API PlatformFelo API Platform

Configurazione degli strumenti di IA

Magpie

Configura Magpie come punto di accesso ai modelli di Felo API Platform, così il gateway locale li serve a Codex, Claude Code e altri agenti.

Usa questa guida se lavori con Magpie — l'app nella barra dei menu con gateway locale che raccoglie i modelli di tutti i provider in un unico elenco per gli agenti di codice — e vuoi aggiungere a quell'elenco i modelli di Felo API Platform. Magpie avvia un gateway su 127.0.0.1:3425 e riscrive la configurazione di ogni agente perché lo chiami: l'agente non ha quindi mai bisogno della chiave né dell'indirizzo Felo.

Prima di iniziare

Ti serve una chiave di Felo API Platform. La stessa chiave vale per i protocolli dei modelli, i client degli agenti e le API Search, Web Fetch, PPT, Mindmap, LiveDocs, X Search, YouTube Subtitling, Landing Page e SuperAgent.

export FELO_API_KEY="YOUR_API_KEY"

Installa Magpie se non l'hai ancora fatto:

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

Aggiungere Felo come provider

Una sola chiave Felo serve Chat Completions, Responses e Anthropic Messages. Passa a Magpie tutti gli indirizzi che può usare:

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"

Nell'app, Providers → Add provider accetta gli stessi dati: nome felo, la chiave e la base compatibile OpenAI https://openapi.felo.ai/api/v1. Per un provider compatibile Anthropic usa https://openapi.felo.ai/api.

Appena salvi la chiave, Magpie chiede a Felo l'elenco dei modelli. Compaiono nel selettore di ogni agente come felo/<model-id>.

magpie provider models felo   # richiede di nuovo l'elenco Felo
magpie models                 # ciò che gli agenti possono scegliere, incluso felo/<model>

Scegliere un modello Felo in un agente

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

Puoi sceglierlo anche dalla pagina Agents. Poiché Felo espone tutti e tre i protocolli, ogni agente resta sul suo — Claude Code su Anthropic Messages, Codex su Responses — e entrambi arrivano a Felo.

Campi del client

CampoValore
Nome / id del providerfelo
Base OpenAI Chat Completionshttps://openapi.felo.ai/api/v1
Base OpenAI Responseshttps://openapi.felo.ai/api/v1
Base Anthropic Messageshttps://openapi.felo.ai/api
Chiave APILa tua FELO_API_KEY
Modellofelo/claude-sonnet-5-5

Verificare la configurazione

magpie provider test felo

Magpie invia una piccola richiesta per ogni protocollo e riporta la latenza. Poi poni una domanda breve a un agente con un modello felo/ selezionato: se risponde, il percorso agente → gateway Magpie → Felo funziona.

Risoluzione dei problemi

ProblemaCosa controllare
Nessun modello sotto feloControlla la chiave ed esegui magpie provider models felo
Model not foundScrivi felo/<model-id> esattamente come lo mostra magpie models
Autenticazione non riuscitaReinserisci la chiave con magpie provider key felo <key>
Le chiamate Anthropic fallisconoLa base deve essere https://openapi.felo.ai/api, senza /v1
Codex ignora il modelloRiavvia Codex; legge l'elenco dei modelli all'avvio

Passaggi successivi