---
title: "beeuni.toml heredado"
description: "Estado del soporte y ruta de migración de beeuni.toml v1 a beeuni.yaml v2."
---

Esta página trata el manifiesto v1 (`beeuni.toml`, `beeuni_version: 1`). Para consultar el manifiesto actual, ve a [Referencia del manifiesto](/docs/es/project/manifest).

<a id="support-status"></a>

## Estado de compatibilidad

Beeuni sigue admitiendo manifiestos v1. La plataforma busca el manifiesto de un proyecto en este orden: `beeuni.yaml`, luego `beeuni.yml` y, por último, `beeuni.toml`. El iniciador actual crea un `beeuni_version: 2` `beeuni.yaml`. Los proyectos v1 siguen funcionando sin que se les obligue a actualizar.

v1 admite sintaxis TOML o YAML. La versión 2 solo admite YAML. Un manifiesto v2 escrito en TOML no supera la validación.

<a id="migrate-to-v2"></a>

## Migrar a v2

1. Crea `beeuni.yaml` en la raíz del repositorio. Define `beeuni_version: 2`.

2. Convierte `[[agents]]` en un mapa de `agents:`, con el nombre del agente como clave.

3. Cambia el campo `env` de cada agente por `secrets`. Enumera todos los secretos que necesita el agente: v2 no concede acceso a secretos de forma predeterminada.

4. Añade `default_agent` e indica el agente que se ejecuta de forma predeterminada.

5. Elimina `[[channels]]`. Vuelve a conectar cada canal desde el panel.

6. Si usas `[sandbox]` o `[[sandboxes]]`, mueve cada definición de imagen bajo `sandbox.templates`.

7. Ejecuta `beeuni validate` contra `beeuni.yaml`. Corrige los errores que indique.

8. Elimina `beeuni.toml`.

El comportamiento del agente —el prompt del sistema, `model`, `mode`, `temperature` y más— nunca se mueve. Ya está en el frontmatter `.md` de cada agente, bajo `.beeuni/opencode/agents/`, tanto en v1 como en v2. Consulta [Agentes](/docs/es/project/agents).

Comprueba el resultado con `beeuni validate --file beeuni.yaml`. Obtén el esquema v2 completo con `beeuni schema --version 2`. Consulta la [Referencia de la CLI](/docs/es/cli) para ambos comandos.

<a id="key-differences"></a>

## Diferencias clave

| v1 (`beeuni_version: 1`) | v2 (`beeuni_version: 2`) | Cambio |
|---|---|---|
| `[[agents]]` (matriz) | `agents:` (mapa con el nombre como clave) | Convierte cada elemento de la matriz en una entrada del mapa. |
| `[[agents]].env` | `agents.<name>.secrets` | Se cambió el nombre. El valor predeterminado cambia de `all` a `none`; consulta la nota siguiente. |
| `[[agents]].model` | eliminado | No tenía efecto en v1 (se analizaba, pero nunca se aplicaba). El comportamiento del agente siempre proviene del frontmatter `.md` del agente. |
| `[[agents]].file` | `agents.<name>.file` | No tenía efecto en v1 (se analizaba, pero nunca se aplicaba). En v2, indica el `.md` del agente. |
| sin `default_agent` | `default_agent` (obligatorio) | Debe indicar un agente declarado y habilitado. |
| `[[channels]]` | eliminado | El enrutamiento de canales se administra desde el panel. Un canal conectado aparece como entrada `connectors:` con `provider: channel`. |
| `[sandbox]` (singular, con las claves de imagen directamente en él) | `sandbox.templates` (lista) | Mueve cada imagen a una entrada de plantilla. |
| `[[sandboxes]]` | `sandbox.templates` | Se cambió el nombre. |

:::warning[En v2, no se concede acceso a secretos de forma predeterminada]
  En v1, un agente sin el campo `env` obtiene todos los secretos del proyecto de forma predeterminada. En v2, un agente sin el campo `secrets` no obtiene ninguno. Al migrar, enumera todos los secretos que necesita cada agente: si un agente pierde un secreto sin aviso, puede fallar a mitad de una tarea.
:::

En v1, se toleran por compatibilidad algunas acciones de `beeuni_permissions` heredadas (`project.session.exec`, `project.gateway.routing.edit`, `project.schedule.read`, `project.schedule.write`, `project.webhook.read`, `project.webhook.write`, `channel.read`, `channel.connect`, `channel.send`, `channel.disconnect`): la plataforma muestra una advertencia, pero las permite. En v2, esas mismas acciones generan un error. Elimínalas de las concesiones de `beeuni_permissions` de cualquier agente antes de migrar.