{"id":2224,"date":"2026-08-11T09:57:17","date_gmt":"2026-08-11T07:57:17","guid":{"rendered":"https:\/\/xabia.ai\/xabia-agent-core\/"},"modified":"2026-08-25T19:46:48","modified_gmt":"2026-08-25T17:46:48","slug":"xabia-agent-core","status":"publish","type":"page","link":"https:\/\/xabia.ai\/en\/documentation\/xabia-agent-core\/","title":{"rendered":"Xabia Agent Core"},"content":{"rendered":"

User manual \u2014 Xabia Agent Core<\/h1>\n
\n

Product version:<\/strong> Xabia Agent Core v1.0.209<\/strong> (August 2026)
Index of manuals:<\/strong> https:\/\/xabia.ai\/docs\/<\/a>
Online PDF:<\/strong> https:\/\/xabia.ai\/docs\/manual-usuario-xabia-core.pdf<\/a>
Online HTML:<\/strong> https:\/\/xabia.ai\/docs\/manual-usuario-xabia-core.html<\/a><\/p>\n<\/blockquote>\n

Quick Installation Guide<\/h2>\n
    \n
  1. Download the Xabia Agent Core<\/strong> ZIP file ( xabia-agent-core-1.0.209.zip<\/code> or equivalent retail package).<\/li>\n
  2. In WordPress, go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong> , select the ZIP file and click Install Now \u2192 Activate<\/strong> .<\/li>\n
  3. Open Xabia Agent<\/strong> and configure AI Connection<\/strong> : paste the XABIA--\u2026<\/code> , choose Xabia Cloud<\/strong> (recommended) or Own Infrastructure<\/strong> , and save.<\/li>\n
  4. Create an agent from New Agent<\/strong> , enter name, greeting and basic instructions.<\/li>\n
  5. Choose a data source<\/strong> (CSV, SQL, addon or multi-source), click Connect \/ Map<\/strong> when appropriate and save the agent.<\/li>\n
  6. Click Sync Data<\/strong> and, if using vector search, Train AI<\/strong> .<\/li>\n
  7. Publish the agent with the shortcode <\/code> or activate the native interface from Appearance \u2192 Show on site without shortcode<\/strong> .<\/li>\n
  8. Test it in Playground<\/strong> and on a real page before opening it to the public.<\/li>\n<\/ol>\n

    Upgrading from a previous version:<\/strong> Upload the new ZIP file from Plugins<\/strong> , replace the installed version, and keep the existing settings. If you are using \/xabia-box\/<\/code> , go to Settings \u2192 Permalinks \u2192 Save<\/strong> after upgrade. After installing 1.0.72+<\/strong> with WPML, visit a front-end page to synchronize the chat UI translations; clear the cache (LiteSpeed, etc.). With a remote SQL<\/strong> source, after upgrading to 1.0.164+<\/strong> , re -sync<\/strong> (and submit to the Hub if applicable) to regenerate the tabs with the mapped attributes appended<\/strong> .<\/p>\n

    \n

    Quick guide: what to do in each situation<\/h2>\n

    Use this table as a roadmap<\/strong> .<\/p>\n

    Each row indicates the exact screen and the order of steps.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
    Wanna\u2026<\/th>\n Where am I going?<\/th>\n What do I do (in order)<\/th>\n<\/tr>\n<\/thead>\n
    Installing Xabia for the first time<\/strong><\/td>\n Plugins \u2192 Upload plugin<\/td>\n ZIP Core \u2192 Activate \u2192 AI Connection<\/strong> (License + Cloud) \u2192 New Agent<\/strong> \u2192 Data Source \u2192 Sync<\/strong> \u2192 Shortcode or Native Mode<\/td>\n<\/tr>\n
    Update to a new version<\/strong><\/td>\n Plugins \u2192 Upload plugin<\/td>\n Upload ZIP (replaces) \u2192 Permalinks \u2192 Save<\/strong> \u2192 Clear site cache \u2192 Try incognito chat<\/td>\n<\/tr>\n
    Publish the chat on a specific page<\/strong><\/td>\n Edit agent \u2192 General<\/td>\n Copy shortcode \u2192 paste on the page \u2192 disable<\/strong> “Display on site without shortcode” if you don’t want a floating avatar<\/td>\n<\/tr>\n
    Floating avatar throughout the site<\/strong><\/td>\n Edit agent \u2192 Appearance<\/td>\n Activate<\/strong> “Display on site without shortcode” \u2192 choose included\/excluded pages \u2192 Save agent<\/strong><\/td>\n<\/tr>\n
    Hide the chat without deleting it<\/strong><\/td>\n List of agents<\/td>\n Pause<\/strong> (return with Activate<\/strong> )<\/td>\n<\/tr>\n
    Multilingual with WPML (ES + EU + EN\u2026)<\/strong><\/td>\n See \u00a710.12<\/td>\n Greeting in Spanish \u2192 save agent \u2192 check WPML String Translation \u2192 clear cache<\/td>\n<\/tr>\n
    Different greetings depending on the language (automatic)<\/strong><\/td>\n Personality + active Core license<\/td>\n Write greeting in base language \u2192 Save agent<\/strong> (Core calls Hub if WPML is present; DTP included in Core)<\/td>\n<\/tr>\n
    Different greetings depending on the language (manual)<\/strong><\/td>\n WPML \u2192 String Translation<\/td>\n Context Xabia AI<\/strong> \u2192 Agent Greeting - su-agente<\/code> \u2192 translate by hand<\/td>\n<\/tr>\n
    Placeholder \u00abWrite here\u2026\u00bb translated<\/strong><\/td>\n Core \u2265 1.0.72 + WPML<\/td>\n Install 1.0.72 \u2192 visit the front end once \u2192 check the xabia-intelligence<\/code> domain in String Translation<\/td>\n<\/tr>\n
    Connect CSV or Excel<\/strong><\/td>\n General \u2192 CSV Files<\/td>\n Upload CSV \u2192 Explore\/Scan<\/strong> \u2192 Map Columns \u2192 Synchronize<\/strong> \u2192 Train<\/strong><\/td>\n<\/tr>\n
    Connect to remote database<\/strong><\/td>\n General \u2192 Remote SQL<\/td>\n Host, database, user, password, query \u2192 Test query<\/strong> \u2192 Map \u2192 Synchronize<\/strong><\/td>\n<\/tr>\n
    QR code per point of interest<\/strong><\/td>\n Smart QR \/ Totems<\/td>\n Synchronize with ENTE<\/strong> column \u2192 landing page \u2192 Generate QR<\/strong> \u2192 Smart QR manual<\/a><\/td>\n<\/tr>\n
    Kiosk\/Totem Mode<\/strong><\/td>\n Smart QR \/ Totems<\/td>\n Activate Totem Mode<\/strong> + inactivity minutes, or URL \/xabia-box\/?x_project=\u2026<\/code><\/td>\n<\/tr>\n
    Top up tokens<\/strong><\/td>\n Wallet<\/td>\n Check license in Connection \u2192 Top up<\/strong> pack \u2192 wait a few minutes \u2192 Update balance<\/strong><\/td>\n<\/tr>\n
    Renew annual license<\/strong><\/td>\n Wallet<\/td>\n Renew year<\/strong> (same license, do not create another one)<\/td>\n<\/tr>\n
    The chat is not responding<\/strong><\/td>\n Connection + Wallet<\/td>\n Valid license, balance > 0, agent not paused<\/strong> , cache emptied<\/td>\n<\/tr>\n
    AI doesn’t “see” my data<\/strong><\/td>\n Agent sidebar<\/td>\n Synchronize<\/strong> after CSV\/SQL change? Train<\/strong> if there’s a vector? Lower confidence threshold?<\/td>\n<\/tr>\n
    Instant massive listing of records<\/strong><\/td>\n Playground \/ Public Chat<\/td>\n Core \u2265 1.0.118<\/strong> : mapping with ENTITY<\/strong> + activity taxonomy \u2192 listing questions without depending on the Hub (\u00a711)<\/td>\n<\/tr>\n
    Contact or image of “the last” in the list<\/strong><\/td>\n Same chat, next turn<\/td>\n After listing: \u00abcontact of the last one?\u00bb \/ \u00abany image?\u00bb \u2014 roles Telephone<\/strong> , Image<\/strong> , Logo<\/strong> in mapping (\u00a77.3, \u00a711).<\/p>\n

    With remote SQL: Synchronize<\/strong> after 1.0.164+ (\u00a711.6)<\/td>\n<\/tr>\n

    CPT Assistant with Remote SQL<\/strong><\/td>\n General \u2192 CPT Assistant<\/td>\n Core \u2265 1.0.162<\/strong> : lists only active source types (remote \/ local \/ multi \/ addon); does not mix WordPress chat CPTs (\u00a77.2)<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
    \n

    1. Menu structure in WordPress<\/h2>\n

    After activating Xabia Agent Core<\/strong> , the Xabia Agent<\/strong> menu appears on the desktop with a “superhero” icon.<\/p>\n\n\n\n\n\n\n\n
    Menu entry<\/th>\n What it shows<\/th>\n<\/tr>\n<\/thead>\n
    Xabia Agent<\/strong><\/td>\n Main screen: agent list, addon showcase, and global block AI Connection<\/strong> (license + Cloud mode \/ own infrastructure).<\/td>\n<\/tr>\n
    Addons<\/strong><\/td>\n Payment add-on cards (Avirato, MEC, Woo, Central\u2026), license key<\/strong> when applicable (Hub validation), Polar store<\/strong> and customer portal<\/strong> , renewal notifications if the subscription is about to expire, and links to Plugins<\/strong> . Smart QR is not an add-on:<\/strong> it is included in the Core ( Smart QR \/ Totems<\/strong> tab when editing an agent).<\/td>\n<\/tr>\n
    Wallet<\/strong><\/td>\n Token balance, 30-day consumption, recharge packs and renewal when applicable.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

    Options depending on what your site has installed.<\/strong><\/p>\n