Guías

Proyectos

Organiza datasets y evals dentro de tu workspace — el contexto activo vive en la URL.

Un proyecto es una carpeta organizativa dentro de tu workspace. Agrupa datasets, evals, credenciales y trazas.

Un proyecto no es un límite de seguridad. El aislamiento está en el workspace: es ahí donde la base de datos separa los datos de un cliente de los de otro. Los proyectos solo agrupan; los roles y permisos son del workspace, no del proyecto.

Qué pertenece a un proyecto

  • Datasets y evals.
  • Credenciales (BYOK) — una credencial de otro proyecto se rechaza al lanzar una ejecución. La lógica es de radio de daño: una ejecución gasta la clave de ese proyecto.
  • Secretos de endpoint — los que usan las columnas Recuperadas (RAG).
  • Trazas, sesiones y la política de auto-calificación de Observabilidad.

El proyecto activo vive en la URL

Todas las páginas de la aplicación cuelgan de /p/<id>/…: /p/<id>/evals, /p/<id>/datasets, /p/<id>/traces, /p/<id>/credentials, /p/<id>/settings.

No hay selectores de proyecto en los formularios: el proyecto lo pone la URL, y cada listado y cada creación se acotan a él.

Si abres una entidad bajo el proyecto equivocado, Verica te redirige a su URL canónica en lugar de mostrar un error.

El selector

Arriba a la izquierda, un selector combinado de workspace y proyecto. Colapsado muestra dos líneas: el workspace arriba, en pequeño, y el proyecto abajo.

Al abrirlo se despliega en dos columnas: Espacio de trabajo a la izquierda, Proyecto a la derecha. Al pasar por un workspace distinto del activo, sus proyectos se cargan al momento; elegir un proyecto de esa lista cambia workspace y proyecto de una sola vez.

Al cambiar de proyecto, Verica conserva la sección y suelta la entidad: si estabas en la ejecución de un eval del proyecto A y cambias al B, aterrizas en la lista de evals del B.

El mismo panel muestra las invitaciones pendientes, si las hay, con Aceptar y Rechazar.

Un eval hereda el proyecto de su dataset

Esto no es una convención: está garantizado en la base de datos. Un eval no puede referenciar un golden set de otro proyecto.

En la práctica:

  • Elegir un golden set del proyecto X en el wizard pone el eval en el proyecto X.
  • Promover desde un dataset crea el eval, necesariamente, en el proyecto de ese dataset.
  • Las ejecuciones del eval resuelven sus credenciales y sus secretos de endpoint a través del proyecto del dataset.

Crear y cambiar

Crear: en la columna derecha del selector, la fila Nuevo proyecto… abre un campo en línea; Enter confirma, Escape cancela. El control solo aparece si tienes permiso para administrar proyectos en el workspace resaltado — el servidor lo verifica de todas formas.

Dos proyectos del mismo workspace no pueden llamarse igual.

Renombrar: desde la configuración del proyecto, con la misma restricción de nombre único.

El proyecto por defecto: cada workspace nace con un proyecto llamado Default. Al borrar un proyecto, Verica te lleva al primero que quede, y si no queda ninguno vuelve a crear Default.

Borrar un proyecto arrastra sus evals, datasets, trazas, sesiones, credenciales y secretos. Está bloqueado mientras alguna ejecución del proyecto esté en cola o ejecutándose.

En el plan Free puedes tener hasta 3 proyectos. Ver Planes y límites.

En esta página