Proyectos¶

Dale a cada trabajo su propio estante. Un proyecto es una carpeta propia en el servidor de tu agente, con sus propios archivos, sus propias instrucciones y sus propias conversaciones. La reforma se queda con la reforma y la tesis con la tesis, todo en un mismo agente.

🏠 Generaltu carpeta principal

💬Plan semanal
💬Dudas sobre la declaración de la renta

📁 Reformalos chats nuevos empiezan aquí

📝«Máximo 15 000 €, pide siempre tres presupuestos»
📄presupuestos.pdf · plano.png
💬Azulejos de la cocina
💬Agenda del electricista

📁 Viaje en familia👥 compartido

📄billetes.pdf
💬Itinerario día a día

Lo que te da un proyecto¶

Una carpeta propia

El agente trabaja dentro de la carpeta del proyecto: allí van a parar los archivos que envías en sus conversaciones, y también los archivos que crea, el código que ejecuta y las tareas que programa.
Sus propias instrucciones

Una nota que el agente lee al inicio de cada conversación del proyecto: para qué sirve, cómo trabajar y qué tener en cuenta.
Sus propias conversaciones

La lista de conversaciones muestra el proyecto en el que estás, y cada chat nuevo empieza ahí. Nada que recordar, nada que ordenar después.
Privado o compartido

En un agente que compartes con otras personas, un proyecto puede ser solo tuyo o compartido con todos, archivos y conversaciones incluidos.

Todo lo demás es lo mismo en todos los proyectos: la memoria y la personalidad del agente, sus habilidades, el modelo y los ajustes, las claves y los inicios de sesión, y tu crédito. El Gestor de archivos y el Terminal del panel muestran siempre el servidor entero. Cambiar de proyecto cambia dónde trabaja el agente, no quién es.

1 Activa los proyectos¶

Los proyectos están desactivados hasta que alguien los activa, y mientras tanto no se ve nada de ellos: todas las conversaciones trabajan en tu carpeta principal. Son nuevos, así que el panel los marca como Beta.

Panel: Ajustes → Proyectos → Usar proyectos.
Telegram: envía /projects y toca ▶️ Activar proyectos.

El interruptor es de todo el agente: cualquiera que lo use, sea el propietario o un usuario invitado, puede activarlo o desactivarlo. Desactivarlo no toca ninguna carpeta. Las conversaciones que empezaron en un proyecto siguen trabajando allí; solo las nuevas vuelven a tu carpeta principal.

2 Crea un proyecto¶

Panel: abre el selector de proyectos en la parte superior de la barra lateral y elige Nuevo proyecto. Ponle un nombre, pulsa Añadir proyecto y ya estás dentro, con un chat nuevo esperándote.
Telegram: /projects → ➕ Nuevo proyecto y envía el nombre. El bot crea el proyecto y te cambia a él.
Ajustes → Proyectos → + Nuevo proyecto crea uno sin salir del proyecto en el que estás.

Cada proyecto tiene su propia carpeta en el servidor del agente.

💡 Si tu agente tiene activado Permitir usuarios adicionales, el panel también pregunta Quién puede verlo: Solo yo o Todos los usuarios de este agente. Puedes cambiarlo más adelante: consulta Proyectos en un agente compartido. Un proyecto creado en Telegram empieza siendo privado.

3 Cambia de proyecto¶

En el panel, el selector que hay encima de la lista de conversaciones muestra el proyecto en el que estás. Elige otro y la lista se llena con sus conversaciones, y los chats nuevos empiezan allí. Gestionar proyectos, al final del mismo menú, abre los ajustes.

En Telegram, /projects (o /menu → Ajustes → 📁 Proyectos) muestra tus proyectos: 🏠 tu carpeta principal, 📁 los tuyos, 👥 los compartidos, con ✅ en el activo. Toca otro para cambiar. Si el chat en el que estás pertenece a otro proyecto, enseguida empieza una conversación nueva en el que elegiste, y su título fijado empieza por el nombre del proyecto. Después, /sessions muestra las conversaciones de ese proyecto, con su nombre arriba.

Renombrar, compartir, editar las instrucciones y quitar proyectos se hace en el panel.

Conviene saber:

Una conversación se queda donde empezó. Cambiar de proyecto nunca mueve un chat que ya está en curso. Conserva su proyecto, su carpeta y sus instrucciones; el cambio solo decide dónde empieza el siguiente.
El panel y Telegram eligen por separado. Puedes estar en Reforma en Telegram mientras el panel muestra Tesis. Cada uno recuerda su propia elección.

4 Dale instrucciones al proyecto¶

Ajustes → Proyectos → el ⋯ junto a un proyecto → Instrucciones…

Escribe ahí lo que el agente debe saber: para qué es el proyecto, quién participa, qué decisiones ya están tomadas, cómo te gusta que se haga el trabajo. El agente lo lee al inicio de cada conversación de este proyecto, así que no tienes que volver a explicarle el contexto cada vez.

Por ejemplo

«Reforma de nuestro piso. Presupuesto máximo: 15 000 €; terminar en marzo. Pide siempre al menos tres presupuestos. Lleva una tabla de costes en costes.xlsx y actualízala cada vez que llegue una oferta.»

Lo esencial, al principio

