Bases de conocimiento

Una base de conocimiento guarda entradas, y una entrada es Markdown. O la escribes tú, o la escribe un sitio: un sitio es una URL — o un patrón de URL — que Vatio lee, convierte a Markdown y vuelve a leer cada noche.

vatio kb create docs
vatio kb follow docs acme.com/help/**      # una entrada por página que matchee
vatio kb write docs horarios horarios.md   # o escribe una tú
vatio kb show docs

Crea una base por cada conjunto de páginas que quieras mantener separadas — cualquier cosa que solo un agente deba leer va en su propia base.

Referencia la base en el agente que la lee, y dale knowledge_lookup:

agent:
  instructions: |
    Search knowledge_lookup before answering questions about Acme's policies.
    If the results do not answer the question, say so.
  tools: [knowledge_lookup]
  knowledge: [docs]

Corre vatio push después de cambiar estas referencias. Una base referenciada ya debe existir — un nombre mal escrito falla el push en vez de convertirse silenciosamente en una base vacía. Quitar una referencia no borra su contenido.

Sitios

Un sitio es un campo y una regla: una URL es esa URL, un patrón es toda página que lo matchee.

Lo que escribes	Lo que lee
acme.com	la home, y solo ella
acme.com/help	esa página
acme.com/**	todas las páginas del sitio
acme.com/help/**	esa sección, a cualquier profundidad
acme.com/blog/*	los posts directamente bajo /blog

* matchea dentro de un segmento de ruta; ** matchea a través de segmentos. Nada está implícito: acme.com/help nunca significa "y todo lo que hay debajo". Las URLs deben ser HTTP o HTTPS públicas.

Vatio descubre páginas por una ruta exacta, llms.txt, un sitemap o los enlaces del sitio. Respeta robots.txt y puede renderizar páginas cuyo contenido necesita JavaScript. El contenido detrás de un clic o una búsqueda conviene escribirlo como entrada.

Todos los sitios se releen cada noche, y vatio kb refresh BASE [URL] los lee ahora. Una página cuyo Markdown no cambió cuesta una petición y nada más — no se reindexa ni se vuelve a embeber.

vatio kb unfollow BASE URL deja de leer un sitio y borra las entradas que escribió: son una copia de páginas que viven en otra parte, y conservarlas dejaría a la base respondiendo desde algo que ya nada refresca.

Entradas

vatio kb write docs refunds refunds.md   # la crea, o reemplaza lo que haya
vatio kb cat docs refunds                # exactamente lo que Vatio guarda
vatio kb cat docs refunds | edit | vatio kb write docs refunds

vatio kb write BASE ENTRY [FILE] pone Markdown bajo un nombre, leyendo stdin cuando no se entrega archivo. El título de la entrada sale de su propio # heading. Los headings dividen una entrada en secciones buscables; escribe cada una para que pueda responder una pregunta por sí sola.

Una entrada que escribió un sitio no es editable — la próxima lectura la sobrescribiría sin avisar. Cambia el sitio, o escribe tu propia entrada.

Usa vatio kb show docs para revisar el estado y los errores de cada sitio, y qué entradas están listas para responder. La lectura y la indexación son asíncronas: una entrada aparece lista una vez que sus secciones se embebieron. Prueba la recuperación en una conversación después.

vatio kb rm-entry BASE ENTRY borra una entrada. vatio kb rm BASE borra una base solo cuando ningún agente desplegado la referencia.

El conocimiento es compartido por todos los entornos. Escribir, refrescar y borrar contenido puede cambiar respuestas en vivo de inmediato. El rollback de despliegue no restaura contenido de conocimiento.

Permitir a VatioBot

Si eres dueño de un sitio cuyo robots.txt bloquea el crawling, permite a VatioBot en el robots.txt de ese sitio:

User-agent: VatioBot
Allow: /

Después corre vatio kb reindex BASE SOURCE. No hay opción para saltarse la política de crawling del sitio.