> ## Documentation Index
> Fetch the complete documentation index at: https://wondeya.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> Qué es wondeya, qué renderiza y las palabras que usa

**wondeya** convierte una landing page en una conversación. Un visitante hace una pregunta y un agente de IA responde renderizando componentes visuales interactivos (una galería, una línea de tiempo, un conjunto de cifras destacadas, un formulario de contacto) en lugar de párrafos de texto de chat. Cada respuesta se construye con el material que el negocio publicó: los documentos que subes, las páginas que sincronizas, los datos breves que escribes a mano y las imágenes que registras.

Una landing page estática le muestra lo mismo a cada visitante y espera que eso cubra su pregunta. Una página de wondeya compone la página que cada visitante necesita, una pregunta a la vez.

## Qué ve un visitante

Una página de wondeya publicada es una página web real, renderizada en el servidor, con tus colores y tu tipografía. Lleva un aviso visible de que las respuestas las genera una IA, y un campo donde el visitante escribe. Cuando pregunta algo:

1. Las secciones aparecen como marcadores de posición en el instante en que el agente decide qué forma tiene la respuesta.
2. Cada marcador de posición se reemplaza en su lugar a medida que su componente termina de componerse: una imagen con su leyenda, un conjunto de pasos, un FAQ expandible, un formulario.
3. Una respuesta escrita de una línea llega junto a los componentes.

Las preguntas de seguimiento refinan lo que está en pantalla en lugar de reiniciar la página.

## Qué configuras

Configuras tres cosas. Un **agente** es el cerebro: el conocimiento, las imágenes y la identidad con las que responde, configurado una vez y reutilizable. Un **proyecto** es un sitio: su dirección `your-site.wondeya.app`, sus dominios y su marca, incluido el tema. Una **página** los une: una dirección dentro de un proyecto más el agente que responde ahí.

<CardGroup cols={2}>
  <Card title="Conocimiento" icon="book-open" href="/docs/es/knowledge">
    Documentos, URLs y afirmaciones curadas, propiedad del agente. El único material del que puede construirse una respuesta.
  </Card>

  <Card title="Recursos" icon="image" href="/docs/es/assets">
    Las imágenes que el agente puede mostrar, cada una descrita para que el agente sepa cuándo encaja.
  </Card>

  <Card title="Tema" icon="palette" href="/docs/es/theme">
    Cinco colores, dos tipografías y un radio de esquinas, de un conjunto que posee el servidor. Parte de la marca del proyecto.
  </Card>

  <Card title="Configuración de la página" icon="sliders" href="/docs/es/pages">
    La dirección de la página dentro del sitio, los idiomas, en nombre de quién habla el agente y el acto de publicar.
  </Card>
</CardGroup>

## Dos formas de ponerlo en marcha

* **Una página alojada.** Cada proyecto es un sitio con su propia dirección en `your-site.wondeya.app`, propuesta a partir del nombre del negocio y corregible; publicar su página principal lo abre al mundo. Un espacio de trabajo puede tener varios sitios.
* **Un widget en tu propio sitio.** Una etiqueta `script` pone el mismo agente en un sitio que ya tienes, dentro de un iframe aislado en un origen separado. Consulta [el widget](/docs/es/widget).

Ambos hablan con el mismo motor, con el mismo conocimiento y las mismas reglas.

## Dos audiencias, un producto

<CardGroup cols={2}>
  <Card title="Equipos sin ingenieros" icon="wand-magic-sparkles" href="/docs/es/quickstart">
    Haz todo el trabajo en la consola web: crea el sitio y su agente, sube conocimiento, sube imágenes, elige colores, publica. Sin código en ningún paso.
  </Card>

  <Card title="Desarrolladores" icon="code" href="/docs/es/api-reference/introduction">
    Ejecuta las mismas operaciones sobre la API REST, o como [herramientas MCP](/docs/es/mcp/introduction) desde Claude y otros clientes de IA, con autenticación OAuth. O incrusta el widget en tu propio front end con una sola etiqueta script.
  </Card>
</CardGroup>

## Qué hace seguras las respuestas

El modelo nunca dibuja la página. **Selecciona**: un tipo de componente de un catálogo cerrado, un recurso por id, un enlace por id. Después el servidor resuelve cada id en datos reales tras validarlo. Una URL ni siquiera es expresable en la salida del modelo, y eso es lo que hace seguro renderizar una respuesta de IA en una página pública a nombre de un cliente. [Cómo funciona](/docs/es/how-it-works) recorre el pipeline; [Seguridad y privacidad](/docs/es/security) cubre el aislamiento, el aviso de IA y la eliminación.

## Vocabulario

| Palabra | Qué significa en wondeya |
| - | - |
| **Espacio de trabajo** | El límite de la cuenta. Contiene tu equipo, tus proyectos, tus agentes y todo lo que poseen. Nada cruza de un espacio de trabajo a otro. |
| **Agente** | El cerebro: conocimiento, recursos e identidad, configurados una vez. Puede responder en muchas páginas y, a través del widget, en otros sitios. |
| **Proyecto** | Un sitio: su dirección `your-site.wondeya.app`, sus dominios y su marca. Un espacio de trabajo puede tener varios. |
| **Página** | Una dirección dentro de un proyecto, más el agente que responde ahí. Exactamente una página por sitio vive en `/`. |
| **Fuente de conocimiento** | Un documento, una URL sincronizada o una afirmación curada. El material en el que se fundamentan las respuestas. |
| **Recurso** | Una imagen o un video registrado, con una descripción que le dice al agente qué muestra. |
| **Componente** | Uno de los 13 bloques tipados de los que puede estar hecha una respuesta. El agente no puede inventar un decimocuarto. |
| **Site key** | La clave pública (`wdy_site_…`) que identifica a un agente ante el widget embebible. |
| **Clave de API** | La clave secreta (`wdy_live_…`) que un programa usa para llamar a la API REST de un espacio de trabajo. |

## A dónde ir después

* [Inicio rápido](/docs/es/quickstart): de una cuenta nueva a una página publicada.
* [Cómo funciona](/docs/es/how-it-works): qué pasa entre la pregunta y la respuesta.
* [Catálogo de componentes](/docs/es/components-catalog): los 13 bloques de los que puede estar hecha una respuesta.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.