Erabiltzailearen eskuliburua — Xabia Agent Core
Produktuaren bertsioa: Xabia Agent Core v1.0.202 (2026ko abuztua)
Eskuliburuen aurkibidea: https://xabia.ai/docs/
Sareko PDFa: https://xabia.ai/docs/manual-usuario-xabia-core.pdf
Sareko HTMLa: https://xabia.ai/docs/manual-usuario-xabia-core.html
Instalazio Gida Azkarra
- Deskargatu Xabia Agent Core ZIP fitxategia (
xabia-agent-core-1.0.202.zipedo baliokidea den txikizkako paketea). - WordPress-en, joan Pluginak → Gehitu Berria → Kargatu Plugin atalera , hautatu ZIP fitxategia eta egin klik Instalatu Orain → Aktibatu aukeran .
- Ireki Xabia Agent eta konfiguratu AI Connection : itsatsi
XABIA--…, aukeratu Xabia Cloud (gomendatua) edo Own Infrastructure , eta gorde. - Sortu agente bat Agente Berria aukeratik, idatzi izena, agurra eta oinarrizko argibideak.
- Aukeratu datu-iturri bat (CSV, SQL, gehigarria edo iturri anitzekoa), egin klik Konektatu / Mapatu aukeran dagokionean eta gorde agentea.
- Egin klik Sinkronizatu datuak aukeran eta, bektoreen bilaketa erabiltzen baduzu, Entrenatu AI aukeran .
- Argitaratu agentea
kode laburrarekin edo aktibatu interfaze natiboa Itxura → Erakutsi gunean kode laburrik gabe ataletik . - Probatu Playground- en eta benetako orrialde batean publikoari ireki aurretik.
Aurreko bertsio batetik eguneratzea: Igo ZIP fitxategi berria Plugins- etik, ordezkatu instalatutako bertsioa eta mantendu dauden ezarpenak. /xabia-box/ erabiltzen ari bazara, joan Ezarpenak → Esteka iraunkorrak → Gorde eguneratzearen ondoren. 1.0.72+ WPML-rekin instalatu ondoren, bisitatu frontend orri bat txataren UI itzulpenak sinkronizatzeko; garbitu cachea (LiteSpeed, etab.). Urruneko SQL iturburu batekin, 1.0.164+ bertsiora eguneratu ondoren, berriro sinkronizatu (eta bidali Hub-era, hala badagokio) fitxak mapatutako atributuak erantsita birsortzeko.
Gida azkarra: zer egin egoera bakoitzean
Erabili taula hau bide-orri gisa .
Lerro bakoitzak pantaila zehatza eta urratsen ordena adierazten du.
| Nahi duzu… | Nora noa? | Zer egin behar dut (ordenaren arabera) |
|---|---|---|
| Xabia lehen aldiz instalatzen | Pluginak → Pluginak igotzea | ZIP Core → Aktibatu → AI Konexioa (Lizentzia + Hodeia) → Agente Berria → Datu Iturburua → Sinkronizatu → Kode Laburra edo Modu Natiboa |
| Bertsio berri batera eguneratu | Pluginak → Pluginak igotzea | ZIP kodea igo (ordezkatzen du) → Esteka iraunkorrak → Gorde → Garbitu gunearen katxea → Saiatu inkognitoko txata |
| Argitaratu txata orrialde zehatz batean | Editatu agentea → Orokorra | Kopiatu kode laburra → itsatsi orrialdean → desgaitu “Erakutsi gunean kode laburrik gabe” avatar flotatzailerik nahi ez baduzu |
| Avatar flotatzailea gune osoan | Editatu agentea → Itxura | Aktibatu “Erakutsi gunean kode laburrik gabe” → aukeratu sartutako/baztertutako orrialdeak → Gorde agentea |
| Ezkutatu txata ezabatu gabe | Agenteen zerrenda | Pausatu (itzulera Aktibatu botoiarekin) |
| Hizkuntza anitzekoa WPML-rekin (ES + EU + EN…) | Ikus §10.12 | Agurra gaztelaniaz → gorde agentea → egiaztatu WPML katearen itzulpena → garbitu cachea |
| Agur desberdinak hizkuntzaren arabera (automatikoa) | Nortasuna + oinarrizko lizentzia aktiboa | Agurra idatzi oinarrizko hizkuntzan → Gorde agentea (Core-k Hub deitzen du WPML badago; DTP Core-n sartuta dago) |
| Agur desberdinak hizkuntzaren arabera (eskuliburua) | WPML → Kateen itzulpena | Xabia AI testuingurua → Agent Greeting - su-agente → eskuz itzuli |
| «Idatzi hemen…» leku-marka itzulita | Nukleoa ≥ 1.0.72 + WPML | Instalatu 1.0.72 → bisitatu frontend-a behin → egiaztatu xabia-intelligence domeinua String Translation-en |
| Konektatu CSV edo Excel formatuan | Orokorra → CSV fitxategiak | CSV fitxategia igo → Arakatu/Eskaneatu → Mapa zutabeak → Sinkronizatu → Trebatu |
| Urruneko datu-basera konektatu | Orokorra → Urruneko SQL | Host, datu-base, erabiltzaile, pasahitza, kontsulta → Proba-kontsulta → Mapa → Sinkronizatu |
| QR kodea interesgune bakoitzeko | QR / Totem Adimendunak | Sinkronizatu ENTE zutabearekin → hasierako orrialdea → Sortu QR → Smart QR eskuliburua |
| Kiosko/Totem modua | QR / Totem Adimendunak | Aktibatu Totem Modua + jarduerarik gabeko minutuak, edo URLa /xabia-box/?x_project=… |
| Tokenak kargatu | Diru-zorroa | Egiaztatu lizentzia Konexioan → Kargatu paketea → itxaron minutu batzuk → Eguneratu saldoa |
| Urteko lizentzia berritu | Diru-zorroa | Urtea berritu (lizentzia bera, ez sortu beste bat) |
| Txateak ez du erantzuten | Konexioa + Diru-zorroa | Lizentzia baliozkoa, saldoa > 0, agentea ez dago pausatuta , cachea hustuta |
| IA-k ez ditu nire datuak “ikusten” | Agentearen alboko barra | CSV/SQL aldaketaren ondoren sinkronizatu ? Bektore bat badago entrenatu ? Konfiantza-atalase txikiagoa? |
| Erregistroen zerrenda masibo berehalakoa | Jolastokia / Txat Publikoa | Core ≥ 1.0.118 : ENTITY + jarduera-taxonomiarekin mapatzea → galderak zerrendatzea Hub-aren menpe egon gabe (§11) |
| Zerrendako “azkenaren” kontaktua edo irudia | Txat bera, hurrengo txanda | Zerrendatu ondoren: «azkenaren kontaktua?» / «irudirik?» — Telefonoa , Irudia , Logotipoa rolak mapatzean (§7.3, §11). Urruneko SQL-arekin: Sinkronizatu 1.0.164+ ondoren (§11.6) |
| CPT laguntzailea urruneko SQL-rekin | Orokorra → CPT laguntzailea | Core ≥ 1.0.162 : iturri mota aktiboak bakarrik zerrendatzen ditu (urrunekoa / lokala / anitzekoa / gehigarria); ez ditu WordPress txat CPTak nahasten (§7.2) |
1. Menuaren egitura WordPress-en
Xabia Agent Core aktibatu ondoren, Xabia Agent menua agertzen da mahaigainean “superheroi” ikono batekin.
| Menu sarrera | Zer erakusten duen |
|---|---|
| Xabiako agentea | Pantaila nagusia: agenteen zerrenda, gehigarrien erakusleihoa eta AI konexio bloke globala (lizentzia + hodeiko modua / azpiegitura propioa). |
| Gehigarriak | Ordainketa-gehigarrien txartelak (Avirato, MEC, Woo, Central…), lizentzia-giltza, hala badagokio (Hub-aren balidazioa), Polar denda eta bezeroen ataria , berritze-jakinarazpenak harpidetza iraungitzear badago eta Pluginetarako estekak. Smart QR ez da gehigarri bat: Core-an sartuta dago ( Smart QR / Totems fitxa agente bat editatzean). |
| Diru-zorroa | Token saldoa, 30 eguneko kontsumoa, kargatzeko paketeak eta berritzea, hala badagokio. |
Aukerak zure guneak instalatuta duenaren arabera.
- Xabia Central aktibo baduzu, Federazioa (Xabia Central) azpimenu gisa ikus dezakezu funtzio hori erabiltzean hainbat gune edo nodo lotzeko.
- Nexus Federation gehigarria baduzu, Federation edo Nexus Federation gisa ager daiteke (ikusi gehigarri horren eskuliburua erabiltzen baduzu).
Ia ezarpen guztiak aldatzeko, WordPress administratzaile gisa saioa hasi behar duzu (edo pluginak eta gunearen aukerak kudeatzeko aukera ematen dizun baliokide den profil batekin).
2. Pantaila nagusia: agenteen zerrenda
Xabia Agent agente zehatz bat editatu gabe irekitzen duzunean, hau ikusiko duzu:
2.1 Titulua eta akzioak
- Agente berria: Sortu profil berri bat eta ireki editorea. Lehen aldiz gordetzean, sistemak identifikatzaile egonkor bat esleitzen dio (izenetik eratorria); kode hau da geroago web orrian itsatsiko duzun kode laburrarekin (ikus behean).
2.2 Dauden agente txartelak
Txartel bakoitzak erakusten du:
- Agenteak panelean ikusiko duen izena .
- ID:
ID: mi-asistentebezalako kode bat,kode laburrean dagoenarekin bat etorri behar duena. - Editatu: agentearen ezarpen guztiak irekitzen ditu.
- Ezabatu: Agenteak sortutako ezagutza guztia (sinkronizazioan eta entrenamenduan ikasitakoa) ezabatzen du. Ekintza hau ezin da klik bakarrarekin desegin .
Agente bat ezabatzen baduzu, haren konfigurazioa, datuen mapaketak eta lotutako memoria galduko dituzu. Agente horrentzako CSV fitxategi bat igo baduzu, fitxategia zerbitzarian gera daiteke; jada behar ez baduzu, Mediatik edo FTP bidez ezaba dezakezu, zure egoeraren arabera.
2.3 “Eskuragarri dauden gehigarriak” blokea
Xabiak ezagutzen dituen pluginak (gehigarriak) dituzten txartelak: izena, deskribapen laburra eta instalatu edo kudeatzeko esteka. Plugin bat aktibatu edo desaktibatu WordPress Pluginetan ere egiten da, beste edozein pluginekin bezala.
Garrantzitsua: gehigarri bat instalatuta egon daiteke baina inaktibo, edo aktibo egon baina beste konfigurazio bat behar izan dezake (gehigarrien lizentzia, taulak, etab.).
2.4 Agente bat pausatu (zerrenda)
Zerrendako txartel bakoitzak hiru ekintza ditu: Editatu , Pausatu / Aktibatu eta Ezabatu .
- Pausa: agentea gunean bistaratzeari uzten dio (kode laburra eta abiarazle flotatzailea ez dira agertzen).
Konfigurazioa eta memoria gordetzen dira.
- Pausatuta badago, txartelak Pausatuta etiketa bistaratzen du eta botoia Aktibatu bihurtzen da.
2.5 Agentearen txataren interfazea (Itxura fitxa)
1.0.28 bertsiotik aurrera, interfazea agente bakoitzeko konfiguratzen da Agentearen edizioa → Ezarpenak / Itxura atalean, “Txat interfazea (Avatar eta panela)” atalean (Txat koloreak ondoren). Elementor eta HTML blokeak ez dira beharrezkoak orrialdean.
1.0.57 bertsiotik aurrera modu bereiziak daude argi eta garbi; 1.0.192+ bertsiotik aurrera txerta daitekeen abiarazlea ere badago:
| Modua | Zer erakusten da | Noiz erabili behar da |
|---|---|---|
| Natiboa ( Webgunean kode laburrik gabe erakutsi ) | Avatar flotatzailea + txat panela automatikoki txertatuta webean. | Xabia global botoia guneko orrialdeetan nahi duzunean. |
Txat laburtua ( ) | Txertatutako txata bakarrik, non kode laburra itsatsi dudan; ez da avatar flotatzailerik agertzen. | Orrialde edo lurreratze-orri batean panel osoa nahi duzunean. |
Abiarazlea ( edo ) | Edukiaren avatar botoia bakarrik txertatuta; bertan klik egitean jatorrizkoaren panel bera irekitzen da. | Hero, Elementor zutabeak, ekintza-ekintzak. Tamaina: sm / md / lg / xl edo pixelak ( size="320" ). |
“Erakutsi orrialde hauetan bakarrik” eta “Baztertu orrialde edo argitalpen hauek” arauak modu natibokoak dira. Kode laburra/abiarazle moduan, txata edo botoia kode laburra itsatsi den lekuan bakarrik agertzen da.
Avatar Zinetiko Ofiziala (1.0.47 bertsioa)
Berezko abiarazleak Xabia panpina erreproduzitzen du SVG geruza lerrokatuetan (burua, begi-zulo zuriak eta begiak/satelitea), 125×125 px-ko kutxa batera eskalatua:
| Geruza | Zer ordezkatzen du? | Kolore konfiguragarria |
|---|---|---|
| Burua | Avatar oinarrizko zirkulua | avatar_colors.bg |
| Arroak | Bi zirkulu zuri begi azpian | avatar_colors.shadow |
| Begiak eta satelitea | Bi begi/pupil eta puntu apaingarri bat alboan | avatar_colors.dots eta bigarren mailako aldaera |
Avatarrak sakonera efektu batekin begiratzen dio kurtsoreari : burua oso gutxi mugitzen da, begi-zuloak apur bat gehiago, eta begiak/satelite eremua gehiago mugitzen da (GSAP animazioa). Irudi pertsonalizatu bat ere erabil dezakezu (PNG/SVG Media-tik).
Web portaera (Elementor gabe)
| Portaera | Deskribapena |
|---|---|
| Abiarazle flotatzailea | Beheko eskuineko marjina konponduta (edo ezkerrekoa / marjina pertsonalizatuak). |
| Joan | Botoia orrialdean behera mugitzean agertzen da; Gora igotzean ezkutatzen da (Xabiaren bertsio klasikoan bezala). |
| Txat-panela | Eskuinera/ezkerrera flotatzen, lausotze-modal zentratua edo pantaila osoa. |
| Gortina | Txata irekitzean, pantaila osoan lausotuta dagoen atzeko plano erdi-gardena dago. |
Itxura paneleko aukerak
| Doikuntza | Zer egiten ari zara? |
|---|---|
| Abiarazle mota | Avatar zinetikoa (natibo) edo irudi pertsonalizatua. |
| Avatar koloreak | Buruko tindagaia, begi-zuloak eta avatar natiboen begiak. |
| Abiarazlearen posizioa | Beheko eskuineko, beheko ezkerreko edo marjina pertsonalizatuak (px, vh, vw). |
| Panelaren portaera | Eskuinera flotatzen, ezkerrera flotatzen, modal erdian, pantaila osoa. |
| Avatar hiztuna | Aktibatu murgiltze modua (avatar/antzerki handia) panela irekitzean. TTS isilarazteari uko egin gabe: ahotsa isilarazteak ez du bozgorailua itzaltzen (Core ≥ 1.0.200). |
| Erakutsi gunean kode laburrik gabe | Aktibatu modu natiboa: avatar flotatzailea + panel automatikoa. Markatu gabe badago, erabili edo . |
| Orrialde hauetan bakarrik erakutsi | Modu natiboa orrialde zehatzetara mugatzen du. Bazterketa orokorren gainetik lehentasuna du. |
| Bazterketak | Ezkutatu modu natiboa eduki motaren, orrialdeen IDen eta WooCommerce saskiaren/ordainketaren arabera. |
Gorde Gorde Agentearekin . Jatorrizko moduan, pluginak automatikoki txertatzen ditu abiarazlea eta aktiboak wp_footer . Kode labur moduan, itsatsi edo dagokion lekuan.
Txataren itxura (1.0.197–1.0.201 bertsioa)
Panelak jarioaren diseinua erabiltzen du (mezu-burbuilarik gabe), izkin karratuak eta idazteko eremuaren gainean kurtsorea jartzean agertzen diren kontrolak (bidali/mikrofonoa/isilarazi). Erabiltzailearen testuak avatarraren azentu-kolorea heredatu dezake. Bot-en erantzunek oinarrizko Markdown ( **negrita** , zerrenda puntudunak) onartzen dituzte 1.0.201 bertsiotik aurrera.
Txertatutako txata kode laburrarekin: halo eta fokua
Kode laburrak sortutako txatak panel natiboaren estetika mantentzen du: ertz argitsu animatua eta itzal leuna. Testu-eremuan zentratuz, pluginak txata orriaren gainetik altxa dezake eta atzeko planoa estaltzen duen gainjartze lauso bat bistara dezake irakurgarritasuna hobetzeko.
Gainjartzea ixten da txatetik kanpo klik egiten duzunean, Ihes tekla sakatzen duzunean edo mugikorrean ixteko botoia erabiltzen duzunean. Geruza hau avatarraren jatorrizko atzeko planoarekiko independentea da: kode laburra txertatutako txat bat izaten jarraitzen du, ez abiarazle flotatzaile bat.
/xabia-box/ ibilbideak (Smart QR / totem) txata pantaila osoan erakusten du, abiarazle flotatzailerik gabe .
QR adimenduna, kode sortzailea eta totem modua Core-k barne hartzen ditu — ikusi QR adimendunaren eskuliburua adibideekin gida osoa lortzeko.
2.6 Dokumentazio digitala (xabia.ai/docs)
Produktuen eskuliburuak PDF eta HTML formatuetan argitaratuta daude hemen:
| Baliabidea | URLa |
|---|---|
| Aurkibidea — Xabia AI Eskuliburuak | https://xabia.ai/docs/ |
| Xabia Agentearen Oinarrizko Eskuliburua | https://xabia.ai/docs/manual-usuario-xabia-core.pdf |
| QR adimendunen eskuliburua / Totemak (Oinarrizkoa) | https://xabia.ai/docs/manual-usuario-xabia-smart-qr.pdf |
| Xabia MEC eskuliburua | https://xabia.ai/docs/manual-usuario-xabia-mec.pdf |
| Xabia Woo eskuliburua | https://xabia.ai/docs/manual-usuario-xabia-woo.pdf |
| Xabia Aviratoren eskuliburua | https://xabia.ai/docs/manual-usuario-xabia-avirato.pdf |
Garapen biltegian, iturburuak xabia-agent-plugins/documentation/ karpetan daude eta ./scripts/build-modular-manuals-pdf.sh komandoarekin birsortzen dira.
3. AI konexioa (txartel globala)
Hemen erabakitzen duzu nola konektatzen den zure webgunea adimen artifizialarekin eta xabia.ai zerbitzuarekin gomendatutako modua erabiltzean.
Erabili orrialde berean dagoen Gorde Ezarpenak botoia (ez nahasi agente baten barruko Gorde agentearekin ).
3.1 Konexio modua
Bi aukera dituzu:
| Aukera | Bistaratzeko izena | Zer esan nahi du honek zuretzat? |
|---|---|---|
| Xabia Hodeia | Xabia Cloud (gomendatua) | Zure guneak Xabia lizentzia bat eta zure kontuaren token saldoa erabiltzen ditu. Elkarrizketak Xabiaren azpiegituretatik igarotzen dira; ez dituzu zure OpenAI edo Google gakoak hemen edo agente bakoitzean itsatsi beharrik: lizentzia eta saldo nahikoa baduzu, dagoeneko estalita zaude. Baliteke OpenAI eta Google arteko hautatzailea agentean ez ikustea; sistemak automatikoki ezartzen du hodeiko konfigurazio egokia. |
| Autonomoa | Azpiegitura propioa | Fakturak zuzenean zure OpenAI edo Google Cloud (Vertex) kontuan kobratzen dira. Normalean API gakoak eta Google Cloud atala ikusiko duzu kredentzial bideak konfiguratzeko. Baliteke Xabia lizentzia bat beharrezkoa izatea beste funtzio batzuetarako, zure planaren arabera; hala ere, hemengo fakturazio eredua zuzenean kanpoko hornitzaileekin duzuna da. |
Moduak aldatu ondoren , egiaztatu agente bakoitza: Hodeian ez duzu “motorra”z kezkatu beharrik; zure azpiegituran egiaztatu behar duzu zein hornitzaile erabiltzen duen bakoitzak eta bideak/giltzak zuzenak diren.
3.2 Lizentzia eta oreka
Informazio blokea (tokenak eta iraungipena)
- Geratzen diren tokenak: Sistemak zure lizentzia egiaztatu ondoren bistaratzen dena da hau. Azken sinkronizaziotik denbora pixka bat igaro bada, barra bat ager daiteke Saldoa eguneratu sakatu arte.
- Iraungipena: sistemak jasotzen duenaren arabera, zure lizentzia aktibo dagoen data.
- Egiaztatuta: azken egiaztapena zerbitzu zentralaren aurka egin zenean.
Saldoa eguneratu botoiak Xabia berriro aktibatzen du eta informazio hau freskatzen du. Lizentziarik gorde ez baduzu oraindik, aldez aurretik jakinaraziko dizu.
Lizentzia baliodunik edo saldo nahikorik ez baduzu , baliteke txatak ez erantzutea edo saldo edo lizentzia nahikorik ez dagoela dioen mezu bat erakustea, zerbitzuaren ezarpenen arabera.
“Xabia Lizentzia gune honetarako” eremua
- Pasahitz motako eremua da;
Begiaren ikonoa erabil dezakezu orain idazten ari zarena bakarrik ikusteko .
- Lizentzia bat gordeta baduzu eta eremu hau hutsik uzten baduzu gordetzean, lizentzia zaharra ez da ezabatuko . Lizentzia behin betiko kentzeko, erabili “Ezabatu gordetako lizentzia” kontrol-laukia (ikus behean).
- Lizentzia bidali dizuten kate berri batera aldatu nahi duzunean bakarrik itsatsi hemen.
Lizentzia gordeta: izartxoak eta agian pantailako azken karaktere batzuk bakarrik ikusiko dituzu (segurtasunagatik).
Alerta horia: Sistemak gordetako fitxategiak panel ID baten itxura duela detektatzen badu (adibidez, lic_… -rekin hasten bada) eta ez xabia_ rekin hasten den aktibazio-kate luzea , abisatuko dizu: zerbitzuak ziurrenik ez du onartuko. Ohiko irtenbidea gordetako lizentzia ezabatzea , berriro gordetzea eta posta elektronikotik edo erosketa-agiritik ateratako gako osoa itsatsitzea da.
“Ikusi WordPress-en gordetako lizentzia” botoia
Zure WordPress gunean benetan gordeta dagoena erakusten du (tarte arrarorik edo mozketarik gabe). Administratzaile fidagarriek bakarrik erabili beharko lukete: lizentzia ikusten duen edonork beste gune batean erabil dezake kopiatuz gero.
Nola babesten da konexioa?
Lizentzia zuzena denean, pluginak xabia.ai-ri zure gunea modu seguruan identifikatzeko erabiltzen du eskaerak bidaltzean. Ez duzu xehetasun teknikoak ulertu beharrik: lizentzia aldatzen baduzu, berriak gordetzean hartuko du indarra. Pantailatik izartxoak itsatsi badituzu benetako gakoaren ordez, sistemak gordetako lizentzia baliozkoa ez gainidazten saiatuko da.
“Ezabatu gordetako lizentzia gune honetatik” kontrol-laukia
- Hautatu eta Gorde ezarpenak aukeran klik eginez gero, gune honen lizentzia ezabatuko da.
- Ondorioa: Txatak gako horrekin lotutako Xabia zerbitzua erabiltzeari utziko dio beste lizentzia baliozko bat itsatsi arte.
- Ez ditu automatikoki ezabatzen zure OpenAI edo Google giltzak atal aurreratutik; Xabia lizentzia bakarrik.
3.3 API gakoak eta Google Cloud (kontu propioa)
Atal hau “Azpiegitura propioa ” hautatu baduzu bakarrik agertzen da. Tolestuta dago gehiegizko kargarik ez izateko: ireki ezazu kredentzialak konfiguratzeko prest zaudenean.
OpenAI — gakoa (hemen globala)
- Zure OpenAI konturako gako sekretua da.
- Erabilgarria da agentea OpenAI erabiltzeko konfiguratuta dagoenean eta horretarako bakarrik den gako desberdin bat ez duenean.
- Bankuko pasahitz bat bezala tratatu: norbaitek kopiatzen badu, zure izenean gastuak egin ditzake. Aldatu OpenAI aginte-paneletik filtratu dela uste baduzu.
Google Cloud (Vertex AI) — zerbitzu-kontuaren JSON fitxategirako bidea
- Google-k Vertex/Gemini baimenak dituen zerbitzu-konturako ematen dizun JSON fitxategirako zerbitzariaren bide osoa izan behar du.
- Agente espezifiko batek ezer betetzen ez badu, ibilbide global hau erabiliko da.
Ohiko erroreak: bide-izena gaizki idatzita, zerbitzariak ezin du fitxategia irakurri, kontuak ez du Vertex baimenik, edo proiektua/eskualdea ez dator bat Google-n erabiltzen duzunarekin.
Google Cloud — Maps gakoa
- Txatean dauden mapetarako edo Google Maps integratzen dituzten elementu bisualetarako, zure proiektuak erabiltzen badu.
Nexus Federazioa — “Aktibatu Zubi Modua Bakarrik”
Nexus Federation gehigarria instalatuta baduzu bakarrik ikusiko duzu hau.
Garrantzitsua: Xabia Cloud erabiltzen ari bazara, pantaila honetan laukitxo hau markatzeak edo desmarkatzeak agian ez du espero bezala gordeko ; benetako balioa guneak lehendik zuena izango da. Bridge modua segurtasunez aldatzeko, erabili zure azpiegitura edo Nexus eskuliburuan adierazitako pantaila.
Zer da Bridge modua (laburbilduz): Zure WordPress guneak federazioko beste guneentzako datu-zerbitzari gisa jokatzen du. Ez da ohiko modua hotel edo denda batentzat, bere orrialdean txat funtzio bat besterik ez nahi duena. Nahi gabe gune publiko batean aktibatzen baduzu, ohiko txat kode laburra agian ez da behar bezala bistaratuko.
Kontsultatu federazioak eskatu dizunarekin.
Aholkua: Federazioak zertarako balio duen ez badakizu, ez hautatu Zubi modua soilik .
4. Agenteen editorea: ikuspegi orokorra
Editatu edo Agente berria aukeran klik egiten duzunean, formularioak fitxak erabiltzen ditu. Core-ren fitxa lehenetsiak hauek dira:
- Orokorra — oinarrizko datuak, IA motorra zure azpiegitura erabiltzen baduzu bakarrik, iturriak (CSV/SQL…) eta nola etiketatu zutabeak bot-erako.
- QR / Totem Adimendunak (Muina) — lurreratze orria, tunel URLak, entitate bakoitzeko QR sorgailua, kiosko modua. QR Adimendunen eskuliburu zehatza .
- Nortasuna — koloreak, ahotsaren irakurketa, zenbat testuinguru erabili, erantzun mugak eta laguntzailearen “gidoia” orokorra.
- Elkarrizketa erregistroa — azken historia gordeta dago gaituta badago.
Gehigarriek fitxa gehigarriak gehi ditzakete agente beraren barruan (adibidez, Avirato ).
Aldaketak aplikatzeko, sakatu Gorde agentea amaieran; ordura arte, zirriborroak bakarrik bistaratzen dira.
5. “Orokorra” fitxa
5.1 Agentearen izena
- Zu eta zure taldearen izena panelean ikusgai.
- Agentearen lehen sorrera gaur bertan egiten baduzu, kode laburraren identifikatzailea izenetik sortzen da. Dagoeneko dagoen agente baten izena aldatzen baduzu bakarrik, kode laburraren identifikatzailea normalean mantentzen da (itsatsitako URL zaharra aldatu gabe geratzen da).
5.2 Kode laburra
Agente bat gorde ondoren, honako hau bistaratzen da:
WordPress orrialde batean itsatsiz Argitaratu agente horren txata (agentea Pausatua ez badago).
- “Erakutsi gunean kode laburrik gabe” gaituta badago, kode laburra interfaze natiboarekin batera egon daiteke, baina avatar flotatzailea Itxura ezarpenek kontrolatzen dute.
- “Erakutsi gunean kode laburrik gabe” desgaituta badago, kode laburrak orrialde horretan txertatutako chatbot-a bakarrik erakutsiko du, avatar flotatzailerik edo ikusgarritasun-arau natiborik gabe.
Gehigarri batzuek kode labur beraren barruan aukera gehigarriak onartzen dituzte (hizkuntza, totem modua, mezuetan agertzen den laguntzaile-izena, etab.): egiaztatu hauek erabiltzen duzun gehigarri bakoitzaren eskuliburuan. lang atributua, erabiltzen denean, interfazearen eta ordezko hizkuntza gisa balio du; ez du blokeatzen IAk erantzuna idazten duen hizkuntza (§10.11).
5.3 Xabia Cloud Block (UIa Cloud moduan dagoenean)
Mezu informatiboa: agenteak Xabia zerbitzua erabiltzen du; lizentzia eta saldoa pluginaren pantaila nagusian kudeatzen dira, ez hemen, agentearen barruan.
Ikuspegi honetan ez duzu motor edo Google Cloud aukera bikoizturik ikusiko: sistemak agente horretarako gordeta duen eta Xabia Cloud-ekin koherentea dena erabiltzen du.
5.4 Intelligence Engine (jabedun azpiegituretan bakarrik agertzen da)
Inteligentzia Motorra:
| Aukera | Zer esan nahi du praktikan? |
|---|---|
| OpenAI | Erabili OpenAI zerbitzuak txaterako eta, hala badagokio, ezagutzaren “memoria” bektore bat sortzeko. |
| Google Cloud (Vertex) | Erabili Gemini/Vertex zure konfigurazioaren arabera; zerbitzarian JSONerako bide zuzena behar duzu. |
Google JSON fitxategia agente bakoitzeko (aukerakoa): hutsik badago, ezarpen orokorretarako bide orokorra erabiltzen da.
OpenAI gakoa agente honetarako bakarrik (aukerakoa):
- Bete eta gordetzen baduzu, agente honek gako hori erabiliko du eta ez gako orokorra.
- Editatzerakoan hutsik uzten baduzu eta agenteak giltza bat bazuen, aurrekoa gordetzen da normalean .
- Bere modu eta lizentzia globalaren arabera, behar den tokian tokiko gakorik ez badago, sistemak Xabia proxyaren bidez bideratu dezake;
Kasuaren araberakoa da.
Aholku praktikoa: agente batek zure OpenAI kontu zuzena erabiltzen badu eta beste batek ez, hornitzaile bakoitzarentzat kostu bereiziak ager daitezke; kontuan izan zeinek erabiltzen duen zein, batek baino gehiagok kudeatzen badu.
6. Informazio iturria (laguntzaileak nondik ikasten duen)
Hemen erabakitzen duzu sistemak zer datu “irakurri” behar dituen txatak erabiltzen duen memoria sortu aurretik (FAQak, katalogoa, egituratutako edukia, etab.). Hau gehigarri batzuek mezu bakoitzari gehitzen dioten testuinguru automatikotik bereizita dago (adibidez, erreserbaren erabilgarritasuna).
Pluginak pantailan gogoraraziko dizu gehigarri aktiboek informazio gehigarria eman dezaketela hau bakarrik igaro gabe ; zerrenda honetan aukeratzen duzuna CSV, SQL edo konektoreekin kontrolatzen duzun ezagutza-basea da.
6.1 CSV fitxategiak
- Taula-katalogoetarako erabilgarria: produktuak, interesguneak, Exceletik CSV gisa esportatutako zerrendak.
- CSV igotzean fitxategia gunean gordetzen da eta agente honetara lotzen da.
- CSV ezabatzeak lotutako fitxategia eta erreferentzia ezabatzen ditu.
- CSV arakatu/eskaneatu fitxategiak zutabeak detektatzen ditu eta mapaketa prestatzen du (zutabe bakoitzak zer esan nahi duen bot-arentzat).
- Oro har, zutabeak komaz edo puntu eta komaz bereizten diren bereizten du.
Gogoratu: Datuak sinkronizatu botoian klik egin arte —eta, antzekotasun semantikoaren bilaketa erabiltzen ari bazara, Trebatu botoian klik egin arte— , baliteke laguntzaileak ez ikustea errenkada horiek erantzunetan behar bezala.
6.2 WordPress datu-basea (SQL lokala)
WordPress datu-baseari berari egindako kontsulta bat. Erabili {prefix} karaktere-iturria gaiak adierazten duenean: sistemak zure taulen benetako aurrizkiarekin ordezkatuko du (normalean wp_ edo zure hosting hornitzaileak konfiguratutako beste aurrizki bat).
Aholkua: Kontsulta oso zabalek gunea moteldu edo datu gehiegi berreskuratu dezakete. Probatu lehenik babeskopia/garapen ingurune batean edo muga arrazoizkoekin.
6.3 Kanpoko datu-basea (urruneko SQL)
Bete Host , Database Name , Username , Password eta kontsulta katalogoa WordPress-etik kanpo dagoenean.
Kanpoko datu-basea Modern Events Calendar duen WordPress gune bat bada, urruneko MEC aurrezarpena erabil dezakezu. Core-k gertaeren SQL kontsulta beteko du, gomendatutako mapaketa aplikatuko du ( Evento , Fecha , Hora , Lugar , Link , Precio , Descripcion , Categorias_Tags , Imagen_URL ) eta sql_preset = mec_remote gordeko du.
Erabili aurrezarpen hau txat gunean MEC gehigarria instalatuko ez duzunean. Xabia MEC aktibo baduzu, gomendatutako fluxua Gehigarrien konektoreak → MEC urruneko SQL kredentzialekin (§6.4) da, Woo-ren berdina.
Segurtasuna: kredentzialak agentearekin gordetzen dira; idealki, urruneko zerbitzariak zure webgunearen IP helbidetik datozen konexioak bakarrik onartu beharko lituzke.
6.4 Gehigarrizko konektoreak
Gehigarri bateragarri bat instalatuta eta aktibo badago bakarrik dago eskuragarri. Eskuragarri ez dagoela agertzen bada, lehenik instalatu plugin hori Plugins ataletik.
Hautatu ondoren, erabili Konektatu eta Mapa erabili aurretik erakusten dituen zutabeak berrikusteko.
MEC eta Woo gehigarriek urruneko datu-base batekin ere funtziona dezakete Host/DB/username/password eremuak erabiliz. Kasu horretan, modua natibo izaten jarraitzen du (arauak, mapaketa eta domeinu ekintzak eskaintzen dituelako), baina SQL irakurketa beste WordPress gune baten aurka egiten da.
Urruneko MECetarako (Core ≥ 1.0.202 + MEC gehigarria), txat guneak ez badu tokiko Modern Events Calendar-ik, laguntzaileak ez ditu inoiz erreserba botoi lokalak erabiltzen ( [ACTION:BOOK:ID] ): bisitaria [ACTION:URL:Link] bidez bideratzen du urruneko gertaeraren Link zutabea erabiliz.
6.5 Hainbat iturri aldi berean (“iturri anitzeko”)
Gehienez bi iturri konbina ditzakezu (adibidez, urruneko SQL + CSV).
- Zati bakoitzak bere datuak eta bere zutabe-mapeatzea darama.
- Urruneko eremuetan, aurrizki automatiko batek lagun dezake askotan,
{prefix}-ren irizpide berdinak erabiliz.
Aholkua: Iturri gehiagok malgutasuna eskaintzen dute, baina baita akatsak egiteko leku gehiago ere; berrikusi bloke bakoitza arretaz.
7. Datuak fitxako tresnak
7.1 SQL kontsulta probatu (errenkada bat)
Zure kontsultaren proba-irakurketa bat egiten du ( lehenengo errenkada bakarrik ) zein zutabe detektatzen dituen erakusteko eta mapaketarekin laguntzeko. Saihestu kontrolatu gabeko ekoizpen-guneetan trafiko puntako aldietan erabiltzea: proba-tresna bat da.
7.2 WordPress Edukien Laguntzailea (“Curating Console”)
Pausoz pausoko laguntzaile bat, honako hau egiten duena:
- Zerrendatu iturri aktiboaren eduki motak (ez WordPress txatarenak iturria desberdina bada).
- Iradoki zein eremu diren interesgarriak bot-arentzat (izenburua, testua, metadatuak, taxonomiak…).
- SQL kontsulta bat eta arrazoizko mapaketa bat agente-formulariora transferi ditzakezu.
Iturriaren araberako bereizketa (Nukleoa ≥ 1.0.162):
| konfiguratutako letra-tipoa | Zer zerrenda du CPT laguntzaileak? |
|---|---|
| Urruneko SQL | post_type urruneko datu-basean argitaratuak (SQL Bridge bidez). Inoiz ez plugin guneko CPT lokalak. |
| tokiko SQL | Uneko WordPress motak ( $wpdb ). |
| Iturri anitzeko | Sakatutako botoiaren iturria bakarrik (1, 2… indizea). |
| Gehigarria (MEC / Woo…) | Gehigarriaren CPT natiboa bakarrik ( mec-events , product , …). Gehigarriak urruneko SQL erabiltzen badu, balioztatu bertan. |
Modalak iturburuaren abisua erakusten du (adibidez, “Urruneko datu-basea”). Eskema sakonean, Woo produktuek _price / _sku / stock metaetiketak dituzte; MECek kalkulatutako zirrikituak barne hartzen ditu, hala badagokio.
Zer da “Entitatea”: markatu elementu bakoitza modu bakarrean identifikatzen duen eremua (erabilgarria QR esperientzietan edo bisitariak txartel espezifiko bat “aukeratzen” duenean).
Eduki mota baten metadatuak gehitzeko lasterbide bat ere badu, morroi osoa igaro gabe.
7.3 Zutabeen mapaketa (errepika daitezkeen atributuak)
💡 Pentsa ezazu modu sinplean: IA izugarri adimentsua da, baina ezin du asmatu zure Excel kalkulu-orrian zein zenbaki den telefono-zenbaki bat, zein prezio bat edo zein gelaxka den irudi baterako esteka bat. Mapatzailean Telefonoa edo Irudia rola esleituz, zure negozioaren giltzak ematen dizkiozu: bezero batek enpresa baten telefono-zenbakia eskatzen duenean bere kontaktuen zerrenda betetzen irakasten diozu.
Lerro bakoitzeko, aukeratu:
- CSV/SQL zutabea edo eremua .
- Erabiltzeko moduko etiketatzea (“Prezioa”, “Erreserba telefono zenbakia”…).
- Txatean funtzio bisuala, txartel aberatsa erakusteko egokia denean: izenburua, testua, data, irudia (argazkiak/galeria), logotipoa (marka korporatiboa), telefonoa, webgunea, posta elektronikoa, mapa, etab.
- IDENTITATEA (ENTITATEA) eremu horrek zure proiektuko erregistro bakarrak bereizten baditu.
Enpresen katalogoetarako funtsezko eginkizunak (Core ≥ 1.0.118):
| Ikusmen-rola | Noiz erabili behar da |
|---|---|
| Irudia | Establezimenduaren, galeriaren eta erakusleihoaren argazkiak |
| Logotipoa | Enpresaren marka; Ez nahastu argazkiekin. |
| Telefonoa | Telefono bidezko kontaktua |
| Weba / Posta elektronikoa | Estekak eta posta elektronikoa |
| IDENTITATEA (ENTITATEA) | Erregistro bakoitzeko eremu bakarra (izena, barne kodea, etab.) |
Core-k ez ditu bezero zehatz batentzako eremu-izen finkoak onartzen. Dena mapaketa honen bidez konpontzen da.
WordPress-eko zutabe tipiko batzuek “garun” ikono bat erakusten dute ezagutza-testu nagusirako hautagai onak direla nabarmentzeko — ez duzu ukitu beharrik behar ez baduzu.
8. QR adimenduna eta totem modua (Core-n sartuta)
1.0.59 bertsioaz geroztik, Smart QR- ren potentzia guztia (entitate tunela, kode sortzailea, /xabia-box/ , kiosko modua) Xabia Agent Core- ren parte da. Ez dago plugin bereizirik instalatu edo lizentziatu beharrik.
8.1 Hiru urratseko laburpena
- Sinkronizatu ezagutza gutxienez IDENTITATEA (ENTITATEA) gisa markatutako zutabe batekin (§7.3).
- Argitaratu orrialde bat
helbidearekin eta hautatu Landing Page gisa Agente Editatu → Smart QR / Totems atalean. - Egin klik nahi duzun entitatearen ondoko QR sortu aukeran, deskargatu PNG fitxategia eta inprimatu.
Eskaneatzeak txata entitatearen testuinguruarekin irekitzen du (agurra eta RAG mugatua). Sortutako URLaren adibidea:
8.2 Totem modua (kiosko motako pantaila publikoak) https://su-dominio.com/asistente/?ente_id=sala-impresionismoSmart QR / Totem- etan Totem Modua aktibatu eta jarduerarik gabeko minutuak definitu ditzakezu: txata erabili gabe denbora hori igaro ondoren, saioa hasierako agurrera itzultzen da (erabilgarria harreran tablet batean).
Pantaila osoko bidea ere erabil dezakezu:
Kode laburrean minutuak behartu ditzakezu honekin: https://su-dominio.com/xabia-box/?x_project=ID_DEL_AGENTE totem="10" :
Laburpena: QR adimenduna = entitate bakoitzeko posterrak eta estekak; totem modua = kioskoa pantaila finko batean. Ez duzu bata edo bestea erabili beharrik webean txat klasikoa bakarrik nahi baduzu.
8.3 Dokumentazio zabaldua
Museo, hotel, txikizkako kasuak, POI ?xqr= , xabia-smart-qr plugin zaharraren migrazioa eta arazoak konpontzea: manual-usuario-xabia-smart-qr.md (PDF/HTML xabia.ai/docs/manual-usuario-xabia-smart-qr.pdf helbidean).
9. Alboko barra (gordetako agenteak bakarrik, ez “berriak”)
Eskuineko zutabea (memoria + Jolastokia) orrialdearekin batera mugitzen da (Core ≥ 1.0.165): ez dago goialdean finko. Horri esker, formulario osoa berrikusi dezakezu panel trabatuekin arazorik izan gabe.
9.1 Agentearen memoria (irudiak alboko barran)
- Sinkronizatutako erregistroak: azken Sinkronizatu datuak agintearen ondoren gehitutako lerroak.
- Bilaketa adimendunerako prest: zenbat piezak duten “zati semantikoa” prestatuta funtzio hori erabiltzen baduzu.
- Gaurko tokenak: agente horrek gaur zenbat gastatu dituen bere eguneroko mugarekin alderatuta (ikus behean Nortasuna atalean).
9.2 “1. Datuak sinkronizatu” botoia
Berriro irakurri zure CSV/SQL/iturri anitzekoa edo konektorea Orokorrean konfiguratu duzunaren arabera. Egin hau iturburu-fitxategiak edo kontsulta aldatu ondoren.
9.3 “2. Trena” botoia (bektorizazioa aplikatzen denean)
Prestatu testu zatiak antzekotasun bilaketarako . Zerbait gaizki ateratzen bada (Google baimena, Cloud saldo nahikoa ez, etab.), sistemak mezu argi bat bistaratuko du zuzentzeko.
9.4 “Ezabatu bektore memoria”
Agente honekin lotutako memoria matematikoa garbitzen du (ez du zertan diskoko CSV fitxategia ezabatu). Erabili datu asko mugitu ondoren hutsetik hasi nahi duzunean.
9.5 Proba Gunea (“Jolastokia”)
Bisitariak erabiliko duenaren antzeko laborategiko txata, baina oraindik orrialderik argitaratu gabe.
Jendaurrean ireki aurretik doikuntza finak egiteko aproposa.
10. “Nortasuna” fitxa
Hemen laguntzaileari “aurpegia eta ahotsa” ematen diozu. Gehigarri batzuek aukera gehiago gehi ditzakete pantaila honen behealdean.
10.1 Laguntzailearen izena (mezuetan)
Bisitariek bot-mezu bakoitzaren ondoan ikusiko duten izen laburra (lehenetsia “Xabia” da). Ez nahastu hau abiarazle flotatzailearen avatar zinetikoarekin (§2.5). avatar_name="…" erabil dezakezu kode laburrean pertsonalizatzeko.
10.2 Koloreak eta tipografia
- Identitatearen kolorea: botoiak eta nabarmendutako txataren xehetasunak.
- Txataren atzeko planoaren kolorea.
- Testuaren tamaina pixeletan (aukeratu mugikorrean eta ordenagailuan irakurgarria dena).
10.3 Ahotsa (arakatzailearen irakurgailua)
Bisitariak ozen irakurtzeko aukera erabil dezake bere nabigatzaileak baimentzen badu.
- Ahots mota (lehenetsia / femeninoagoa / maskulinoagoa): Hau sistemari zuzendutako iradokizun bat da; emaitza gailuaren araberakoa da.
- Abiadura: moteletik azkarrera, baimendutako tartearen barruan.
- Iragazkiak naturala izan dadin: testu lodia, izartxoak,
[ACCIÓN:…]bezalako marka teknikoak edo emojiak kendu ditzakezu, eta irakurri nahi ez duzun testu espezifikoa gehitu (adibidez, esteka oso luzeak).
Txatean, bozgorailuen botoia ahots isilatuaren eta ozen irakurtzearen artean txandakatzen da. Ekintza-botoi bat aktibo edo nabarmenduta dagoenean (ahotsa, mikrofonoa edo bidalketa), ikonoa zuri bihurtzen da koloretako atzeko plano batean kontrastea hobetzeko.
10.4 Testuinguruaren konfiantza-indizea
0 eta 1 arteko balioa (pantailan 0,20tik gertuko zerbait iradokitzen da normalean).
Laburbilduz: zenbateraino bat etorri behar du zure webguneko edukiak galderarekin modeloak erabili ahal izateko? Balio hau altuegia bada , laguntzailea selektiboagoa izango da: kritikoa edo generikoa bihur daiteke, nahikoa bat ez datozen piezak baztertzen dituelako. Balioa jaisten baduzu, testuinguru erlazionatuagoa onartuko du; batzuetan, zarata gehiago agertzen da datuak ondo antolatuta ez badaude.
Aholkua: Egokitu poliki eta probatu Jolastokian publikoarentzat ireki aurretik.
10.5 Zenbat luzea izan daiteke erantzun bakoitza?
Kontrolatu erantzun bakoitzak sor dezakeen testu-tamaina maximoa (sistemak tarte arrazoizkoa du gordeta).
Muga hau handitzea : erantzunak luzeagoak eta zehatzagoak izan daitezke, baina token gehiago ere erabiltzen dituzte eta denbora gehiago behar izan dezakete. Muga murriztea : erantzunak eraginkorragoak eta zuzenagoak dira, baina baliteke gaian hain sakon ez sakontzea.
10.6 Agente bakoitzeko eguneroko kontsumo muga
Agente honek egunean erabil ditzakeen token kopuru maximoa (kontagailua zerbitzuaren “egun teknikoaren” arabera ixten da, normalean ordu unibertsalean).
Muga hori gainditzen bada, txata mantentze-moduan sar daiteke agente horrentzat, nahiz eta zorro orokorrak saldoa izan: babes erabilgarria da gailurren edo ustekabeko gehiegikerien aurka.
10.7 Zenbat ezagutza-zati bidali galdera bakoitzean (“testuingurua”)
Txanda bakoitzean galderarekin nahas daitezkeen zure ezagutza-basearen zati kopurua (normalean tarte zabal batean; hutsik uzten baduzu, sistemak balio lehenetsi bat erabiliko du).
- Pieza gehiago: testuinguruari dagokionez aberatsagoak , baina garestiagoak eta batzuetan “sakabanatuagoak” edukia egokia ez bada.
- Zati gutxiago: ekonomikoagoa eta zuzenagoa, baina laguntzaileak lehentasun gutxiagoko beste zati batzuetan zeuden datuak kanpoan utz ditzake.
10.8 Bilaketa adimenduna (“bektore”) eta sentikortasuna
- Bektoreen bilaketa gaitu: Hau gomendagarria da entrenamendu ariketa bat egin baduzu eta alboko barran memoria erabilgarri dagoela ikusten baduzu soilik. Ezer entrenatu ez bada, laguntza testuak abisatuko dizu.
- Antzekotasun-atalasea (0–1): zenbatu ahal izateko, zenbaterainoko antzekotasuna izan behar du pieza batek galderarekin.
Balio oso altuek gai erlazionatuetan “ezer ez aurkitzea” eragin dezakete, baina ez berdin-berdinak.
10.9 Hasierako agurra
Bisitariak txata irekitzean ikusten duen HTML testu sinplea. WordPress-ek ohiko segurtasun arauak aplikatuko ditu baimendutako etiketekin lotuta.
10.10 Argibide orokorrak (nortasuna eta arauak)
Hemen idatzi behar duzu nor den laguntzailea , tonua (formala, atsegina, laburra) eta mugak (“ez du iritzirik ematen politikari buruz”, “ez ditu prezioak asmatzen datuak kontsultatu gabe”, etab.).
Aholku praktikoa: Ez duzu zure sektoreko sinonimo guztiak zerrendatu beharrik; datu onekin eta memoria ondo sinkronizatuarekin, erantzunak naturalagoak izango dira. Erabili taula hau negozioaren errendimendu egonkorra lortzeko.
10.11 Hizkuntzak eta erantzun eleaniztunak
Xabiak erabiltzailearen azken mezuaren hizkuntzan erantzuten du. Sinkronizatutako ezagutza gaztelaniaz badago baina bisitariak ingelesez, frantsesez edo euskeraz galdetzen badu, modeloak hizkuntza horretan idazten du erantzuna.
WordPress-ek edo kode laburraren lang atributuak konfiguratutako hizkuntzak batez ere interfaze estatikoari eragiten dio (leku-markak, botoiak, arakatzailearen ahotsa). Ez du IA behartzen beti hizkuntza horretan erantzutera.
Saihestu esaldi zurrunak gonbidapen nagusian, hala nola “erantzun gaztelaniaz soilik”, eleaniztun-jokabidea blokeatu nahi ez baduzu behintzat.
10.12 Hizkuntza anitzeko gunea WPMLrekin (agurrak + txat testuak)
Zure laguntzaileak automatikoki euskeraz edo ingelesez hitz egitea nahi duzu? WPML + String Translation , Core ≥ 1.0.72 eta Cloud lizentzia batekin, jarraitu 3 urratseko bide azkar hau:
- Idatzi zure hasierako agurra gaztelaniaz Nortasuna fitxan eta gorde agentea .
- Xabiak zure hizkuntza aktiboak detektatuko ditu eta (zure Cloud lizentziari esker) automatikoki itzuliko du agurra atzeko planoan.
- Joan WPML → String Translation atalera eta egiaztatu zure itzulpenak Xabia AI testuinguruan prest daudela. Hain erraza da!
Ondoren, garbitu gunearen katxea (LiteSpeed, Cloudflare…) eta saiatu URLak / , /eu/ , /en/ (edo erabiltzen dituzunak) inkognito moduan.
WPML ezarpen ezinbestekoa (lehen aldian bakarrik)
WPML → Ezarpenak atalean, joan behera Kateen itzulpena → Kateen jatorrizko hizkuntza aldatu → aukeratu Gaztelania .
Esteka hori ikusten ez baduzu: WPML → String Translation → Utilities eta ezarri gaztelania plugin kateen jatorrizko hizkuntza gisa. Horrela, agurra ingelesezko banderarekin agertzea saihestuko da, testua gaztelaniaz egon arren.
Txat testuak konpondu dira (“Idatzi hemen…”, botoiak)
Instalatu edo eguneratu ondoren gunea bisitatzen duzunean, Xabiak normalean txat interfazearen itzulpenak betetzen ditu (leku-marka, Bidali, Txata, etab.). Testuren batek hizkuntza aldatzen ez badu: garbitu cachea, itzuli interfazera eta egiaztatu Katearen Itzulpena. Oraindik hutsik badago, jarri harremanetan laguntzarekin; batzuetan birsinkronizazio behartua beharrezkoa da.
Zerbait ez badator bat
| Sintoma | Egin beharrekoa |
|---|---|
Beti agurtzen dut gaztelaniaz /eu/ | Egiaztatu agur-lerroa Xabia AI-n ; gorde agentea berriro |
| Bandera okerra, baina testua gaztelaniaz | Kateen jatorrizko hizkuntza = Gaztelania (goiko ezarpena) |
| “Idatzi hemen…” ez da itzultzen | Nukleoa eguneratua, katxea hustuta, bisitatu orri nagusia |
| Agurraren itzulpen automatikoa ez da abiarazten | Active Cloud lizentzia + gutxienez 2 hizkuntza WPML-n |
Ez duzu WPML edo Cloud lizentziarik? Agurra eskuz itzul dezakezu String Translation erabiliz; urrats automatikoa ez da exekutatuko.
11.
Katalogoa, urruneko pasaportea eta entitateen jarraipena (Core ≥ 1.0.118 / 1.0.164+)
1.0.118 bertsiotik aurrera, Xabia Agent Core-k sistemarekiko independentea den katalogo-motor bat barneratu du: enpresaren, produktuaren edo interes-puntuaren araberako zerrendak eta erregistro-datuak bezero jakin bati dagozkion eremu-izenekiko independenteak dira . 1.0.164 bertsiotik aurrera, zure datuak urruneko datu-base batean badaude, Xabiak automatikoki eranskin bat gordeko du sinkronizazioan Orokorra atalean (telefonoa, posta elektronikoa, webgunea, etab.) mapatu dituzun atributuak dituen erregistro bakoitzarekin.
11.1 Zer konpontzen duen
| Bisitariaren galdera. | Portaera |
|---|---|
| Jarduera / kategoriaren arabera zerrendatuta (“zer aukera…?”) | Zerrenda laburra: izena + xehetasun laburra. Ez sartu luzapenaren telefono zenbakia/helbide elektronikoa. |
| “Baduzu harremanetarako informazioa/telefono zenbakia…?” | Fitxa modua: tokiko WordPress guneko (urruneko) eranskina edo zuzeneko datuak erabiltzen ditu. |
| “Eta argazkirik?” | Argazkiak rolaren irudiarekin ; logotipoa bakarrik marka edo rolaren logotipoa eskatzen bada. |
11.2 Zer konfiguratu behar duzun (behin bakarrik)
- Zure katalogoarekin koherentea den datu-iturria (CSV, tokiko/urruneko SQL, iturri anitzekoa, gehigarria…).
- Gutxienez IDENTITY (ENTITY) eremu bat eta kontaktu/irudi rolak dituzten zutabeen mapaketa (§7.3).
- Zure proiektuan ezagut daitekeen jarduera-kategoria edo taxonomia bat — Core-k mapaketatik ondorioztatzen du, bertikal baten izen finkorik gabe.
WordPress txat bereko edukia: zerrendak eta informazioa zuzenean irakur daitezke (ez da sinkronizaziorik behar lasterbide horretarako).
Datuak urruneko SQL / Hub-ean (Core ≥ 1.0.164): Sinkronizatu egin behar dituzu (eta Hub-era bidali hodeiko bilaketa erabiltzen baduzu) telefonoa, posta elektronikoa, etab. erregistro bakoitzarekin batera bidaiatu dezaten. Xabiak ez ditu eremuak sortzen : Orokorrean mapatu duzuna eta errenkadan balio bat duena bakarrik erabiltzen du.
11.3 Ohiko elkarrizketa-fluxua
- Bisitaria: Zerrendari buruzko galdera (entitate anitz).
- Laguntzailea: bineta laburrak; xehetasun gehiago aukeratzera edo eskatzera gonbidatuz amaitzen da.
- Bisitaria: “[izena]-ren telefono zenbakia” / “lehen kontaktua”.
- Laguntzailea: txartelaren datuak (eranskina edo pasaportea).
- Bisitaria: “eta argazki batzuk.”
- Laguntzailea: Irudia rola mapatuta badago eta balio bat badu bakarrik bistaratzen du irudia.
Sistemak zerrenda gogoratzen du mezu bakoitzean bidalitako txat-historiaren arabera.
11.4 Zerrenda vs. txartel modua (Core ≥ 1.0.165)
| Modua | Noiz | Zer gertatzen da? |
|---|---|---|
| Zerrenda | Entitate anitzak / katalogo irekiko galdera | Erantzun laburra luzapenaren telefono zenbakia/helbide elektronikoa sartu gabe . |
| Fitxategia | Kontaktua, irudia, “esadazu gehiago…”, “lehena / azkena” | Erabili formulario horren eranskin osoa. |
Portaera agnostikoa : bere mapaketaren araberakoa da soilik, ez bezero zehatz baten araberakoa.
11.5 Jolastokian zerbait gaizki ateratzen bada
Zerrenda baten ondoren, saiatu txat berean: “Lehenengoaren telefono zenbakia?” edo “Irudirik?”. Ondo erantzuten ez badu: Core ≥ 1.0.166 , Telefono / Irudi rolak mapaketan (§7.3) eta, urruneko SQL-arekin, berriro sinkronizatu .
Integratzaileentzako xehetasun teknikoak: DEVELOPMENT.md §11–12 .
11.6 Hub vs. tokiko katalogoa vs. urruneko SQL
| Helburua | Ekintza |
|---|---|
| Zerrendak eta kontaktua ( bertako edukia) | Nukleo eguneratua + mapaketa zuzena |
| Jarri harremanetan urruneko SQL / Hub-arekin | Maparen atributuak → Sinkronizatu (≥ 1.0.164) → Hub-era bidali, hala badagokio |
| Bilaketa adimendunarekin galdera irekiak | Sinkronizatu + Trebatu |
Memoria trebatu gabeko Hub batek ez du tokiko zerrenda blokeatzen ;
Bai, erantzun semantiko sakonak mugatzen ditu berriro sinkronizatu arte.
11.7 Berritasunak 1.0.162 – 1.0.168 (laburpena)
| Bertsioa | Aldaketa |
|---|---|
| 1.0.168 | Erantzun azkarragoak: errepikatutako galderen cachea, txatean testua bistaratzean itxaronaldi gutxiago. |
| 1.0.162 | Eduki motaren morroiak iturburua errespetatzen du (ez ditu CPT lokalak urruneko SQLarekin nahasten). |
| 1.0.163 | MEC/Woo: SQL ostalari bakoitzeko urruneko katalogoa; gehi prezioa, SKU eta lekuak. |
| 1.0.164 | Gehitu sinkronizatu ondoren urruneko fitxetara mapatutako atributuak. |
| 1.0.165–166 | Zerrenda laburrak; administrazio-alboko barra ez-itsaskorra; arau agnostikoak. |
12. “Elkarrizketa-erregistroa” fitxa
Aktibatuta dagoenean, azken historia hemen agertzen da: data, bisitariaren mezua eta laguntzailearen erantzuna.
Pribatutasuna (GDPR): Egiaztatu zure legezko ordezkariarekin datu pertsonalak dituzten elkarrizketak gorde ditzakezun eta zure herrialdean dagokion pribatutasun/cookie politikan jakinarazi behar duzun.
13. Prezioak, lizentziak eta paketeak
📢 Oharra tasei eta lizentziei buruz: Unean uneko eskaintzak ikusten dituzula ziurtatzeko, prezioen zerrenda eguneratua, token paketeak eta berritze baldintzak denbora errealean kudeatzen dira gure webgune ofizialean: https://xabia.ai/precio .
Praktikan, bertan aurkituko duzu:
- Oinarrizko lizentzia (lehenengo urtea eta berritzea), uneko eskaintzaren araberako doako tokenekin.
- Token paketeak (Starter, Business, Enterprise edo argitaratutako beste izendapen batzuk).
- Gehigarriak ( Avirato , Woo , MEC , etab.) eta sare federatu pertsonalizatuko proiektuak.
Kargak Xabia Agent → Wallet- en egiten dira. Gehigarriek funtzioak gehitzen dituzte , baina IArekin izandako elkarrizketek tokenak erabiltzen jarraitzen dute, gehigarri batek kontrakoa adierazten ez badu behintzat (eredurik gabeko erantzun arinak).
14. Diru-zorroa
Menua: Xabia Agent → Kartera .
13.1 Zer erakusten du pantaila honek?
- Zerbitzuak instalazio honekin lotutako tokenen uneko saldoa berresten duenean.
- Bezero edo lizentzia identifikatzaile bat, ordainketa-esteka batzuetan ere ikusiko duzuna. Ez da nahitaez AI Connection- en itsatsi duzun
xabia_…kate sekretuaren testu bera. Ziur egon behar baduzu, erabili pantaila nagusian dagoen “Ikusi gordetako lizentzia” aukera . - Azken asteotako kontsumoaren histograma, gastu-tasaren ideia bisual bat izateko.
- “Berritu urtea” mezua normalean iraungitze data hurbiltzen denean agertzen da (ohiko leihoa hogeita hamar egunekoa da).
13.2 Nola kargatu tokenak
- Egiaztatu AI Connection- en lizentzia luze zuzena duzula (posta elektronikoa edo aktiba daitekeen giltza zena, normalean
xabia_…formatuan). - Hasi saioa Wallet-en administratzaile gisa.
- Egin klik Kargatu aukeran zure publikoarentzat egokia den paketean (ikusi uneko prezioak eta tamainak xabia.ai/price helbidean).
- Osatu ordainketa irekitzen den ordainketa-pasabidean. Ondoren, sistemak beharrezko datuak bidaliko ditu erosketa gune honekin lotzeko .
Normalean minutu batzuk itxaron behar dituzu eta gero pantaila nagusian Eguneratu Saldoa sakatu bat etorri arte.
Beste ordenagailu batetik erosita: normalean ez dago arazorik, baldin eta dendak bere gunerako espero duen domeinu + lizentzia konbinazio bera bada.
Gune anitzeko edo proba-kopia (staging): arreta handia jarri Xabia instalatu duzun URLari : erosketa makina zehatz horrekin lotuta egon daiteke.
13.3 Lizentzia bakarrik berritu
Berritzeko botoiak lizentzia indarrean jarraitu beharko luke, ez berri bat sortu. Uneko prezioa beti agertzen da xabia.ai/precio helbidean. Denbora pixka bat itxaron eta ” Saldoa eguneratu ” sakatu ondoren data oraindik zaharkituta badago, ireki laguntza-txartel bat ordainketaren frogagiriarekin.
13.4 Saldo Baxuaren Oharra
Zure saldoa hamar milaka tokenen azpitik jaisten bada, mezu nabarmen bat ikusiko duzu zorroa egiaztatzeko gogoraraziz, kreditu nahikorik ez dagoelako publikoak etenaldiak jasan aurretik.
15. Gehigarrien pantaila
Ordainpeko gehigarrien sareta (Avirato, Central, MEC, Woo… instalazioaren arabera): egoera, pluginetarako estekak, eta, Hub harpidetzak erabiltzen dituztenentzat, gehigarriarentzako lizentzia-formulario espezifikoa (ez du gune nagusiko Xabia lizentzia ordezkatzen ). QR/totem adimendunak ez dira hemen agertzen: Core-an integratuta daude (Agente fitxa).
- Denda: ohiko esteka polar.sh/digixop-erako .
- Bezeroen ataria (harpidetza kudeatu): polar.sh/digixop/portal .
- Gehigarri baten lizentzia baliogabea bada edo harpidetza iraungitzear badago, abisua hemen agertzen da; Avirato bezalako gehigarrien txat publikoan, bisitariak kontaktu-mezu generikoak jasotzen ditu, ez lizentzia teknikoen erroreak.
Instalatzailearen ZIP fitxategia eta kontratua Xabiatik ohiko posta elektronikoz edo merkataritza-bidetik iristen jarraitzen dute.
16. Galdu ez dadin agindu praktikoa
- Hodeia vs. azpiegitura propioaren modua, lizentzia eta oreka (pantaila nagusia).
- Agente bat sortu — eman izena eta kopiatu txata egin nahi duzun kode laburrean.
- Aukeratu datu- iturri bat — mapatu arretaz; probatu staging ingurune batean, eskuragarri badago.
- Datuak sinkronizatu → alboko estatistikak begiratu → bilaketa adimenduna erabiltzen baduzu, entrenatu kontagailuak koherenteak izan arte.
- Nortasuna hobetu → probatu Playground → argitaratu orria kode laburrarekin → kontrolatu gastua Wallet-en.
17. Ohiko arazoak (zer egiaztatu laguntza-zerbitzura idatzi aurretik)
| Egoera | Lehen azterketa azkarra |
|---|---|
| Txatak lizentzia edo saldoa falta dela aipatzen du. | Wallet plus Eguneratu saldoa ; egiaztatu ez dituzula puntuak itsatsi benetako pasahitza egon beharko lukeen lekuan pasahitz faltsu bat bezala |
| Ordaindu dut, baina saldoa ez da igotzen | Itxaron minutu batzuk; Eguneratu saldoa ; Mesedez, baieztatu espero zen gunetik (domeinu bera) erosi duzula. |
| Google Cloud-ek errore bat dio entrenamenduan zehar | JSON bidea, baimenak eta eskualdea zure Google panelarekin bat datoz |
| Modeloen arteko errore arraroak Cloud-ekin ere jarraitzen dute. | Batzuetan euskarria jotzen du, erdiko aldeak bere eremurako eredu espezifiko bat zuzentzen ari delako. |
| Avatar hiztuna ez da pantaila osoan irekitzen | Itxura → Hizketan ari den avatarra |
| Erantzunak letra lodirik/zerrendarik gabe | Eguneratu nukleoa |
| Irudi hautsia edo ez da txatean kargatzen | Mapak + Core bertsioa |
| Amelia erreserba orria ez da irekitzen | Itxura / Amelia |
| Urruneko MECak tokiko erreserba botoia erakusten du | MEC + Core gehigarria |
| CSV formatuan igotakoa ezin da aurkitu | Fitxategia igo ondoren Sinkronizatu exekutatu al duzu? Bilaketa adimenduna erabiltzen ari bazara, Trebatu botoian klik egin al duzu? Testuinguruaren eta antzekotasunaren konfiantza ezarpenak jaitsi: altuegiak badira, laguntzaileak testu erlazionatua “ez ikustea” eragiten dute, baina ez berdina. |
| Enpresa-zerrenda motela edo osatugabea | Core ≥ 1.0.118 ; egiaztatu ENTITY mapaketa eta taxonomia; probatu bertako zerrenda (§11) Hub-a arazketatu aurretik |
| “Azkenak” ez du kontakturik itzultzen | Zerrendatu ondoren, galdetu txat berean; Telefono / Posta elektroniko / Web rolak mapaketan; bertsioa ≥ 1.0.125 |
| Nahasketa nahasia iturri anitzekin | Berrikusi bigarren mapaketa-blokea lehenengoa bezain arretaz. |
| WPML: Agurrak edo leku-markatzaileak ez du hizkuntza aldatzen | Core ≥ 1.0.72 , cache hutsa, itzulpen osoekin kateen itzulpena (§10.12) |
| WPML: bandera-kate okerrak | Kateen jatorrizko hizkuntza = gaztelania; Utilitateak → xabia-intelligence |
18. Maiz egiten diren galderak
Enpresak berehala zerrendatzeko sinkronizatu behar al dut?
Ez da jatorrizko zerrendetarako eta kontaktu/irudi jarraipenerako (Core ≥ 1.0.118): Core kontsultak WordPress-en zuzenean egiten dira bere mapaketaren arabera. Bai, katalogoko galdera irekietarako RAG bektorial bat nahi baduzu.
Zenbat agente sor ditzaket lizentzia bakarrarekin?
Txikizkako ohiko erabileran, domeinu bereko agente bat edo gehiago sartzen dira agente bakoitzeko kostu gehigarririk gabe. Berretsi beti muga zehatzak ongietorri mezu elektronikoan , prezioen orrialde ofizialean edo zure salmenta-ordezkariarekin proiektu handia bada.
Zer da zehazki “token” bat?
Elkarrizketa batek zenbat hizkuntza-prozesamendu dakarren neurtzeko erabiltzen den unitatea da ( sarrerako testua gehi irteerako testua eredua erabiltzean). Memoria adimenduna entrenatzeak tokenak ere kontsumitzen ditu. Erantzuna txantiloi finko batetik datorrenean (eredurik gabe), askotan ez du bat ere erabiltzen .
Nire OpenAI gakoa itsatsi behar al dut Xabia Cloud erabiltzen badut?
Oro har, ez . Hodeiko zerbitzuekin eta saldoa duen lizentzia batekin, ohiko trafikoa Xabiatik igarotzen da. OpenAI gakoa batez ere tokiko azpiegituretan sartzen da jokoan.
Zergatik ez ditu nire taulak edo PDFak “gogoratzen” zerbitzarian baditut?
Ezagutza hau Sinkronizatu erabiliz txertatu behar duzu (eta Antzekotasun bilaketa gaituta baduzu, Entrenatu ). Zuzeneko datuak ematen dituzten gehigarriak (erreserbak, etab.) kanal bereizi bat dira eta ez dute urrats hau ordezkatzen laguntzaileak zure dokumentazioa aipatzea nahi baduzu.
Ekoizpen-kopiaren lizentzia berarekin proba- kopia staging erabil al dezaket?
Kontratu-baldintzen araberakoa da: bi helbide publiko desberdin batzuetan bi instalaziotzat hartzen dira.
Benetako trafikoa mugitu aurretik galdetu.
Lizentzia ezabatzen badut, nire agenteak ezabatuko al dira?
Ez dira zerrendatik desagertzen, ezta haien konfigurazioa automatikoki ezabatzen ere, baina txatak behar bezala funtzionatzeari utziko dio hodeian beste lizentzia baliozko bat itsatsi arte.
Ba al dago saldorik zorroan, baina bisitariak “mantentze-modua” ikusten du?
Begiratu agente bakoitzaren eguneroko token muga Nortasuna atalean. Tokenen Gaurko alboko barrak erakusten du uneko egun teknikorako muga horretara iritsi zaren ala ez; hurrengo egunean, kontagailu hori zero bihurtzen da agentearentzat, nahiz eta zure zorro globalak beste agente edo beste egun batzuetarako saldoa izan oraindik.
Argitalpen Oharrak (Oinarria)
Core v1.0.202 (2026ko abuztua)
- Txat ekintzak:
[ACTION:IMG:…]-ko irudi erlatiboak; Amelia babeskopia ordezkoa; urruneko MEC arau zorrotzak ([ACTION:URL:Link]bakarrik). - Ekoizpenarekin lerrokatuta dagoen monorepo: API osoa eta Woo/MEC/Avirato gehigarriak.
Core v1.0.201 (2026ko abuztua)
- Txata: Oinarrizko Markdown erantzunetan; burbuilarik gabeko UI jarioa; hiztun avatarra/abiarazlea; abiarazteko galderak; ZIP pakete osoa.
Nukleoa v1.0.168–1.0.171
- Txataren latentzia, Dokumentutik RAGera, urruneko pasaportea, zerrendak, WPML/DTP (ikus historia teknikoa DEVELOPMENT.md-n).
Xabia AI — Web Bizidunaren
Adimen artifizialarekin batera jakinduria naturala
Xabia AI bereziki egokia da turismo sektoreko enpresa eta elkarteentzat, erakundeentzat, negozioentzat eta beren bihurketa-tasa handitu nahi duten online dendentzat.
Xabia AI Digixopek garatu du.
Xabia AI · Garaizar, 2 · 48004 Bilbao (ESPAÑA)