--- title: "Tu proyecto" description: "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](/docs/es/work/sessions) se crea a partir de él. Cada [solicitud de cambio](/docs/es/work/change-requests) 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](/docs/es/connect/connectors), sus [activadores](/docs/es/connect/triggers) 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](/docs/es/project/legacy-toml) 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. | ## En esta sección La referencia completa de beeuni.yaml. Personas en Markdown con herramientas de alcance limitado. Qué modelo usa una sesión y quién paga. Valores cifrados que se inyectan en un entorno aislado. Migración desde beeuni.toml.