Google'i failiotsing Gemini API-s: praktiline ja täielik juhend RAG-ilt

File Searchi tulek Gemini API ökosüsteemi on muutnud mängu neile, kes soovivad luua RAG-põhiseid rakendusi ilma infrastruktuuriga võidelmata. Selle hallatud teenuse abil automatiseerib Google failide salvestamise, tükeldamise, manustamise ja dünaamilise konteksti süstimise juba ehituse ajal, nii et saate keskenduda oma toote loomisele, mitte torujuhtmete loomisele.

Lisaks dokumentide sisestamisele pakub failiotsing täiustatud semantiline otsingÜhilduvus erinevate vormingutega, automaatsed viitamised ja lihtne hinnastruktuurJa kui vajate veebist ajakohast teavet, pakub API ka seda. google_search Google'i otsinguga maandamiseks koos väga kasulikud kinnitusmetaandmed jälgitavate kohtumistega liideste jaoks.

Mis täpselt on failiotsing Gemini API-s?

File Search on täielikult hallatud RAG-lahendus, mis on integreeritud Gemini API-sse. Praktikas laadite te oma failid üles (või impordite need failiteenusest) ja süsteem hoolitseb nende fragmentideks jagamise, manustamise genereerimise, indekseerimise File Searchi salves ja nende kasutamise alusena kasutajate päringutele vastamiseks vektorotsingu kaudu.

Eesmärk on see, et te ei peaks tegelema Vektoribaasid, indekseerimisjärjekorrad või tükeldamisstrateegiad ise. Tööriist põhineb Google'i manustamismudelil (näiteks gemini-embedding-001) ja integreerub natiivselt generateContentkus sa deklareerid Failide otsingu tööriist ja poodi kontrollima.

Kuidas see toimib: dokumendist kontekstuaalse vastuseni

Kontseptuaalne voog on lihtne, kuigi selle taga on palju sisu. Esmalt teisendatakse teie dokumendid numbrilisteks esitusteks (manusteks), mis jäädvustavad tähenduse. Need vektorid salvestatakse spetsiaalsesse salvestusse. Seejärel, kui saadate päringu, teisendab API päringu uueks manusteks ja teostab semantilise otsingu , et leida kõige asjakohasemad koodilõigud.

Lõpuks, üleskutses generateContent tööriistaga FileSearch, lisad ühe Failiotsingu ressurss mis viitab konkreetsele kauplusele. Selle abil teab mudel, et see peab konteksti taastamine oma poest ja kasutada seda oma vastuse toetamiseks. Kõik see toimub ilma, et peaksite käsitsi taastamist planeerima või väliseid teenuseid kasutama.

Dokumentide üleslaadimine ja importimine: kaks ühilduvat teed

Andmete oma poodi toomiseks on teil kaks võimalust. Kui soovite kohe asja juurde minna, kasutage API-t. uploadToFileSearchStore para Laadige fail otse üles ja indekseerige see ühe toiminguga. Kui eelistate etappe eraldi teha, saate faili üles laadida failide API abil ja seejärel importige see koos importFile failiotsingu poodi.

Kui otsustate kõik korraga üles laadida ja importida, File ajutine viitena toordokumendile; et Objekt eemaldatakse 48 tunni pärast.Indekseeritud andmed jäävad aga salve seni, kuni otsustate need kustutada. Kui Sa kasutad Files API-t Ja siis impordite; torujuhe läbib enne manustamise etappi failisalvestuse.

Tükeldamise kontroll: täpsus ja kattumine

Vaikimisi otsustab API strateegia kasuks intelligentne viilutamineAga kui teil on vaja täpsustada, saate määrata chunking_config selliste parameetritega nagu maksimaalne tokenite arv killu kohta y kattuvad märgidVäiksema hulga märgistega tüki kohta saate otsingus detailsemaks; suurema hulga märgistega säilitate rohkem konteksti fragmendi järgi.

