Saltar al contenido principal

Proyectos y espacio de trabajo

Inicio · Interfaz y navegación · Control de acceso y roles de proyecto

Espacio de trabajo del proyecto

Objetivo

Esta página explica la diferencia entre Proyectos, Espacio de trabajo y Agentes, y detalla los ajustes de proyecto realmente visibles en la aplicación.

Tres superficies a distinguir

SuperficieCuándo usar
ProyectosCrear un proyecto, abrir un proyecto existente, cambiar de contexto
Espacio de trabajoLeer el resumen del proyecto, la transparencia operativa, las señales y los ajustes de nivel de proyecto
AgentesIniciar un intercambio en directo con un agente y leer la salida estructurada del run

En la práctica, Proyectos sirve para entrar en el contexto correcto, Espacio de trabajo para configurarlo y Agentes para aprovecharlo.

El papel exacto del proyecto activo

El proyecto activo es el contexto que se aplica en cada momento a las páginas de trabajo del proyecto.

En concreto, determina:

  • los documentos visibles en Conocimiento ;
  • las ejecuciones lanzadas en Agentes ;
  • los Documentos PM, los artefactos y las diferencias visibles en Informes y artefactos ;
  • las ejecuciones y los eventos mostrados en Registro IA ;
  • las señales, las integraciones y las políticas que aparecen en Espacio de trabajo.

No debe confundirse con:

  • proyecto activo: contexto operativo actual ;
  • Portafolio: vista de comparación entre varios proyectos ;
  • All projects: alcance opcional de un agente personalizado visible en varios proyectos para la misma cuenta.

Crear un proyecto

El formulario observado contiene los siguientes campos:

  • ID proyecto ;
  • Nombre ;
  • Descripción ;
  • Idioma de datos por defecto ;
  • Idiomas de datos adicionales.

Recomendaciones de entrada:

  • elige un ID legible y duradero ;
  • no confundas idioma de datos del proyecto y idioma de la interfaz ;
  • define correctamente el alcance antes de abrir el conocimiento o los agentes.

Creador del proyecto: derechos iniciales y delegación

Al crear, el creador del proyecto inicia con el rol Propietario del proyecto y todos los permisos del proyecto observados. En la práctica, es quien puede abrir el proyecto, verificar la configuración inicial y delegar luego los roles al resto del equipo.

Delegación recomendada justo después de la creación

  1. abre Control de acceso ;
  2. agrega al menos otro Propietario del proyecto o un Jefe de proyecto de confianza ;
  3. crea si es necesario roles personalizados dirigidos en lugar de multiplicar los propietarios ;
  4. asigna luego los roles a los colaboradores, lectores y auditores ;
  5. revisa finalmente las Políticas de gobernanza y las Integraciones del proyecto para alinear derechos, conectores y validaciones.

Lo que la plataforma sigue protegiendo

  • la entrada del creador sigue protegida ;
  • el rol del creador sigue fijo en la interfaz observada ;
  • la delegación se hace por asignación de roles adicionales, no por eliminación de la protección del creador ;
  • para el detalle RBAC, ver Control de acceso y roles del proyecto.

Abrir y cambiar de proyecto

Un proyecto puede abrirse desde:

  • la página Proyectos ;
  • el selector de proyecto de la barra superior ;
  • el contexto recientemente memorizado en el navegador.

Cuando cambias de proyecto, las superficies siguientes se alinean: Conocimiento, Agentes, Documentos PM / Informes y artefactos, Registro IA, las señales y los ajustes del proyecto.

Ese cambio de proyecto modifica por tanto el contexto activo utilizado por la búsqueda documental, las conversaciones con agentes, los informes y las trazas asociadas.

El último proyecto retenido puede recordarse localmente en el navegador para facilitar la reanudación, pero esa memoria local no es una configuración compartida por toda la plataforma.

El espacio de trabajo: centro de pilotaje del proyecto

El Espacio de trabajo reúne en una misma superficie:

  • el resumen del proyecto ;
  • accesos directos a Agentes, Documentos PM y Registro IA ;
  • una vista de transparencia operativa ;
  • las señales del proyecto ;
  • las pestañas de ajuste de nivel de proyecto.

Esta documentación ya no presenta una tarjeta voz dedicada en el Espacio de trabajo. Cuando la entrada de voz sigue existiendo en algunos entornos, se hace en Agentes, no como punto de entrada separado aquí.

Transparencia operativa y preparación

