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 Markdown documents 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. Click Subir.
3. Select a Markdown (.md) file. Maximum size: 10 MB.
4. The document appears with a En cola badge, then Procesando, and finally Listo once the agent has indexed it.

Use Markdown for best results

Markdown files with ## and ### headings give the agent the clearest structure to find specific information. If you do not have a Markdown file, click Plantilla .md to download a ready-to-fill template.

Unsupported formats (CSV, XLSX, images, etc.) are rejected before upload.

Previewing a Document

1. Find the document in the list.
2. Click Abrir.
3. Markdown files open in a new browser tab via a secure, time-limited link (valid for 1 hour).
4. Legacy PDF files open inline at the bottom of the documents panel.

Allow pop-ups

For Markdown documents, your browser must allow pop-ups for the admin panel. If the tab does not open, check your browser's pop-up settings for this site.

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.

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.