Erabiltzailearen eskuliburua — QR adimendunak eta totemak (Xabia Agent Core)

Produktuaren bertsioa: Xabia Agent Core v1.0.59 (2026ko maiatza)
Core lizentzian sartuta — ez da aparteko plugin edo gehigarririk behar.
Sareko PDFa: https://xabia.ai/docs/manual-usuario-xabia-smart-qr.pdf
HTML lineakoa: https://xabia.ai/docs/manual-usuario-xabia-smart-qr.html
Oinarrizko Eskuliburua (testuinguru orokorra): xabia-core-user-manual.md

Gida azkarra (5 minutu)

1. Instalatu eta aktibatu Xabia Agent Core ( xabia-agent-core ) lizentzia baliodun batekin.
2. Sortu agente bat, sinkronizatu datuak gutxienez IDENTITY (ENTITY) gisa markatutako zutabe batekin (§4).
3. Argitaratu landing page bat agentearen kode laburrarekin, adibidez:
   
4. Editatu agentea → Smart QR / Totem fitxan , hautatu orrialde hori Landing Page gisa eta gorde.
5. Fitxa berean, egin klik nahi duzun entitatearen ondoan (gela, produktua, espazioa…) QR sortu aukeran .
6. Deskargatu PNGa, inprimatu edo partekatu. Eskaneatzen denean, bisitaria entitate horrekin lotutako txatera iristen da (tunel efektua).
7. Harreran tablet bat jartzeko, erabili /xabia-box/?x_project=ID_AGENTE bidea edo aktibatu Totem Modua (§8).

Garrantzitsua: Core eguneratzen baduzu edo /xabia-box/ erabiltzen baduzu, joan Ezarpenak → Esteka iraunkorrak → Gorde behin URL arauak birsortzeko.

1. Zer da Smart QR Xabian?

QR adimenduna mundu fisikoa (kartelak, etiketak, totemak, liburuxkak) Xabia txatarekin lotzen duen oinarrizko geruza da. Norbaitek kode bat eskaneatzen duenean edo tunel-esteka bat irekitzen duenean:

• Laguntzaileak badaki zein puntutatik iritsi diren (museoko gela, hoteleko gela, produktu zehatz bat…).
• RAG ezagutza entitatearen arabera iragaz daiteke ( ente_id ).
• Agurra eta tonua kokapen horretarako pertsonalizatuta daude.
• Elkarrizketak analisietan Smart QR iturri / tunel gisa etiketatu daitezke (analisi nagusiak fitxa gaituta baduzu).

Hori guztia Xabia Agent Core-n sartuta dago 1.0.59 bertsiotik aurrera. “Xabia Smart QR” plugin zaharra zaharkituta dago; oraindik instalatuta baduzu, desaktibatu eta kendu ezazu.

1.1 Erabilera kasu tipikoak

1.2 Zer ez den Smart QR

• Ez du datuen sinkronizazioa ordezkatzen: entitate identifikatuekin indexatutako ezagutza izan behar du (CSV, SQL, CPT…).
• Ez da URL arbitrarioetarako QR kode sortzaile generiko bat: entitate testuinguruarekin zure Xabia agenterako tuneletarako pentsatuta dago.
• Ez da Polar gehigarrien lizentzia bereizirik behar: Core- ren parte da.

2.

Kontzeptu nagusiak

2.1 Entitatea ( ente_id )

Entitatea ezagutza segmentatzeko unitate logikoa da: gela bat, produktu bat, enpresa bat, logela bat…

• Agentearen zutabe-mapeatzean , markatu IDENTITY (ENTITY) errenkada bakoitza (slug, kodea, barne IDa) modu egonkorrean identifikatzen duen eremuan.
• Datuak sinkronizatu ondoren, errenkada bakoitza ente_id batekin lotzen da (adibidez, sala-impresionismo , okana , producto-442 ).
• Balio berezi global “entitate espezifikorik gabe” esan nahi du; ez da egokia tunel QR kodeak sortzeko.

2.2 Tunel efektua

Bisitaria entitate aktibo batekin iristen denean (URL ?ente_id= edo POI eskaneatzea ?xqr= ), Core-k barne-testuinguru mota hau txertatzen du modeloaren gonbitan:

Erabiltzailea “Impresionismoaren Gela” atalera iritsi da Smart QR tunel baten bidez. Agurtu zehazki…

Bisitariak ez du testu hori ikusten ; agurra eta erantzun zehatzagoak baino ez ditu nabaritzen.

2.3 Helmuga-orria

