Base de conocimiento

Una base de conocimiento es el material que tu agente puede consultar mientras habla: catálogos, políticas, preguntas frecuentes, tu sitio. El agente busca la respuesta ahí en tiempo real, sin que tengas que escribir todo en el guion.

Cómo se arma

1. 1
   Creá una base

   Ponele un nombre (por ejemplo "Políticas de pago") y empezá a cargar fuentes.

2. 2
   Subí el material

   Documentos (PDF, Word, texto), planillas, preguntas y respuestas escritas a mano, o tu sitio web. Para la web, Agregar fuente → Sitio web / URL tiene dos modos: una página (sólo esa dirección, sin seguir sus enlaces) o todo el sitio, con el interruptor Rastrear todo el sitio. Cada fuente se procesa sola.

3. 3
   Conectala a un agente

   En el editor del agente, pestaña Conocimiento, elegí la base. A partir de ahí el agente responde con esa información.

Todo tu sitio web

Si tu catálogo, tus servicios o tus preguntas frecuentes ya están publicados, no hace falta cargarlos página por página: la base puede traer el sitio entero y guardarlo como una sola fuente.

1. 1
   Pegá la dirección principal

   En Agregar fuente → Sitio web / URL, escribí la dirección de inicio, por ejemplo https://tusitio.com. Con la dirección principal, Rastrear todo el sitio se enciende solo y aparece como Recomendado; con una dirección interna queda apagado, porque lo más probable es que quieras esa página sola.

2. 2
   Revisá el tope y, si hace falta, acotá

   Al lado del interruptor ves hasta cuántas páginas trae tu plan. En Avanzado podés limitarlo a ciertas rutas (Solo estas rutas, por ejemplo /productos/) o dejar otras afuera (Excluir estas rutas, por ejemplo /blog/). El carrito, el pago, la cuenta del cliente y las búsquedas se saltean solos, y las páginas de etiquetas y de autor vienen ya cargadas en Excluir estas rutas (repiten productos que están en las categorías y se comen el tope de páginas): borrá la línea si las querés. Debajo, Actualizar cada semana viene encendido: la base vuelve a traer el sitio cada lunes (más abajo).

3. 3
   Tocá Rastrear sitio

   El sitio entra en cola y el avance se ve en la tabla de fuentes: primero Rastreando: N / M páginas y después Indexando las páginas…. Según el tamaño del sitio puede tardar varios minutos; mientras tanto podés seguir trabajando.

4. 4
   Revisá qué entró

   Cuando termina, la fila del sitio muestra cuántas páginas quedaron listas y cuántas se omitieron. Tocá ese contador para ver la lista completa, filtrarla por Listas, Omitidas o Con error, y el motivo de cada omisión.

Cada página se guarda con su dirección. Cuando el agente comparte un enlace, es uno que existe en tu sitio: no arma direcciones. En las llamadas no lee en voz alta las direcciones de las páginas; por escrito sí puede compartirlas.

• Un sitio ocupa una de las «Fuentes URL / sitios» de tu plan, no una por página. El tope de páginas por sitio depende de tu plan: lo ves al lado del interruptor y en Uso del plan.
• Cada sitio se carga una sola vez por organización. Para traer cambios, actualizalo (más abajo).
• Tu organización rastrea un sitio a la vez: si hay otro rastreo en curso, esperá a que termine.
• Si tu plan no incluye el rastreo de sitios web, el formulario te lo avisa y podés seguir cargando páginas sueltas.

Qué NO puede leer

El rastreo lee tu sitio como un buscador: el texto que las páginas le entregan a cualquiera, sin iniciar sesión. Queda afuera:

