Recursos

Los recursos son el vocabulario visual de un agente: las imágenes y los videos que puede colocar dentro de una respuesta. El agente solo puede usar lo que registraste: nada se descarga de la web, nada se genera, y ningún recurso de otro espacio de trabajo puede aparecer jamás.

​

Qué lleva un recurso

description y alt son dos campos distintos con dos audiencias distintas, y confundirlos es el error clásico: uno decide si el recurso se elige, el otro es lo que escucha un visitante ciego.

​

Subir recursos

Desde la consola, una subida puede ser una imagen (PNG, JPEG, WebP, GIF o AVIF, hasta 8 MB) o un video (MP4 con H.264/AAC, o WebM con VP9/Opus, hasta 15 MB y 60 segundos). El formato se decide por los bytes del propio archivo, nunca por su nombre ni por su tipo declarado: un .png que en realidad es otra cosa, o un video con un códec ilegible, se rechaza en lugar de servirse desde el origen de wondeya. Un video de más de 60 segundos se rechaza con wondeya.asset.video_too_long. Volver a subir exactamente el mismo archivo al mismo agente devuelve el recurso existente en lugar de crear un duplicado; el mismo archivo subido a otro agente es un recurso separado a propósito.

​

Curación al subir

Cada subida atraviesa una pasada de visión que redacta el borrador de la descripción, los temas y los dos textos alternativos (español e inglés): lo que el recurso realmente muestra, no lo que el nombre del archivo afirma. En un video, la pasada lee su frame de póster (la imagen fija que wondeya extrae al subirlo), nunca la imagen en movimiento. Los temas que tú mismo fijas al subir se conservan por encima de la sugerencia del modelo. La pasada se ejecuta dentro de la subida, porque un recurso sin descripción es un recurso que el agente nunca elegirá. Dejarlo para después significa un registro que, en silencio, no hace nada. Dos consecuencias que vale la pena conocer:

• La curación nunca bloquea una subida. Si el modelo de visión no está disponible, tu imagen llega igual; lo que pierdes es un borrador de descripción que puedes escribir tú mismo.
• Editar cualquier cosa lo hace tuyo. En cuanto corriges el texto, el recurso se marca manual, la consola deja de presentarlo como una sugerencia y ninguna re-curación futura sobrescribirá tus palabras.

Un recurso con la descripción vacía queda fuera del registro que ve el agente. Una imagen que el agente no puede distinguir de otra es peor que una que nunca ve, porque termina elegida para la respuesta equivocada.

​

Cómo usa el agente un recurso

Mientras se selecciona el conocimiento, una etapa de selección paralela lee el registro curado completo del agente, incluido el pool del espacio de trabajo, contra una consulta derivada de la pregunta del visitante, y elige como máximo cuatro recursos. De cada recurso ve id, tipo, orientación y descripción. Nunca una URL, nunca el archivo, nunca la ubicación de almacenamiento. Los recursos ya mostrados en la conversación se excluyen en código, no solo en el prompt. Luego el agente coloca los ids en componentes: media, mediaCard, gallery y, opcionalmente, timeline, metrics o grid. Después de que el componente pasa la validación, el servidor cambia cada id por una URL firmada al archivo en el almacenamiento propio de wondeya. Por eso una inyección de prompt escondida en un documento subido no puede poner una imagen arbitraria, un píxel de rastreo o un enlace frente a un visitante: el modelo nunca tuvo un campo donde escribir una dirección. La orientación tampoco es decorativa. Una captura vertical en un espacio de ancho completo crece hasta volverse ilegible de tan alta, así que el modelo ve la orientación de cada recurso al componer, y el payload resuelto la lleva consigo para que el renderizador pueda colocar las imágenes verticales junto al texto en lugar de a ancho completo.

​

Escribir descripciones que funcionan

• Di lo que es visible: “un mostrador de panadería con hogazas de masa madre y una pizarra de precios”, no “nuestra promesa de marca”.
• Nombra aquello por lo que un visitante preguntaría: el producto, la pantalla, el espacio.
• Mantenla en una o dos oraciones. Un texto más largo no ayuda al agente a elegir mejor.
• Agrega temas que coincidan con las preguntas que la imagen responde (storefront, products).

​

Renombrar y borrar

La key es lo que el agente emite, así que cambiarla cambia a qué imagen apunta una respuesta futura. Las keys son únicas dentro del registro de un agente: dos agentes de un mismo espacio de trabajo pueden tener cada uno un hero, y un segundo hero dentro de un mismo agente se rechaza. Las páginas que comparten un agente comparten sus recursos y sus keys. Borrar un recurso es de verdad: la entrada del registro y el archivo almacenado se van juntos. Borrar una página elimina solo la página: su agente conserva todas las imágenes, dondequiera que ese agente responda. Borrar el agente es lo que elimina su registro y los archivos almacenados, y eso se rechaza mientras una página todavía responda con él.