Preguntas frecuentes
Las preguntas que surgen en la primera semana.
¿Tienes alguna pregunta? Pregúntale al agente
Si tienes preguntas sobre lo que Letaido puede hacer, encuentras un error o no estás seguro de cómo funciona algo, la respuesta más rápida es preguntarle directamente al agente en el chat. Puede leer su propia documentación, revisar tu espacio de trabajo, comprobar tu configuración y guiarte a través de lo que ve, todo en el mismo lugar.
Las preguntas frecuentes que aparecen a continuación cubren las cuestiones que surgen con más frecuencia. Si la tuya no está aquí, pregúntale al agente; si merece la pena incluirla, el agente se ofrecerá a añadirla.
Conceptos básicos
¿Recuerda entre chats?
Sí, pero solo lo que le digas que recuerde. Lee ~/workspace/.memory.md al inicio de cada chat. Di "recuerda esto: X" y lo añade. El registro de cambios (progress.md) también se lee, para que sepa qué se construyó recientemente.
¿Puedo revertir algo que haya creado?
Los archivos son fáciles: pregunta "muéstrame qué has cambiado en la última hora y revierte X". Los cambios en la base de datos no se revierten automáticamente, pero cada acción se registra, por lo que deshacerlos suele ser una conversación clara. Para cambios destructivos (eliminar tablas, eliminar habilidades), el agente pregunta antes de hacerlo.
¿Pueden varias personas compartir un espacio de trabajo?
Sí. Los roles son propietario, administrador, miembro y espectador. El propietario y el administrador deciden las tarjetas de aprobación, gestionan los secretos y activan o desactivan el sitio público. Los miembros chatean y usan las páginas de Console. Los espectadores solo tienen acceso de lectura.
¿Se envía algo de lo que escribo a un tercero?
El agente razona a través de un proveedor de LLM mediante un proxy local. Los mensajes se envían para inferencia y se reciben las salidas. No se retiene nada más allá de lo que indique la política del proveedor del modelo. No se comparte nada con otros espacios de trabajo.
¿Qué ocurre cuando falla una API externa?
El agente informa del fallo (código de estado, categoría de error si el conector expone una), se detiene y espera instrucciones. No reintenta hasta que tu presupuesto explote.
Crear cosas
¿Cuánto tiempo se tarda en crear una aplicación de consola?
Los sencillos (un formulario, una consulta, un resultado) se completan en unos minutos. Los complejos (pipeline de varios pasos, integraciones de terceros, visualización personalizada) requieren una sesión de chat, a veces dos. El agente te indicará si espera necesitar más de una ida y vuelta.
¿Cómo comparto algo con un cliente?
Constrúyelo en el sitio público, obtén la URL, cambia el modo del sitio a open o authorized, comparte el enlace. Patrones que debes conocer: informes con acceso por token (/<route>/<token>), documentación pública (este sitio), páginas de captura de leads.
¿Puede el agente construir algo que no haya construido antes?
Sí, siempre que existan los primitivos (blueprint de consola, ruta del sitio, cron job, webhook, conector). Los compone. Si el primitivo no existe (se necesita una nueva capacidad de la plataforma), te lo dirá claramente en lugar de fingir.
¿Qué pasa si no hay un conector para el servicio que necesito?
Pide a soporte que añada un nuevo conector para esa aplicación. Los nuevos conectores se añaden regularmente según las solicitudes de los clientes; mientras tanto, el agente normalmente puede recurrir a una clave de API genérica, una lista de dominios permitidos y HTTP sin procesar, pero siempre se prefiere un conector adecuado (incluye entradas tipadas, registro, credenciales con ámbito y aprobación por superficie de forma predeterminada).
Memoria, habilidades, voz
¿Cómo me aseguro de que el agente use la voz de nuestra marca?
Hay una habilidad de voz de marca en tu espacio de trabajo. El agente la lee al escribir o revisar textos. Para añadir una nueva regla: "actualiza la habilidad de voz de marca para añadir:
¿Por qué dices que no se usen rayas (em dashes)?
Es una elección de estilo de la casa a la que este espacio de trabajo se ha comprometido. La regla vive en la memoria y en la habilidad de voz de marca, por lo que cada borrador (y estos documentos) los evita. Reemplázalos con comas, dos puntos, puntos o paréntesis.
¿Debería poner todo en memoria?
No. La memoria es para cosas que cambian los valores predeterminados del agente: quién eres, cómo escribes, qué te importa a largo plazo. Para reglas de flujo de trabajo ("nuestra lista de verificación de lanzamiento estándar es X"), una habilidad es mejor. Para contexto puntual ("este cliente es sensible sobre los precios"), dilo en el chat.
Sitio público, documentos, resumen semanal
¿Cómo se actualizan estos documentos?
El código fuente markdown se encuentra en ~/workspace/docs/*.md. El responsable del mantenimiento lo edita manualmente. Un trabajo de sincronización (cada 30 minutos) renderiza el markdown en la base de datos. El sitio público lee desde la base de datos.
¿Qué es el resumen semanal?
Un trabajo programado que se ejecuta los lunes a las 10:00 hora de Europa/Bucarest. Compara la memoria del agente, el registro de cambios y la carpeta de habilidades desde el último resumen, pregunta al LLM qué ha cambiado y los clientes deberían saber, y envía por Slack las ediciones de documentación sugeridas al responsable del mantenimiento. El responsable del mantenimiento las revisa; la documentación se actualiza.
¿Por qué no publicar automáticamente las sugerencias?
Dos razones. (1) Una edición sugerida por un LLM puede ser sutilmente incorrecta; la documentación es la cara pública del producto. (2) La revisión humana mantiene la voz consistente y detecta cosas que parecen correctas pero no lo son.
¿Cómo informo de un problema con la documentación?
Díselo al agente en el chat. Abrirá una nota en el espacio de trabajo y se la mostrará al responsable de la documentación en el próximo resumen semanal.
Aprobaciones, secretos, dinero
¿Por qué me sigue pidiendo que apruebe cosas?
Porque la acción cuesta dinero, accede a la red o toca credenciales. Cada una se registra. La solución para "demasiadas tarjetas de aprobación" suele ser agrupar la solicitud: pide al agente que planifique todo el flujo primero para que solicite todos los ámbitos y aprobaciones de una sola vez.
¿Puedo ver qué credenciales están configuradas?
Sí, desde la interfaz de usuario del espacio de trabajo. Puedes ver el nombre del secreto, el tipo, el estado y a qué conectores y superficies se le ha concedido. No puedes ver el valor del secreto; nadie puede, incluido el agente.
¿Puedo limitar la tasa de gasto del agente?
La plataforma mide los tokens de LLM y las llamadas al conector. Para un control de costes sostenido, los trabajos son la superficie adecuada (son gastos recurrentes explícitos); el gasto de chat ad-hoc es lo que pidas. Si un trabajo no funciona correctamente, páusalo desde la pestaña Trabajos.
Solución de problemas
La URL del sitio público devuelve 403.
El modo del sitio está desactivado. Cambia a autorizado (solo miembros) o abierto (cualquiera) desde la pestaña Sitio público.
Una página de la consola se carga indefinidamente.
La página está realizando una llamada externa larga (el tiempo de espera de nginx es de 30 segundos; el trabajo largo debería usar el patrón job-id-then-poll), o el proceso de Flask se ha bloqueado. Comprueba los registros finales en /home/console/http/data/.tail.log.
Una llamada al conector devuelve approval_pending o not_approved.
Primera vez para esa combinación de (conector, secreto, superficie). Aprueba la tarjeta. Para las superficies de consola o sitio, un propietario o administrador hace clic en request_connector_approval por separado de la superficie de chat.
Un trabajo no se ejecutó cuando esperaba.
Los horarios de Cron son UTC en el host. Si tu tarea es "todos los lunes a las 9 AM en Bucarest", la línea de programación es 0 7 * * 1 (verano) o 0 8 * * 1 (invierno); el agente normalmente elige uno y añade una protección de zoneinfo dentro del script para gestionar el horario de verano. Consulta la pestaña Tareas para ver la hora de la próxima ejecución.
Un activador no se está ejecutando.
Comprueba la lista de suscripciones. Si muestra paused o revoked, vuelve a suscribirte. Si muestra active pero no hay eventos, comprueba la configuración de la aplicación de terceros (la URL de suscripción también tiene que estar configurada en su lado).
Mi espacio de trabajo se siente lento.
Las sesiones de chat largas se degradan. Inicia un nuevo chat; la memoria y el progreso mantienen el contexto importante.