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

  1. Deskargatu Xabia Agent Core ZIP fitxategia ( xabia-agent-core-1.0.202.zip edo baliokidea den txikizkako paketea).
  2. WordPress-en, joan Pluginak → Gehitu Berria → Kargatu Plugin atalera , hautatu ZIP fitxategia eta egin klik Instalatu Orain → Aktibatu aukeran .
  3. Ireki Xabia Agent eta konfiguratu AI Connection : itsatsi XABIA--… , aukeratu Xabia Cloud (gomendatua) edo Own Infrastructure , eta gorde.
  4. Sortu agente bat Agente Berria aukeratik, idatzi izena, agurra eta oinarrizko argibideak.
  5. Aukeratu datu-iturri bat (CSV, SQL, gehigarria edo iturri anitzekoa), egin klik Konektatu / Mapatu aukeran dagokionean eta gorde agentea.
  6. Egin klik Sinkronizatu datuak aukeran eta, bektoreen bilaketa erabiltzen baduzu, Entrenatu AI aukeran .
  7. Argitaratu agentea kode laburrarekin edo aktibatu interfaze natiboa Itxura → Erakutsi gunean kode laburrik gabe ataletik .
  8. 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 → SinkronizatuTrebatu
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 QRSmart 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.

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

2.2 Dauden agente txartelak

Txartel bakoitzak erakusten du:

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 .

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)

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

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

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)

Google Cloud (Vertex AI) — zerbitzu-kontuaren JSON fitxategirako bidea

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

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:

  1. Orokorra — oinarrizko datuak, IA motorra zure azpiegitura erabiltzen baduzu bakarrik, iturriak (CSV/SQL…) eta nola etiketatu zutabeak bot-erako.
  2. QR / Totem Adimendunak (Muina) — lurreratze orria, tunel URLak, entitate bakoitzeko QR sorgailua, kiosko modua. QR Adimendunen eskuliburu zehatza .
  3. Nortasuna — koloreak, ahotsaren irakurketa, zenbat testuinguru erabili, erantzun mugak eta laguntzailearen “gidoia” orokorra.
  4. 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

5.2 Kode laburra

Agente bat gorde ondoren, honako hau bistaratzen da:

 WordPress orrialde batean itsatsiz 

Argitaratu agente horren txata (agentea Pausatua ez badago).

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):

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

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).

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:

  1. Zerrendatu iturri aktiboaren eduki motak (ez WordPress txatarenak iturria desberdina bada).
  2. Iradoki zein eremu diren interesgarriak bot-arentzat (izenburua, testua, metadatuak, taxonomiak…).
  3. 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:

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

  1. Sinkronizatu ezagutza gutxienez IDENTITATEA (ENTITATEA) gisa markatutako zutabe batekin (§7.3).
  2. Argitaratu orrialde bat helbidearekin eta hautatu Landing Page gisa Agente Editatu → Smart QR / Totems atalean.
  3. 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-impresionismo

Smart 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)

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

10.3 Ahotsa (arakatzailearen irakurgailua)

Bisitariak ozen irakurtzeko aukera erabil dezake bere nabigatzaileak baimentzen badu.

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).

10.8 Bilaketa adimenduna (“bektore”) eta sentikortasuna

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:

  1. Idatzi zure hasierako agurra gaztelaniaz Nortasuna fitxan eta gorde agentea .
  2. Xabiak zure hizkuntza aktiboak detektatuko ditu eta (zure Cloud lizentziari esker) automatikoki itzuliko du agurra atzeko planoan.
  3. 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 itzulpenaKateen 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)

  1. Zure katalogoarekin koherentea den datu-iturria (CSV, tokiko/urruneko SQL, iturri anitzekoa, gehigarria…).
  2. Gutxienez IDENTITY (ENTITY) eremu bat eta kontaktu/irudi rolak dituzten zutabeen mapaketa (§7.3).
  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

  1. Bisitaria: Zerrendari buruzko galdera (entitate anitz).
  2. Laguntzailea: bineta laburrak; xehetasun gehiago aukeratzera edo eskatzera gonbidatuz amaitzen da.
  3. Bisitaria: “[izena]-ren telefono zenbakia” / “lehen kontaktua”.
  4. Laguntzailea: txartelaren datuak (eranskina edo pasaportea).
  5. Bisitaria: “eta argazki batzuk.”
  6. 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:

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?

13.2 Nola kargatu tokenak

  1. Egiaztatu AI Connection- en lizentzia luze zuzena duzula (posta elektronikoa edo aktiba daitekeen giltza zena, normalean xabia_… formatuan).
  2. Hasi saioa Wallet-en administratzaile gisa.
  3. Egin klik Kargatu aukeran zure publikoarentzat egokia den paketean (ikusi uneko prezioak eta tamainak xabia.ai/price helbidean).
  4. 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).

Instalatzailearen ZIP fitxategia eta kontratua Xabiatik ohiko posta elektronikoz edo merkataritza-bidetik iristen jarraitzen dute.


16. Galdu ez dadin agindu praktikoa

  1. Hodeia vs. azpiegitura propioaren modua, lizentzia eta oreka (pantaila nagusia).
  2. Agente bat sortu — eman izena eta kopiatu txata egin nahi duzun kode laburrean.
  3. Aukeratu datu- iturri bat — mapatu arretaz; probatu staging ingurune batean, eskuragarri badago.
  4. Datuak sinkronizatu → alboko estatistikak begiratu → bilaketa adimenduna erabiltzen baduzu, entrenatu kontagailuak koherenteak izan arte.
  5. 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)

Core v1.0.201 (2026ko abuztua)

Nukleoa v1.0.168–1.0.171

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)

laguntza@xabia.ai

No te pierdas nada!!!

Usa nuestro programa inteligente de Aste Nagusia 2026 y pregunta lo que quieras a Marija-ia