Una conversación ya en curso conserva las instrucciones con las que empezó, así que un cambio se aplica a partir del siguiente chat. Las instrucciones largas no son problema, pero solo los primeros miles de caracteres le llegan al agente directamente; el resto lo lee del archivo cuando le hace falta.

Las instrucciones se guardan en la carpeta del proyecto como un archivo normal (AGENTS.md), así que también puedes pedirle al agente que las escriba o las actualice por ti.

Tu carpeta principal¶

Cada persona que usa el agente tiene su propia carpeta principal, que aparece como General en el selector. Es donde trabajan las conversaciones mientras los proyectos están desactivados, y donde está todo lo anterior a los proyectos.

General es tu casa, no un proyecto: no se puede renombrar, compartir ni quitar. También es el sitio para el trabajo que abarca varios proyectos. Desde un proyecto, el agente se ciñe a la carpeta de ese proyecto; desde General puede entrar en todas.

Proyectos en un agente compartido¶

Cuando compartes tu agente con otras personas, cada una tiene su propia carpeta principal y sus propios proyectos. Cada proyecto es de uno de estos dos tipos:

Privado (por defecto)

Solo aparece en tu lista, y solo tus conversaciones van ahí.
Compartido

Aparece para todos los usuarios del agente, marcado como Compartido. Todos trabajan con los mismos archivos e instrucciones, y sus conversaciones también se comparten.

En un proyecto compartido, las conversaciones son terreno común. Todos las ven en la lista del proyecto y pueden leerlas, continuarlas, renombrarlas o eliminarlas, así que varias personas pueden trabajar en el mismo chat: en el panel o en Telegram, donde /sessions las marca con 👥 y basta un toque para unirse. Cada mensaje muestra quién lo escribió, y el agente sabe a quién responde. Responde a un mensaje cada vez: si está respondiendo al de otra persona, el panel o el bot te lo indica, y envías el tuyo cuando haya llegado la respuesta.

Compartir o hacer privado, desde el menú ⋯ del proyecto: Compartir con todos los usuarios o Hacer privado. Un proyecto que pasa a ser privado desaparece de las listas de los demás, y las conversaciones que tenían en él continúan en su propia carpeta principal.
Quién gestiona un proyecto compartido: la persona que lo creó y el propietario del agente. Renombrarlo y quitarlo les corresponde a ellos. Solo quien lo creó puede volver a hacerlo privado.
Las tareas en segundo plano de un proyecto compartido son de todos. Todos los usuarios las ven en Ajustes → Tareas en segundo plano, pueden modificarlas y reciben sus notificaciones en el panel y en Telegram.
Cuando se elimina a un usuario, los proyectos que compartió siguen compartidos y pasan al propietario. Sus proyectos privados desaparecen de las listas, y los archivos se quedan en el servidor.

Privado significa fuera de la lista, no bajo llave

Los usuarios invitados son usuarios de confianza. El trabajo de todos se ejecuta con la misma cuenta en el servidor del agente, así que un proyecto privado no aparece en las listas de los demás, pero no es una caja fuerte. Lo que sea realmente secreto, mejor fuera de un agente compartido.

Quitar un proyecto o eliminarlo para siempre¶

Eliminar se hace en dos pasos, para que nada desaparezca por accidente:

⋯ → Quitar de la lista. El proyecto desaparece de las listas, pero sus archivos y conversaciones se quedan en el servidor, y tus conversaciones de ese proyecto aparecen en General. Encontrarás el proyecto en Proyectos quitados, al final de Ajustes → Proyectos, donde Devolver a la lista lo recupera.
Proyectos quitados → ⋯ → Eliminar definitivamente… Esto borra la carpeta con todos sus archivos y todas las conversaciones que trabajaron en ella, y no se puede deshacer. Para confirmar, escribes el nombre de la carpeta. En un proyecto compartido, el panel también te dice cuántos otros usuarios tienen conversaciones en él.

Conviene saber¶

Renombrar solo cambia el nombre. La carpeta conserva el nombre con el que se creó, así que los enlaces, scripts y herramientas que la usan siguen funcionando. La ventana de instrucciones muestra el nombre real de la carpeta.
Los archivos que envías se quedan con el proyecto. Un archivo que envías en una conversación de un proyecto se copia en uploads, dentro de la carpeta del proyecto, y el agente trabaja con él ahí mismo. Con los proyectos desactivados, los archivos se guardan como siempre.
Las tareas en segundo plano se ejecutan en un proyecto. En Ajustes → Tareas en segundo plano, el primer campo de una tarea es su proyecto, y una tarea nueva empieza en el que tienes abierto. Una tarea que le pides al agente en una conversación de un proyecto se ejecuta en ese proyecto. La tarea de un proyecto compartido avisa a todos los que usan el agente; cualquier otra, solo a ti. Mientras los proyectos están desactivados, cada tarea avisa solo a la persona a la que pertenece.
La búsqueda lo abarca todo. El agente busca en el historial de todas tus conversaciones, estén en el proyecto que estén, y puede decirte de qué proyecto viene un resultado.
La API trabaja en General. Las llamadas a través de la API compatible con OpenAI del agente siempre trabajan en la carpeta principal de quien llama.
Hasta 50 proyectos caben en un agente, contando los de todos. Un nombre puede tener hasta 60 caracteres.