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 | shAggiungere 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-solPuoi 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
| Campo | Valore |
|---|---|
| Nome / 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 |
| Chiave API | La tua FELO_API_KEY |
| Modello | felo/claude-sonnet-5-5 |
Verificare la configurazione
magpie provider test feloMagpie 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
| Problema | Cosa controllare |
|---|---|
Nessun modello sotto felo | Controlla la chiave ed esegui magpie provider models felo |
Model not found | Scrivi felo/<model-id> esattamente come lo mostra magpie models |
| Autenticazione non riuscita | Reinserisci la chiave con magpie provider key felo <key> |
| Le chiamate Anthropic falliscono | La base deve essere https://openapi.felo.ai/api, senza /v1 |
| Codex ignora il modello | Riavvia Codex; legge l'elenco dei modelli all'avvio |