AI Hub (EnvIA Configuration)

Configure the EnvIA support agent for each country: define business hours, manage holidays, upload operational documents, and test the agent live from the browser.

What You Can Do

• Set the hours and days the agent is available per country
• Add, edit, and export public holiday calendars
• Upload documents and images the agent will use when answering questions
• Preview and delete uploaded documents
• Download a Markdown template for writing operational documents
• Test the agent's live responses in a built-in sandbox

Getting There

Click AI → AI Hub in the sidebar. You need the menu-ai-hub-config permission to see this entry.

The active country is set by the country selector in the top bar. All panels on this page reflect and save settings for that country.

Common Tasks

Setting Business Hours

1. Scroll to Horarios de atención.
2. Enter start and end hours (0–23, 24-hour format) for Lun-Vie (weekdays) and Sab-Dom (weekends).
3. To mark a day as closed, set start equal to end (e.g., both 0). A Cerrado badge appears.
4. Click Guardar cambios.

TIP

If the server is temporarily unavailable, your changes are saved locally in the browser and a badge reads cambios guardados aquí. They will be ready to re-submit once connectivity is restored.

Managing Holidays

1. Scroll to Fechas festivas.
2. Click Agregar to add a holiday row.
3. Enter the date in MM-DD format (e.g., 12-25 for Christmas) and a descriptive name.
4. Repeat for each holiday.
5. Click Guardar cambios when done.

To export the current holidays:

Click Exportar JSON to download config-{country}.json with the current business hours and holidays.

Uploading Documents

Documents give the agent knowledge about your operations: shipping rules, carrier contacts, FAQs, etc.

1. Scroll to Documentos que conoce EnvIA.
2. Drag a file onto the dropzone, or click it to choose one.
3. Accepted formats: Markdown (.md), text (.txt), PDF, and images (.png/.jpg/.jpeg/.webp). Maximum size: 30 MB.
4. The document appears with a En cola badge, then Procesando, and finally Listo once the agent has indexed it.

How each format is processed

• Markdown with ## and ### headings gives the agent the clearest structure to find specific information. Click Plantilla .md to download a ready-to-fill template.
• PDFs and images are read automatically with OCR / vision, so scanned documents and screenshots work too — just make sure the text is legible.

Files larger than 30 MB or in an unsupported format are rejected before upload, with an inline message explaining why.

Previewing a Document

1. Find the document in the list.
2. Click Abrir.
3. PDFs, images, and text/Markdown open inline in a side panel via a secure, time-limited link (valid for 1 hour).

Deleting a Document

1. Find the document in the list.
2. Click the trash icon on the right of the row.
3. Confirm the deletion in the dialog.

The document and all its indexed content are permanently removed. This action cannot be undone.

Version history

The bar at the bottom of the page shows the version you are looking at in the editor (number, date, status, and parent version when it has one). On first load that is the live version.

1. Click Historial. A side panel opens from the right.
2. Each version always shows one status badge from its record:
   • Publicado — published (status: published)
   • Borrador — current draft row (status: draft)
   • Archivado — previous versions (status: archived) The version open in the editor keeps the info highlight, but that is not a fourth badge.
3. Each row can show Basado en {version} — the version it was created from. The number is rendered next to the i18n label, not inside the translation string.
4. If the version has a change note, it appears on its own line in the history card.
5. Click Abrir to load that snapshot in the editor. Live does not change.
6. Click Desde esta to create a new draft copied from that version (replaces the current draft).
7. Click the rollback action on an archived version to replace the published config (you will be asked to confirm).

Testing the Agent (Sandbox)

The sandbox in the right column lets you chat with EnvIA using the active country's current configuration.

1. Make sure a country is selected in the top bar.
2. Type a message in the input field and press Enter or the send button.
3. The agent's reply appears in the chat. The timestamp shows which agent responded and the model version.

Each sandbox session has its own conversation thread. Switching country or agent resets the thread.

INFO

Sandbox conversations use the http channel and are tagged with source: admon-sandbox in the traces so they are distinguishable from real user traffic.

Tips

• Changes apply to new conversations after the backend's country cache refreshes (TTL: 7 days). Existing ongoing conversations are not affected mid-thread.
• Holiday dates repeat every year. You do not need to update the list each year unless the date changes.
• Global documents (cross-country catalog) do not appear in this panel. They are managed separately.