See peenhäälestus on kasulik näiteks lähtekoodi, pikkade dokumentide või tehniliste käsiraamatute puhul , kus on soovitatav reguleerida tasakaalu otsingu täpsuse ja kontekstuaalse järjepidevuse vahel.

Failide otsingupoed: püsivus, ulatus ja haldus

Failiotsingu salvestusruum on püsiv konteiner, kus asuvad töödeldud manused . Erinevalt toorfailide API-failidest (mis kaovad 48 tunni pärast) säilitatakse salvestusruumi imporditud sisu kuni selle selgesõnalise kustutamiseni . Teadmusdomeenide korraldamiseks saate luua mitu salvestusruumi ja nende nimed on globaalselt unikaalsed.

API rakendus FileSearchStore see võimaldab teil luua, loetleda, hankida ja kustutada poodeLisaks on iga poe sisu haldamiseks olemas dokumentide API ja saate lisada kohandatud metaandmed (võtme-väärtuse paarid) teie failidesse, et filtreerida otsinguid alamhulkade järgi. Filtri süntaks on järgmine: filtriloendid kirjeldatud google.aip.dev/160.

Detailne API kasutusvoog

Tegevuslikust seisukohast on tüüpiline protsess kolmeastmeline. Esiteks, Sa lood failiotsingu poe. Pärast failide üleslaadimine ja importimine (Või laadite üles ja impordite seejärel). Lõpuks küsitlemine mudelile koos generateContent tööriista näitamine FileSearch ja sihtkoha poodi läbi FileSearchRetrievalResource.

JavaScripti/TypeScripti keskkondades on levinud tava kasutada samaaegsed operatsioonid (näiteks Promise.all) mitme faili korraga laadimiseks ja jälgimiseks operation.done Enne jätkamist. Samuti on tavaline poe otsimine selle järgi kuvanimi (inimloetav), kui te ei mäleta identifikaatorit fileSearchStores/....

Dokumendihaldus: leidmine, värskendamine ja kustutamine

Poe sees on halduse eesmärgil mõnikord kasulik leida konkreetne dokument selle kuvatava nime järgi . Oluline detail: dokumendid on pärast indekseerimist muutmatud . Kui teil on vaja neid värskendada, on soovitatav olemasolev dokument kustutada ja uus versioon üles laadida.

Parima tava kohaselt automatiseerivad paljud töövood selle tsükli: otsing → kustutamine → üleslaadimine . Ja kui olete ressurssidega lõpetanud (näiteks arendusjärgus), pidage meeles, et projekti kohta on piiratud 10 poega , seega on hea mõte need puhastada, kui te neid enam ei vaja.

Tsitaadid ja kontrollimine: dokumentides maandamine

Failiotsingu peamine eelis on see, et mudeli vastused võivad sisaldada järgmist automaatsed viited mis näitavad teie dokumentide fragmente, mida väljundi toetamiseks kasutatakse. See jälgitavus kuvatakse atribuudis grounding_metadata vastusest ja on selle jaoks ülioluline audit, kontrollimine ja usaldus ärikeskkondades.

Nii saate assistendi vastuse korral kuvada täpsed viited failide asjakohastele osadele, mis lihtsustab väidete läbivaatamist ja liideste loomist veebiviidetega.

Toetatud failivormingud

Failiotsing toetab lai valik vorminguidKõige levinumate hulgas on application/pdf, application/vnd.openxmlformats-officedocument.wordprocessingml.document (DOCX) application/vnd.openxmlformats-officedocument.spreadsheetml.sheet (XLSX) application/vnd.openxmlformats-officedocument.presentationml.presentation (PPTX) application/json, application/xml, application/ziplisaks paljudele keeltele programmeerimine y tekstitüübid kui text/plain, text/html, text/css, text/csv, text/markdown, text/javascript, text/yamlJne