El espacio de trabajo no solo sirve para resumir el proyecto. También permite ver si el proyecto está listo para actuar:

  • presencia o ausencia de señales ;
  • actividad reciente ;
  • accesos directos a borradores o entregables relacionados ;
  • preparación de las integraciones del proyecto cuando existen ;
  • exposición del proveedor de IA efectivo sin abrir la configuración del inquilino.

Utiliza esta zona para entender por qué una acción o una importación pueden estar disponibles, pendientes de confirmación o bloqueadas.

Cómo llegan las señales, los digestos y los borradores

En la aplicación observada, el panel de señales del proyecto relee tres flujos compartidos de la plataforma para el proyecto activo:

  • las señales actuales ;
  • los digestos recientes ;
  • los borradores de notificación vinculados a esas señales.

Lectura útil:

  • abrir el espacio de trabajo recarga el estado compartido ya conocido para ese proyecto ;
  • Refresh pide explícitamente al sistema que vuelva a evaluar el proyecto y obtenga las señales proactivas más recientes ;
  • Generate digest draft construye un nuevo resumen agrupado y puede preparar notificaciones in_app ;
  • estos elementos no son simples notas locales del navegador ni restos del chat.

Pestañas de nivel de proyecto

PestañaPara qué sirve
Configuración de agentesConfigurar los agentes para este proyecto
Control de accesoGestionar miembros, roles y permisos de nivel de proyecto
Categorías de documentosAdaptar la taxonomía documental del proyecto y propagarla a las superficies documentales del proyecto
Políticas de gobernanzaDefinir conectores, destinos, políticas de acción, perfiles de render y preferencias de notificación de nivel de proyecto
Integraciones del proyectoVincular al proyecto las integraciones listas y autorizadas
Acciones & aprobacionesGestionar las solicitudes de acción, validaciones y ejecución gobernada

Configuración de agentes

Los parámetros confirmados a nivel de proyecto son:

  • status ;
  • temperature ;
  • max tokens.

Restricciones visibles

  • temperature se espera entre 0 y 2 ;
  • max tokens debe ser un entero mayor o igual a 1.

Historial de configuración

La interfaz también expone un historial por versión con al menos:

  • número de versión ;
  • estado ;
  • temperatura ;
  • max tokens ;
  • fecha de creación ;
  • autor ;
  • Trace ID asociado.

Ajustes de agentes a nivel de proyecto

Control de acceso

La pestaña Control de acceso administra los miembros y roles del proyecto. Soporta:

  • los roles estándar ;
  • los roles personalizados ;
  • las salvaguardas RBAC ;
  • la lectura sola para perfiles no autorizados a modificar.

Ver la página dedicada: Control de acceso y roles del proyecto.

Categorías de documentos

Esta pestaña sirve para alinear la clasificación documental con el proyecto. En la práctica, la taxonomía del proyecto influye en las categorías propuestas durante las cargas y en algunos selectores documentales usados después en las superficies del proyecto.

Efecto concreto de una actualización

Cuando la lista de categorías se modifica con éxito:

  • el selector de categoría de carga en Conocimiento se actualiza ;
  • los selectores y filtros de categoría en Documentos PM se alinean cuando usan esta taxonomía compartida ;
  • el cambio sigue limitado al proyecto actual.

Ejemplos prácticos

Mantén una taxonomía corta y estable. Por ejemplo, en lugar de multiplicar variantes cercanas, prefiere algunas categorías coherentes como:

  • carta del proyecto ;
  • registro de riesgos ;
  • informe de estado ;
  • plan de compras ;
  • plan de comunicación.

El objetivo no es codificar la versión del documento en la categoría, sino mantener una clasificación reutilizable entre Conocimiento y Documentos PM.

Categorías documentales del proyecto

Políticas de gobernanza

Esta pestaña fija las reglas que enmarcan las decisiones, validaciones y comportamientos de gobernanza del proyecto. Úsala antes de publicar un entregable o autorizar una acción externa gobernada.

Sub-superficies visibles en Políticas de gobernanza

Sub-superficieQué regula
Conectores de ejecuciónTipo de conector, estado, modo de ejecución, entorno, alcances y parámetros de contexto
Destinos de artefactosDestino objetivo de un artefacto, conector asociado, carácter activo o por defecto
Políticas de acciónRol concernido, conector objetivo, nivel de acción (observe, draft, propose, execute), efecto (allow, require_approval, deny) y alcances autorizados
Perfiles de renderPerfiles de render y formato de salida usados en las publicaciones gobernadas
Preferencias de notificaciónCanal, tipo de notificación, modo de digesto, umbral de severidad y activación de la preferencia

