Sette file da copiare nel vostro progetto. Nessuna dipendenza da installare: i due
client Python usano la sola libreria standard, i due PHP solo ext-curl ed
ext-json, lo script di prova solo bash e curl. La chiave si
legge da AGILEV_KEY e non viene mai stampata.
| File | Cos'è |
|---|---|
| agilev_client.py | Client di riferimento Python: embed(), rerank(), i lotti, i rinvii sul 429 e gli errori col loro error.code. È il punto di partenza consigliato. |
| agilev_client.php | Lo stesso client in PHP 8: new AgileV(), embed(), rerank(). |
| agilev_client.mjs | Lo stesso client in Node ≥ 18 (modulo ES, fetch globale, zero dipendenze): new AgileV(), await av.embed(), await av.rerank(). È la lingua da cui arriva quasi tutto il traffico che vediamo. |
| ricerca_ibrida.py | Ricerca ibrida senza database vettoriale (denso + pesi lessicali), per chi tiene i vettori in una tabella — MySQL, pgvector — o vuole capire cosa fa un motore vettoriale quando fonde i due punteggi. |
| ricerca_ibrida.php | La versione PHP dello stesso esempio. --dove stampa indirizzo e sorgente della configurazione, e non stampa mai la chiave. |
| qdrant_ibrido.py | Ricerca ibrida in Qdrant: denso e pesi lessicali nella stessa collection, con i corpi JSON da copiare tali e quali. |
| agilev_langchain.py | LangChain: AgileVEmbeddings, AgileVSparseEmbeddings e il riordino. La ricerca ibrida costa una passata del modello per testo, non due. |
| agilev-prova-dal-posto.sh | La prova dal posto, in un comando: dal vostro box, con la vostra chiave, attraverso la vostra rete. Il protocollo per chi non può eseguire il nostro script è su questa pagina. |
export AGILEV_KEY=agv_... python agilev_client.py # ogni file si lancia da sé e dice cosa fa bash agilev-prova-dal-posto.sh # la prova dal posto
Il contratto, i codici di errore e i limiti per chiave stanno in documentazione dell'API; cosa fa il vostro client quando riceve un errore, in gli errori visti dal vostro client; a che serve provare il servizio dal vostro box, in la prova dal posto. Se un esempio non funziona dal vostro posto, scrivetecelo: agilev@agile.software.