Agentearen kode laburra duen WordPress orrialde argitaratu bat da. Sortutako QR kodeek honako hau adierazten dute:

 Helmuga-orririk konfiguratzen ez baduzu, sistemak bide generikoa erabil dezake. https://su-dominio.com/pagina-del-chat/?ente_id=sala-impresionismo

/xabia-box/?x_project=ID_AGENTE&ente_id=… .

2.4 Interesguneak (POI) eta URLak ?xqr=

Entitate bakoitzeko tunelatzeaz gain, Core-k URLan POI identifikatzaileak onartzen ditu:

 (edo ezizena) https://su-dominio.com/?xqr=sala-3&x_project=mi-museo

?xid= ). Honek eskaneatze saio bat, agur automatikoa aktibatzen ditu, eta, POIak ente_slug badu, txata entitate horretara ainguratzen du.

POI datuak hemendik etor daitezke:

• Barne erregistroa ( xabia_qr_poi_registry ),
• xabia_qr_poi taula,
• Edo agentearen RAG ezagutzaren ilarak.

2.5 Ibilbidea /xabia-box/

Totemetarako diseinatutako pantaila osoko esperientzia: botoi flotatzailerik ez, txatak pantaila hartzen du.

 3. Non dago kokatuta WordPress-eko kontrol-panelean? https://su-dominio.com/xabia-box/?x_project=mi-museo&ente_id=recepcion

Ez da agertzen Xabia Agent → Addons-en ordainpeko produktu gisa: funtzionalitate nagusia da.

4. Prestatu datuak entitateekin

4.1 CSV adibidea (museoa)

salas.csv fitxategia:

 codigo_sala;nombre_sala;texto_guia;piso sala-impresionismo;Impresionismo;Obras de Monet, Renoir y Degas entre 1860 y 1880.;1 sala-barroco;Barroco;Escultura y pintura europea del siglo XVII.;2 Agentearen baitan: codigo_sala;nombre_sala;texto_guia;piso sala-impresionismo;Impresionismo;Obras de Monet, Renoir y Degas entre 1860 y 1880.;1 sala-barroco;Barroco;Escultura y pintura europea del siglo XVII.;2

1. Igo CSV fitxategia eta Konektatu/Mapatu .
2. Markatu codigo_sala IDENTITATE (ENTITATE) gisa.
3. Etiketa ezazu nombre_sala izenburu gisa eta texto_guia testu nagusi gisa.
4. Datuak sinkronizatu → Entrenatu (bektore bilaketa erabiltzen bada).

Sinkronizatu ondoren, Smart QR / Totems -en sala-impresionismo eta sala-barroco entitateak ikusiko dituzu.

4.2 SQL / WordPress entitatearekin

WordPress Eduki Laguntzailea erabiltzen ari bazara, markatu erregistro bakoitza (argitalpenaren IDa, slug-a, SKU-a, etab.) identifikatzen duen eremua Entitate gisa. Emaitza den slug-a agentearen memorian ente_id izango da.

5.

Konfiguratu “QR / Totem Adimendunak” fitxa

Ireki Xabia Agente → Editatu agentea → Smart QR / Totemak .

5.1 Helmuga orria

1. Sortu orrialde bat WordPress-en, adibidez “Museoaren laguntzailea” .

2. Txertatu kode laburra:

    Argitaratu 

3. orrialdea.

4. Helmuga Orriaren goitibeherako zerrendan, hautatu eta sakatu Gorde Agente aukera .

5.2 Totem modua (kioskoa)

Minutuak kode laburrean ere behartu ditzakezu:

 Kode laburraren balioa 

agentearen akatsaren gainetik nagusitzen da .

5.3 Entitate eta Sortzaile Taula

Agentearekin eta entitateekin memorian, fitxak hau erakusten du:

QR sortu aukeran klik egitean, leiho modal bat irekiko da honekin:

• Kodearen aurrebista

• Deskargatu PNG / Deskargatu SVG

• Kopiatu esteka , Kopiatu kode laburra , Kopiatu irudia

• Kode labur iradokia:

   6. Lotura motak (erreferentzia) 

6.1 Tunela entitate bakoitzeko (inprimatutako QR kodearentzat gomendatua)

 Panelak automatikoki sortua. PNGa sorgailutik kodetzen duena da. https://ejemplo.com/asistente-museo/?ente_id=sala-impresionismo

6.2 Txertatutako kode laburra entitate finkoarekin

Gela bakar bati eskainitako landing page batean erabilgarria (URL-an ?ente_id= -ren menpe egon gabe):

 6.3 Interes fisikoa ( 

?xqr= )

 Bisitariak testuinguru-agurra jasotzen du POItik. Konfiguratu POIa erregistro/taula batean edo utzi Core-ri RAG ezagutzatik datuak ondorioztatzen. https://ejemplo.com/?xqr=placa-entrada&x_project=mi-museo