Ejemplos de ajustes útiles

  • exigir una aprobación explícita antes de una publicación a SharePoint ;
  • autorizar la creación de ticket Jira solo en nivel propose para ciertos roles ;
  • preparar preferencias signal_digest en in_app para el seguimiento interno ;
  • dejar las notificaciones externas email, teams o webhook en un camino aprobado solo cuando el conector esté sano ;
  • elegir perfiles de render separados para las publicaciones DOCX y XLSX.

Escenario creíble — proyecto sensible / difusión gobernada

Para un proyecto donde toda difusión externa debe ser controlada, un ajuste coherente suele ser así:

  1. Destinos de artefactos: destino SharePoint activo con perfil de render conocido ;
  2. Políticas de acción: allow para observe y draft, pero require_approval para execute en publicaciones y notificaciones externas ;
  3. Conectores de ejecución: conectores externos visibles solo para los roles realmente autorizados ;
  4. Preferencias de notificación: signal_digest en daily para el equipo, signal_alert solo para los casos más sensibles ;
  5. Integraciones del proyecto: bindings activados solo para los conectores ya validados a nivel de plataforma.

Esta combinación evita que un borrador, un digesto o una acción aparezcan como directamente difundibles cuando el proyecto aún espera una aprobación humana.

Políticas de gobernanza del proyecto

Integraciones del proyecto

Esta pestaña separa las integraciones definidas técnicamente a nivel de plataforma de las que son realmente utilizables por el proyecto.

Cómo leer esta pestaña

Integraciones del proyecto no es el lugar donde se configura toda la pila técnica del inquilino. Sirve sobre todo para leer la preparación operativa del proyecto: qué es visible para este proyecto, qué está listo y qué sigue bloqueado con una razón explícita.

Suele mostrar varias familias de información:

  • conectores de ejecución: opciones de salida gobernada hacia sistemas externos ;
  • proveedores de ingestión: fuentes de importación consumidas después por Conocimiento ;
  • transparencia del runtime de IA: proveedor de IA efectivo y proveedor seleccionado en el despliegue ;
  • postura de entitlement: plan, licencias o capacidades premium visibles para el proyecto.

Causas de bloqueo observadas de forma explícita

Una integración del proyecto o una opción de importación puede quedar bloqueada por:

  • entitlement ;
  • policy ;
  • permission ;
  • un estado de health que debe verificarse ;
  • una definición de plataforma ausente o desactivada ;
  • un binding del proyecto desactivado o sin configurar.

Cómo interpretar un bloqueo de binding

Causa visibleLectura prácticaReflejo recomendado
entitlementel plan o la capacidad autorizados no cubren este conector o esta familia de usoverifica la suscripción y las capacidades en Portafolio y administración técnica
policyla gobernanza del proyecto prohíbe o limita este flujorelee Políticas de gobernanza antes de cambiar el binding
permissionel conector existe, pero tu rol no permite activarlo ni usarlocomprueba el rol del proyecto en Control de acceso y roles del proyecto
healthla definición de la plataforma existe, pero su preparación o disponibilidad exigen verificaciónabre Administración de la plataforma para confirmar la definición técnica
definición ausente o desactivadanada está realmente listo a nivel de inquilinosolicita primero la puesta en marcha o la reactivación en la plataforma
binding del proyecto ausentela plataforma está lista, pero el proyecto aún no consume la integraciónactiva explícitamente el binding desde el proyecto

Sentido práctico de binding y entitlement

  • binding significa que el conector o proveedor existe a nivel de plataforma, pero todavía debe vincularse y habilitarse para el proyecto antes de que el proyecto pueda usarlo ;
  • entitlement significa que, incluso con un binding listo, el plan puede mantener la opción visible en solo lectura mientras bloquea el uso operativo ;
  • por eso, un conector visible pero bloqueado no implica necesariamente que esté averiado: la interfaz puede mostrarlo precisamente para explicar la causa del bloqueo.

Si un bloqueo persiste, abre luego Administración de la plataforma para verificar la definición técnica y vuelve después al proyecto para confirmar el binding y la preparación.

Jira, SharePoint y cadena de conectores

Flujo Jira y SharePoint entre plataforma, proyecto y acciones

Mantén esta lógica simple:

  1. Integraciones de la plataforma definen el conector o el proveedor de ingestión ;
  2. Integraciones del proyecto exponen solo el binding aprobado y listo ;
  3. Políticas de gobernanza deciden qué puede observar, preparar, proponer o ejecutar cada rol ;
  4. Acciones & aprobaciones aplican luego estas reglas en la solicitud real ;
  5. Documentos PM y Registro IA conservan la trazabilidad del flujo.

