Tu proyecto
Un proyecto es un repositorio de git que contiene la configuración y el estado de tu agente.
Un proyecto es un único repositorio de Git. Contiene un manifiesto, la configuración del agente y el estado que este produce. No hay una base de datos aparte que mantener sincronizada.
Beeuni respalda un proyecto de dos maneras:
- Repositorio administrado por Beeuni: Beeuni crea y aloja un repositorio privado. Es la opción predeterminada.
- Repositorio de GitHub importado: conecta un repositorio existente. Beeuni opera en él mediante la API de GitHub.
En ambos casos, el proyecto tiene un default_branch. Cada
sesión se crea a partir de él. Cada
solicitud de cambio se fusiona en él. Cada rama de un
repositorio de GitHub puede convertirse en su propio proyecto. main y dev pueden ejecutarse entonces como proyectos independientes, cada uno con sus propias sesiones y solicitudes de cambio.
Un proyecto no es tu base de código
Un proyecto contiene las instrucciones de tu agente, sus conectores, sus activadores y su memoria. Mantenlo pequeño: Beeuni lo clona en cada sesión.
Tu código vive en otro lugar. Cuando una tarea requiere una base de código, el agente clona ese repositorio, realiza el trabajo y abre una solicitud de cambio allí. No conviertas una base de código existente en un proyecto añadiéndole un manifiesto. En su lugar, crea un proyecto dedicado y vincúlalo a los repositorios en los que trabaja el agente.
El manifiesto
Todos los proyectos tienen un manifiesto en la raíz del repositorio, beeuni.yaml de forma predeterminada. La plataforma lee estas claves de nivel superior:
| Clave | Configura |
|---|---|
default_agent |
qué agente se ejecuta de forma predeterminada |
agents |
permisos por agente: conectores, secretos, habilidades y permisos de Beeuni |
sandbox |
la imagen y el hardware del entorno aislado |
triggers |
automatizaciones programadas y mediante webhooks |
connectors |
a qué herramientas externas puede acceder el proyecto |
env |
nombres de variables de entorno que espera el proyecto (los valores provienen de secretos) |
Las claves desconocidas se ignoran.
Es posible que los proyectos más antiguos aún usen beeuni.toml (beeuni_version: 1). Beeuni lee ambos formatos. Consulta TOML heredado para conocer la ruta de migración.
Eliminar un proyecto
Elimina un proyecto con Delete project en Danger zone, dentro de su configuración, o con beeuni projects rm. A partir de ese momento, nada puede actuar en nombre del proyecto:
| Vía de acceso | Después de eliminarlo |
|---|---|
Claves de la puerta de enlace LLM (kgw_…) |
Se rechazan con 401. |
| Enlaces públicos para compartir | Responden 410. |
| Aplicaciones | No se sirven. |
| Sesiones nuevas | Se rechazan: 404, code: "project_archived". |
| Slack y Teams | Responden «Este espacio de trabajo de Beeuni se eliminó…» y no inician nada. |
| Buzones de correo electrónico | Responden una sola vez al primer correo de un hilo: «Esta dirección no acepta correos por el momento. Nadie responderá a este mensaje». La siguiente respuesta de ese hilo, en un plazo de 30 días, no recibe respuesta. Tampoco se responde a los correos que no superan la autenticación del remitente. |
| Sesiones existentes | No reciben mensajes nuevos: ni de un hilo de chat, ni de un activador, ni de una solicitud en cola antes de la eliminación. |