See hõlmab ka mitmeid spetsiifilisi tüüpe (näiteks kood ja skriptid kui application/x-php, application/x-powershell, application/x-sh, application/x-tex, application/x-zsh, Ja tekstiline kui text/x-python, text/x-java, text/x-ruby-script, text/x-rust, text/x-go, text/x-kotlin, text/x-sql, text/x-c, text/x-csharp, text/x-swift, text/x-tex, text/x-scss, text/x-tcl, text/x-asm(paljude teiste hulgas). Kui teie juhtum nõuab ebatavalist tüüpi, on see kõige tõenäolisem kaalutud ametlikus dokumentatsioonis.

Teenusepiirangud ja arhitektuurilised soovitused

Teenuse stabiilsuse säilitamiseks seab API selged piirangud: faili maksimaalne suurus on 100 MB ; poodides koondatud kogusuurus sõltub kasutaja tasemest: tasuta 1 GB , 1. tase 10 GB , 2. tase 100 GB ja 3. tase 1 TB.

Jõudlusjuhisena on optimaalse latentsuse tagamiseks soovitatav hoida iga salvestusruumi suurus alla 20 GB . Pidage meeles, et salvestusruumi suurus arvutatakse taustsüsteemis sisendmahu ja manuste liitmisel , mis tavaliselt kolmekordistavad algse andmemahu.

Hinnad: lihtsad ja etteaimatavad

Arveldusmudel on lihtne: maksate ainult indeksisse manustatud tunnuste loomise eest hinnaga 0,15 dollarit miljoni tunnuse kohta (sõltuvalt kohaldatava manustamismudeli maksumusest). Manustuste salvestamine ja genereerimine päringu korral on tasuta ning hangitud tunnuste eest arveldatakse tavaliste kontekstitunnuste eest genereerimisel.

See skeem lihtsustab eelarvestamist: suured kulud koonduvad esialgsele andmete kogumisele (ja hilisematele dokumentide uuendustele, kui neid on), minimeerides päringute mahust tulenevat ootamatust tarbimises.

Failiotsinguga ühilduvad mudelid

Tööriist töötab Gemini perekonna praeguste mudelitega. Viitematerjalides rõhutatakse selle saadavust Gemini 2.5 Pro ja Gemini 2.5 Flashi versioonides failiotsingu jaoks, toetades maandamist, metaandmete filtreid ja viiteid, et aidata luua kontrollitavaid kogemusi.

Google'i otsinguga maandamise osas (mida käsitletakse allpool) on toetatud mudelite valik laiem ning on täpsustatud, et eksperimentaalsed ja eelvaatemudelid ei ole kaasatud.

Google'i otsinguga alustamine: ajakohane teave ja veebiviited

Kui lisaks dokumentidele vajate reaalajas veebisisuSaate tööriista aktiveerida google_searchMudel haldab kogu voog: otsustada, kas on asjakohane otsida, genereerida ja täita päringuid, töödelda tulemusi, sünteesida ja vastust tagastada maandusmetaandmetega (konsultatsioonid, tulemused ja viited).

Kui maandus on õigesti tehtud, hõlmab vastus järgmist: groundingMetadata selliste väljadega nagu veebiotsingupäringud (kasutatud konsultatsioone) otsingu sisenemispunkt (Otsinguettepanekute jaoks on vaja HTML-i ja CSS-i, mille kasutusnõuded on täpsustatud teenusetingimustes), maandustükid (veebiallikad koos uri y title) Ja maandustoed (fragmendid, mis seovad mudeli tekstisegmente indeksitega groundingChunks ehitada veebitsitaadid).

Maanduse hinnad ja mudelid Google'i otsingu abil

Kasutamine google_search arve iga taotluse kohta mis aktiveerib selle tööriista, isegi kui mudel käivitab sama päringu jaoks mitu sisemist päringut; kõik see loetakse ühekordne arveldatav kasutusSelle tööriistaga ühilduvad mudelid on loetletud allpool. Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.5 Flash-Lite, Gemini 2.0 Flash, Gemini 1.5 Pro y Gemini 1.5 Flash.

Versioonist 1.5 varasemate mudelite jaoks on olemas pärandtööriist. google_search_retrieval režiimiga dünaamilinekus te konfigureerite dünaamiline_lävi (0.0–1.0) ja mudel otsustab, kas otsingut teha või mitte, lähtudes selle väärtusest. usaldus kus vajate ajakohast teavet.

Kasutusjuhud: siseassistentidest klienditoeni

Failiotsing on suunatud ettevõttekeskkondadele , kus privaatsus, täpsus ja jälgitavus on esmatähtsad. See on kasulik teadmusassistentidele, kes otsivad päringuid omandiõigusega kaitstud dokumentatsioonist, automatiseerivad tuge viidetega käsiraamatutele ja eeskirjadele või kiirendavad otsingut ja läbivaatamist infomahukates sektorites (õigus, tervishoid, rahandus).

See kiirendab ka arendus- ja silumisprotsesse , võimaldades suhtlust koodibaaside või tehniliste spetsifikatsioonidega. Selle kombineerimine teiste Gemini võimalustega (näiteks koodi käivitamine või funktsioonid) võimaldab integratsioone, mis on rikkad vastavus-, auditeerimis- või analüüsiprotsesside poolest.

Toimingud ja olek: töötamine API-ga

REST-pind paljastab meetodid, näiteks fileSearchStores.create (loob tühja poe), fileSearchStores.delete (eemaldab poe), fileSearchStores.get (saab infot poest), fileSearchStores.list (loetleb kasutajate poode) ja importFile (see on oluline File (failiteenusest salvestusse). Lõpp-punktid toimingud võimaldab teil kontrollida olekut pikaajalised operatsioonid, taotlusvormidega, mis mitmel juhul lähevad tühi vastavalt spetsifikatsioonile.

Otse ülesmäge teel (uploadToFileSearchStoreKomplekt toimingud Spetsiaalselt loodud edusammude mõõtmiseks. See muster on tüüpiline: odad operatsioon sa kontrollid perioodiliselt, kui see on lõppenud ja millal täitma, jätkate voogu (näiteks RAG-päringute käivitamine).

Parimad tavad: filtrid, sildistamine ja latentsusaeg

Kui eeldate palju päringuid, märgistage oma dokumendid metaandmed ja tööle võtta metadataFilter et piirata otsingut asjakohaste alamhulkadeni. Hoidke salvestused aja piires suuruse soovitus See aitab latentsuse ja stabiilsuse osas. Ja kui kavatsete laadida täiskaustadSee kasutab ära samaaegset tõusu, et vähendada allaneelamise aega.

Tehnilistes stsenaariumides määratlege tükeldamisstrateegiad vastavalt sisule: näiteks lühemad ja mõõduka kattuvusega tükeldused koodis (funktsioonide/klasside parem täpsus) ja mõnevõrra pikemad tükeldused narratiivses dokumentatsioonis semantilise konteksti säilitamiseks.

Ühilduvus teiste Gemini tööriistadega

Google'i otsinguga maandamist saab kombineerida URL-i kontekstiga (konkreetsete URL-ide pakkumiseks) ja koodi käivitamise või täiendavate tööriistafunktsioonidega, olenevalt kasutusjuhtumist. See võimaldab teil ühendada sisemised failiotsingu teadmised ajakohase veebiteabega , säilitades alati viited ja allikate jäljed.

Kasutajakogemuse kujundamisel kasutage groundingSupports ja groundingChunks funktsioone , et pakkuda mudeli teksti kõrval klõpsatavaid viiteid . See on kasutajatele kõige selgem viis iga väite allika kontrollimiseks.

Gemini API failiotsing pakub lihtsat viisi oma rakenduste põhjendatud vastuste pakkumiseks teie enda andmete põhjal, minimeerides seeläbi operatiivset hõõrdumist. Selle prognoositavate indekseerimiskulude, erinevate vormingute toe, metaandmete filtrite, automaatsete viidete ja Google'i otsinguga seotuse kombinatsioon loob tootmisvalmis platvormi, mis lihtsustab RAG-i juurutamist igas suuruses meeskondades.