Embedding e reranking multilingue,
senza che i tuoi testi lascino l'Europa.
AgileV trasforma testi in vettori per la ricerca semantica e i sistemi RAG. Modello open bge-m3 (1024 dimensioni, oltre 100 lingue) eseguito su server nostri in Europa. API compatibile con quella di OpenAI: cambi un indirizzo, non il codice.
Documentazione dell'APIRichiedi una licenzaStato del servizio: verifica in corso…
Perché AgileV
Sovranità dei dati
I testi vengono elaborati e subito dimenticati: nessun contenuto finisce in log, database o file. Del traffico restano solo contatori numerici. Niente fornitori extra-UE, nessun addestramento sui vostri dati.
Compatibile OpenAI
Endpoint /v1/embeddings con lo stesso formato di richiesta e risposta: funziona con i client e i framework che già usi.
Multilingue davvero
bge-m3 copre italiano, inglese e oltre 100 lingue con la stessa qualità, anche per testi lunghi fino a 8.000 token.
Chiavi con controllo
Ogni chiave ha ambito, limite di velocità e quota. Vedi i tuoi consumi, revochi quando vuoi.
Reranking incluso
Riordina i risultati di una ricerca per pertinenza con un modello dedicato: più precisione al tuo RAG senza cambiare indice.
Vettori compatti
Potete chiederli in int8 (un quarto dello spazio, coseno ≥ 0,997 rispetto al formato pieno) o binari (1/32). Il vostro database vettoriale costa meno.
Conti prima di spendere
L'endpoint /v1/tokenize dice quanti token occupa un testo senza consumare quota: stimate il costo prima di inviare.
Costi prevedibili
Prezzo per milione di caratteri elaborati, senza sorprese. Piano interno gratuito per i prodotti della suite Agile.
L'API in trenta secondi
Base URL: https://api.agilev.agile.software · Autenticazione: Authorization: Bearer <chiave>
curl https://api.agilev.agile.software/v1/embeddings \
-H "Authorization: Bearer $AGILEV_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"agilev-m3","input":["Il contratto scade il 30 settembre","Quando finisce l'accordo?"]}'
# risposta (formato OpenAI)
{"object":"list","model":"agilev-m3",
"data":[{"object":"embedding","index":0,"embedding":[0.0109,0.0272,…]},
{"object":"embedding","index":1,"embedding":[…]}],
"usage":{"prompt_tokens":23,"total_tokens":23,"chars":92,"truncated_texts":0}}
# reranking: riordina i candidati rispetto alla domanda
curl https://api.agilev.agile.software/v1/rerank \
-H "Authorization: Bearer $AGILEV_KEY" -H "Content-Type: application/json" \
-d '{"model":"agilev-rerank","query":"scadenza del contratto","documents":["…","…"],"top_n":3}'
Con la libreria OpenAI basta impostare base_url="https://api.agilev.agile.software/v1" e model="agilev-m3".
Un consiglio che vale più di ogni ottimizzazione nostra: riusate la connessione HTTP. L'elaborazione dura circa 100 ms, ma una richiesta vista da fuori ne impiega 370: la differenza è la stretta di mano TLS, e si paga a ogni connessione nuova. Un client tenuto vivo la paga una volta sola.
→ Documentazione completa dell'API: tutti i parametri, i codici d'errore, i limiti e gli esempi in curl, Python e PHP.
Confronto con Voyage e OpenAI
Un confronto onesto comincia da una regola: i numeri di AgileV sono nostri e misurati, e ognuno ha una prova che lo produce. I numeri degli altri non li abbiamo misurati noi, e non lo faremo: per misurare un fornitore bisogna mandargli dei testi, e da noi i testi non escono. Quindi nella colonna di destra c'è solo ciò che chiunque può verificare da sé — le dimensioni dei vettori, dove gira il modello, come si paga — e mai una misura loro spacciata per nostra.
| AgileV, misurato da noi | Voyage / OpenAI | |
|---|---|---|
| Dove vengono elaborati i vostri testi | Su server nostri, in Unione Europea. | Sui server del fornitore, nelle regioni previste dal suo contratto: quello lo leggete voi, non ve lo raccontiamo noi. |
| Cosa resta dei vostri testi | Niente. Nessun testo in log, database o file: restano solo contatori. Non è una promessa scritta su una pagina, è una prova del nostro banco che cade se un testo compare da qualche parte. | Quello che dice il loro contratto. |
| Dimensioni del vettore | 1024. | voyage-3: 1024 · voyage-3-lite: 512 · text-embedding-3-small: 1536. Lo scriviamo già nella nostra documentazione, alla voce «Migrare da Voyage o OpenAI». |
| Cambiare senza rifare l'indice | Il nostro servizio precedente e questo, sulla stessa frase, danno lo stesso vettore: coseno 1.0. Chi veniva da lì non ha reindicizzato nulla. | Modello diverso, vettori non confrontabili: l'indice si ricostruisce da zero. Vale per chiunque cambi modello, noi compresi. |
| Quanto ci mette | 84 ms per una frase, 114 ms per due, di calcolo puro. Da fuori diventano 0,37 s, e 250 ms di quelli sono TLS e proxy: riusando la connessione li pagate una volta sola. È il consiglio che vale più di ogni ottimizzazione nostra, e ve lo diciamo invece di prendercene il merito. | Dipende anche da quanto è lontano il loro server dal vostro: è una misura che vi conviene fare voi, dal posto dove gira il vostro codice. |
| Qualità del recupero | Sul nostro insieme di valutazione (26 brani di normativa pubblica, 20 query): R@1 0,825 e nDCG@10 0,907 col denso; 0,925 e 0,968 con l'ibrido denso + lessicale, che serviamo nella stessa chiamata. | Non l'abbiamo misurata, per il motivo scritto nel primo rigo di questa tabella. E il confronto che conta è un altro: prendete una licenza di prova e misurate tutti e due sul vostro corpus, che è l'unico su cui poi lavorerete. |
| Come si conta quello che pagate | A caratteri: li contate voi, in qualunque linguaggio, senza tokenizer e senza doverci credere sulla parola. | A token. Per mettere i due listini a confronto serve il rapporto fra le due unità: sui nostri testi italiani abbiamo misurato 4,4 caratteri per token. |
| Il modello | bge-m3, pesi aperti, scaricati una volta e tenuti in casa. Potete eseguirlo voi e verificare che i vettori che vi diamo siano davvero i suoi. | Modello chiuso: quello che fa lo sapete da quello che dichiarano. |
| Quanta macchina c'è dietro | 71 chunk da 1.500 caratteri al minuto su 4 vCPU, cioè 106.500 caratteri al minuto. Da lì escono le quote dei piani qui sotto, e il conto è scritto per intero nella documentazione. | La capacità che vi promettono sta nei limiti del piano che comprate. |
Ogni cifra di questa tabella è controllata da un banco che la cerca due volte: qui e dentro la misura che l'ha prodotta. Se rimisuriamo qualcosa e questa pagina resta indietro, il banco diventa rosso prima che lo legga un cliente.
Piani
Un piano è un insieme di valori predefiniti. I numeri veri stanno sulla licenza e si possono concordare all'emissione: il piano serve a non doverli inventare ogni volta. I nomi qui sotto sono gli stessi che l'API accetta.
| Piano | Per chi | Durata | Quota mensile | Al minuto | Prezzo |
|---|---|---|---|---|---|
| prova | chi vuole misurare la qualità sul proprio corpus prima di decidere | 30 giorni | 5.000.000 caratteri | 10 richieste | su richiesta |
| standard | chi manda un prodotto in esercizio | senza scadenza | 100.000.000 caratteri | 120 richieste | su richiesta |
| enterprise | volumi grossi, o chi vuole un'istanza riservata | senza scadenza | su misura | 300 richieste | su richiesta |
Le quote non sono numeri tondi scelti a occhio: escono dalla capacità che abbiamo misurato, e il conto per intero — portata, tetto del mese, quanto pesa ogni piano — sta nella documentazione dell'API. I prodotti della suite Agile hanno il loro piano interno, incluso.
I prezzi non stanno su questa pagina: si dicono su richiesta, insieme al volume che avete in mente.
Richiedi una licenza
Compilate il modulo: la richiesta prende un numero e vi ricontattiamo noi. Non serve nessuna chiave, non si crea nessun account e non c'è niente da installare. Di voi conserviamo solo quello che scrivete qui.
Il modulo funziona anche con JavaScript spento: è un modulo, non un'applicazione. Preferite scrivere? agilev@agile.software.