• Lo que está detrás de un inicio de sesión: áreas de clientes, intranets, precios sólo para mayoristas registrados.
• Páginas que se dibujan sólo con JavaScript. Si el contenido aparece recién cuando el navegador ejecuta la página, el rastreo la ve vacía. Si no encuentra ninguna página con texto, la fuente termina con el error «No encontramos páginas con texto».
• Imágenes, PDF y otros archivos enlazados. Aparecen como omitidos («No es una página»). Si un catálogo en PDF importa, subilo como archivo en la misma base.
• Precios que el sitio no publica. Si una ficha de producto no muestra un monto, la base no tiene precio para ese producto, y el agente no lo inventa. Tampoco se toma como precio un monto de relleno —«$ 1» o «$ 0» solos— que algunas tiendas muestran para esconder el precio real; un «Gratis», un «$0 / mes» o un «Precio: consultar» sí se leen tal cual. Si tu política es «los precios los da un asesor», escribila en una fuente de Texto para que el agente sepa qué contestar.
• Lo que tu `robots.txt` no permite. Si el robots.txt bloquea el sitio entero, la fuente termina con un error que lo dice. En cambio, las páginas marcadas para que los buscadores no las muestren (noindex) sí se leen: esa marca es para Google y los demás buscadores, y tu base es privada de tu cuenta.
• Lo que pasa el tope de tu plan. Si el sitio tiene más páginas de las que permite tu plan, el rastreo se detiene ahí y la fila del sitio avisa que quedaron páginas afuera. Acotalo con Solo estas rutas para que entren las que importan.

Actualizar el sitio

La base guarda el sitio como estaba el día que lo rastreó. Con Actualizar cada semana encendido —viene así al cargar el sitio—, cada lunes lo vuelve a rastrear sola. Si publicás cambios —productos nuevos, horarios, políticas— y no querés esperar al lunes, tocá Actualizar sitio en la fila del sitio.

• El sitio se vuelve a rastrear en unos minutos, según su tamaño. Mientras tanto, el agente sigue respondiendo con lo que ya tenía: la fila muestra Actualizando… y la base no se vacía.
• Las páginas que no cambiaron no se vuelven a procesar: sólo se procesa lo nuevo o lo modificado.
• Si el sitio devuelve muchas menos páginas que la vez anterior —menos de la mitad, por ejemplo porque estaba caído o en mantenimiento—, se conserva la versión vigente y la fila avisa que la última actualización falló. Un mal día de tu sitio no le borra la información al agente.
• Un mismo sitio se puede actualizar una vez por hora (el botón te dice cuántos minutos faltan), y tu organización puede iniciar hasta tres rastreos por hora, sumando altas y actualizaciones.
• La actualización de los lunes (a partir de las 07:41 UTC) trae de nuevo los sitios con el interruptor encendido cuyo último rastreo tiene más de cinco días y medio. Funciona igual que Actualizar sitio —sólo se procesa lo que cambió y el agente sigue respondiendo mientras tanto— y no gasta los tres rastreos por hora de tu organización. Corre de madrugada (hora de Colombia), fuera del horario del servicio de voz y de a un sitio por vez: con muchos sitios en cola, el tuyo puede quedar para esa misma noche o para el lunes siguiente, donde pasa primero.
• Podés apagarla o encenderla en cada sitio: al cargarlo, con Actualizar cada semana, o después, con el interruptor Actualizar cada semana de la fila del sitio. Lo podés cambiar en cualquier momento, también mientras el sitio se está rastreando.
• Si la última actualización falló porque tu robots.txt bloquea el rastreo o porque la dirección dejó de ser pública, la actualización de los lunes no lo reintenta sola: debajo del interruptor la fila dice En pausa con el motivo; tocá Actualizar sitio cuando esté resuelto. Lo mismo pasa si el sitio nunca llegó a completar su primer rastreo, aunque haya fallado por algo pasajero. Si un sitio que ya estaba cargado falló por algo pasajero —el sitio no respondió a tiempo, no mostró páginas con texto o trajo menos de la mitad, por ejemplo porque estaba en mantenimiento—, el lunes siguiente lo vuelve a intentar, y mientras tanto el agente sigue respondiendo con la versión vigente. Si tu sitio de verdad se achicó, tocá Actualizar sitio y confirmá el reemplazo.
• Una página suelta no se actualiza sola: tocá el botón ↻ (Reintentar) en su fila y se vuelve a descargar esa dirección; mientras tanto, el agente sigue respondiendo con la versión anterior.