6.4 Pantaila osoko totema

 Aurrez hautatutako entitatearekin: https://ejemplo.com/xabia-box/?x_project=mi-museo

 Totemaren arakatzailean, ireki URL hori hemen: https://ejemplo.com/xabia-box/?x_project=mi-museo&ente_id=recepcion

kiosko modua (pantaila osoko sistema eragilea).

7.

Sektoreka adibide osoak

7.1 Museoa, gela bakoitzeko orrialde nagusiarekin eta QR kodeekin

Helburua: QR kode desberdin batekin kartela gela bakoitzean.

1. mi-museo agentea, gelen CSV (§4.1).
2. Orrialdea /asistente/ rekin.
3. Smart QR / Totem-etan konfiguratutako landing page-a.
4. Sortu QR kodea sala-impresionismo → inprimatu PNG.
5. Bisitariak eskaneatzen du → txata irekia → testuinguruko agurra → gela horretako testu-erantzunak.

Inprimatu gabe probatu: ireki tunelaren URLa zure gailu mugikorrean edo erabili Playground ente_id berdinarekin.

7.2 Landa Hotela (Astei estilokoa)

Helburua: Etxe bakoitzean QR kode bat informazioarekin eta erreserba egiteko estekarekin.

1. Sinkronizatu ostatuak entity = house slug-ekin ( okana , etxola , …).
2. Agente nagusiarekin lurreratzea.
3. QR kodea entitate bakoitzeko; tunelak testuingurua etxe horretan zentratzen du.
4. Xabia Avirato baduzu, erabilgarritasun galderak entitatearen testuinguruarekin konbina daitezke (ikusi Avirato eskuliburua).

7.3 Gorde QR kodea apalean edukita

1. ENTITY gisa SKU zutabea duten produktuen CSV fitxategia.
2. QR kodeak ?ente_id=sku-12345 helbidera seinalatzen du.
3. Nortasun Argibideak: “Bisitaria produktu baten QR kode baten bidez iristen bada, lehentasuna eman testuinguruan SKU horren fitxa teknikoari, stockari eta prezioari.”

7.4 Udal harrera (totema)

1. atencion-ciudadana agentea.
2. Aktibatu Totem Modua 8 minutuko inaktibitatearekin.
3. Tableta /xabia-box/?x_project=atencion-ciudadana .
4. Ez dago QR kode inprimaturik: mostradoreko esperientzia finkoa.

8. Txat-portaera (bisitaria)

1. Hasiera: agentearen hasierako agurra edo POI agurra ?xqr= bidez etorri bada.
2. RAG testuingurua: Garunak ente_id aktiboaren zatiak lehenesten ditu (modu zorrotza).
3. Lehen pertsona: tunel/QR moduan, modeloak normalean lekuaren gida gisa erantzuten du (“Gela honetan aurkituko duzu…”).
4. Hizkuntza: bisitariaren azken mezuko hizkuntzan erantzuten du (oinarrizko hizkuntza poliglota); QR kodeak ez du hizkuntza zehazten.
5. Totem: jarduerarik gabe egon ondoren, hasierako egoerara itzultzen da (erabilgarria pantaila partekatuetan).

9. Trafikoaren analisia eta jatorria

Core Analytics fitxa erabiltzen baduzu, elkarrizketak sailkatu daitezke:

• Web — ohiko txata webean.
• QR kode aktiboarekin iristea / tunel adimenduna .

Web widgetarekin alderatuta seinale fisikoek zenbat erabilera sortzen duten neurtzeko balio du.

10. Arazoak konpontzea

11.

Arkitektura modularra (erreferentzia tekniko arina)

Smart QR Core ZIP fitxategiaren barruko moduluetan banatzen da:

Ez instalatu Smart QR-rako gehigarririk. Avirato , MEC eta Woo gehigarriak independenteak eta aukerakoak dira.

12. “Xabia Smart QR” pluginetik migrazioa

Instalazio zaharretan xabia-smart-qr plugina bereizita bazenuen:

1. Eguneratu Xabia Agent Core v1.0.59 edo berriago batera.
2. Desaktibatu eta kendu xabia-smart-qr Pluginak atalean.
3. Begiratu Smart QR / Totemak zure agentean: funtzionalitatea dagoeneko hor dago.
4. /xabia-box/ erabiltzen baduzu, esteka iraunkorrak birsortu ditut.

Ez da beharrezkoa gehigarrien lizentzia migratzea: Smart QR-k ez du jada berezko Polar produkturik.