Ver la página dedicada: Conectores e integraciones.

Acciones & aprobaciones

Esta pestaña convierte una recomendación en una operación controlada.

Los estados reales que conviene recordar

En la interfaz observada, la cola y las tarjetas de síntesis distinguen sobre todo cuatro lecturas canónicas:

Estado visibleLectura práctica
Execution prerequisitespueden existir conectores compatibles, pero la ejecución sigue bloqueada por health, entitlement, permission, policy o por una preparación todavía no disponible
Pending approvalla solicitud ya se propuso y sigue esperando una decisión de gobernanza
Ready to executela solicitud ya está approved, pero la ejecución sigue siendo un paso aparte
Executed historyla acción ya se ejecutó realmente y permanece visible como historial o prueba de auditoría

Una solicitud puede estar approved sin estar todavía executed.

Cómo leer una pestaña que parece vacía o incompleta

Que la pestaña sea visible no significa que una acción ya sea ejecutable. Cuando nada concreto parece disponible, la lectura más útil suele ser:

  1. no hay ningún conector de ejecución compatible y sano listo para ese tipo de acción ;
  2. el binding del proyecto todavía no expone la opción al proyecto ;
  3. una policy permite revisar, pero no proponer ni ejecutar ;
  4. tu permission te permite ver la cola, pero no actuar ;
  5. se requiere aprobación y aún no se ha tomado ninguna decisión.

Cuando todo está realmente listo, como mínimo deberías encontrar:

  • un tipo de acción compatible ;
  • al menos una opción de ejecución sana ;
  • un binding del proyecto válido ;
  • una policy coherente ;
  • un usuario autorizado para proponer, aprobar o ejecutar según el caso.

Qué leer en Execution readiness

El bloque Execution readiness no administra toda la plataforma. Solo resume qué puede proponerse o ejecutarse ahora mismo en este proyecto.

Lectura útil:

  • available / healthy: opción teóricamente utilizable ;
  • blocked by health: el conector existe, pero no tiene un estado operativo suficiente ;
  • blocked by entitlement: la suscripción no cubre ese flujo ;
  • blocked by policy: la gobernanza del proyecto bloquea el paso ;
  • blocked by permission: tu rol no basta ;
  • ninguna opción visible: ningún conector compatible y aprobado está expuesto actualmente al proyecto.

Lectura sola o acceso denegado

  • lectura sola: la pestaña sigue visible pero la grabación está bloqueada ;
  • acceso denegado: la ruta o la acción no está disponible para tu cuenta.

Esta diferencia es particularmente importante para Control de acceso, Integraciones del proyecto y los ajustes de gobernanza.

Camino recomendado después de crear un proyecto

  1. abre el Espacio de trabajo ;
  2. verifica primero al creador, los miembros y los roles si el proyecto es colaborativo ;
  3. ajusta luego las categorías de documentos ;
  4. revisa las Políticas de gobernanza antes de cualquier difusión externa ;
  5. enlaza solo las Integraciones del proyecto realmente listas ;
  6. carga luego Conocimiento ;
  7. pasa finalmente a los Agentes, los Documentos PM y las Acciones & aprobaciones.

Dos escenarios de parametrización útiles

Escenario 1 — proyecto nuevo mínimo

Para un proyecto que comienza, mantén un orden simple:

  1. agrega los miembros indispensables y verifica sus roles ;
  2. crea una taxonomía documental corta en Categorías de documentos ;
  3. activa solo las integraciones ya validadas y realmente necesarias ;
  4. prepara una gobernanza mínima, por ejemplo un digesto interno y un destino de artefacto por defecto ;
  5. carga luego Conocimiento antes de abrir los agentes.

Este escenario evita abrir demasiado pronto conectores o reglas de difusión que no se usarán inmediatamente.

Escenario 2 — proyecto sensible / difusión gobernada

Para un proyecto expuesto a notificaciones externas o a una publicación documental formal:

  1. limita los roles que tienen acceso a conectores externos ;
  2. prepara un destino SharePoint o equivalente en Destinos de artefactos ;
  3. aplica require_approval en los niveles de acción que pueden producir difusión externa ;
  4. privilegia signal_digest para el seguimiento corriente y reserva alertas instantáneas a casos críticos ;
  5. haz visibles en Integraciones del proyecto solo los bindings cuya preparación y política ya sean conformes.

Este segundo escenario alinea la lectura de señales, difusión, aprobación y ejecución real en lugar de dejar al equipo tratar cada pantalla como una superficie independiente.

Siguiente