Qué hace el agente cuando el dato no está

Con una base asociada, el agente responde sólo con lo que está en su guion y en su material. Si le preguntan algo que no está —un precio que no publicaste, un modelo que no vendés, un plazo de entrega—, dice que no tiene ese dato y ofrece el contacto de tu empresa que figure en tu información. No completa un catálogo con lo que «suele tener» un negocio como el tuyo, no arma enlaces y no dice que «consultó la página».

• Dejale un contacto para ofrecer. Poné tu teléfono, correo u horario —y lo que debe decir sobre precios o disponibilidad— en el guion o en una fuente de Texto. Si no figura en ningún lado, el agente no tiene a quién derivar.
• Los datos fijos, en el guion. Direcciones de tus sedes, horarios y políticas conviene escribirlos en el guion o en una fuente de Texto aunque estén en tu sitio: una pregunta como «¿dónde están?» no siempre se parece al texto de la página donde figuran.
• Lo que el agente dijo antes no cuenta como dato. Si en la misma conversación dijo algo que tu material no respalda, no lo repite, y si el material lo contradice, lo corrige.
• En el chat, el agente busca con toda la conversación. Si la persona arma lo que necesita en varios mensajes («tengo una farmacia», «que sea de incrustar»), la búsqueda tiene en cuenta lo que venía pidiendo; y si dice lo que NO quiere («no quiero bombillos»), busca sin eso. Una pregunta nueva («¿tienen un correo?») se busca sola.
• Con un sitio web, el agente de chat conoce el mapa de tu catálogo. Sabe qué categorías y familias de productos tenés —y cuántos productos hay en cada una— aunque la búsqueda de ese mensaje no las traiga, así que no le dice a un cliente que no vendés algo que sí está en tu sitio. Los detalles, precios y enlaces los sigue tomando de las páginas. El mapa se actualiza solo con cada rastreo.
• Las reglas vienen encendidas para todo agente con base: en el editor del agente, pestaña Conocimiento, sección Reglas de uso, interruptor Reglas estrictas de uso de la base. Apagadas, el agente puede completar con conocimiento general lo que tu material no dice, que es el camino por el que aparecen precios, modelos y enlaces inventados. Apagalas sólo si tu guion ya fija esos límites.
• Con mucho material, el agente busca por turno. En la misma pestaña, sección Modo de uso: cuando las bases marcadas suman más de 12.000 tokens, Todo al prompt se apaga y quedan Automático o Búsqueda por turno. Cargar un material tan grande completo en cada respuesta la haría lenta.
• El editor te avisa en la pestaña Conocimiento cuando el guion manda a consultar una base o un sitio y el agente no tiene ninguna asociada, cuando habla del sitio como si el agente navegara, o cuando la base asociada todavía no tiene material listo. Si el guion nombra tu sitio, el aviso trae Crear base desde el sitio: abre el alta de la base con el nombre del sitio ya escrito y, al crearla, el detalle te muestra el sitio sugerido con Agregar este sitio, que abre Sitio web / URL con la dirección cargada. Nada se rastrea hasta que lo confirmes. Cuando termines, Volver al agente te lleva a su pestaña Conocimiento para asociar la base. Si el agente tiene cambios sin guardar, el botón abre la base en otra pestaña para que no los pierdas; al volver al editor, la base nueva ya aparece en la lista. Si el agente ya tiene base y el guion habla del sitio como si navegara, el aviso trae Cargar el sitio en la base.
• Si el agente atiende por WhatsApp, un guion que promete una fuente que el agente no tiene impide vincularlo al número. Está explicado en El agente por WhatsApp.