Proyectos¶

Un proyecto es un hogar para el trabajo en curso: un lanzamiento, un informe mensual, un encargo de un cliente. Guarda dos cosas que comparte cada chat iniciado en él:

Archivos en un contenedor. Sube un briefing, una hoja de cálculo o una carpeta entera una vez, y cada chat del proyecto - el de hoy y el de la semana que viene - trabaja sobre la misma copia. Un archivo que un agent escribe en un chat está en el siguiente.
Instrucciones que cada agent que responde en el proyecto lee después de las suyas: el tono, los plazos, dónde está la guía de marca.

Un proyecto tiene también un agent predeterminado, con el que empieza un chat nuevo en él. En un chat del proyecto puede responder cualquier agent; el predeterminado solo decide dónde empieza un chat.

Empezar un chat en un proyecto¶

Dos formas de entrar:

Nuevo chat en la página del proyecto abre el chat con el proyecto y su agent predeterminado ya elegidos.
El menú + del campo de mensaje ofrece Trabajar en un proyecto antes del primer mensaje, y también @: un proyecto elegido ahí empieza el chat en él en lugar de escribir su nombre en el mensaje. La etiqueta junto al selector de agent muestra el proyecto; su × empieza el chat fuera de él.

Un chat se queda en el proyecto en el que empezó. La etiqueta de un chat existente lleva de vuelta al proyecto.

Lo que recibe un agent en un proyecto¶

Responda el agent que responda, un run en un chat del proyecto trabaja en el contenedor del proyecto y no en un workspace propio:

Un agent sin sandbox recibe una, la del proyecto, así que un agent de chat sin más puede leer y escribir los archivos del proyecto.
Un agent con su propia vinculación de sandbox pasa al contenedor del proyecto. Los ajustes de aprobación de la vinculación se conservan, así que un autor que puso Preguntar siempre en la shell mantiene ese control.
El nombre, la descripción y las instrucciones del proyecto se añaden después de las instrucciones del agent. El agent sigue siendo quien es, trabajando en esto.

El contenedor es una sesión de sandbox cuando el despliegue tiene un servicio de sandbox, así que los archivos del proyecto también se pueden ejecutar, no solo leer. Sin él, el proyecto guarda sus archivos como un workspace almacenado, que lee y escribe igual pero no tiene shell; si dos chats escriben a la vez, cada uno conserva lo que escribió, y donde ambos cambiaron un mismo archivo queda la escritura posterior. Un proyecto se queda en la conexión de sandbox en la que se creó, así que esa conexión no se puede eliminar mientras un proyecto guarde archivos en ella.

Archivos¶

La pestaña Archivos del proyecto es el contenedor para explorar: un árbol junto a un lector que abre Markdown, PDF, imágenes, hojas de cálculo y código en el sitio.

Subir archivos y Subir carpeta ponen los archivos en la raíz del proyecto; una carpeta conserva su árbol. Cada archivo está sujeto al límite de subida del despliegue.
Nueva carpeta crea una carpeta vacía para que un agent la llene.
La papelera junto a un archivo o una carpeta lo elimina - una carpeta con todo lo que contiene - para cada chat y agent del proyecto.

El directorio .agenticos y las carpetas propias de la plataforma no se pueden escribir desde aquí; una ruta fuera del proyecto se rechaza antes de escribir nada.

Un proyecto se abre en Archivos. Los archivos también se pueden soltar en cualquier parte de la pestaña, y cada uno muestra su progreso mientras sube; un proyecto vacío es un solo lugar donde soltar los primeros. Chats es una tabla de los chats del proyecto, y Apps las apps que publicó un run en uno de ellos - las que el lector puede abrir. Las Instrucciones se editan en Markdown, con Fuente y Vista previa, como las de un agent en el Agent Builder, encima del nombre, la descripción y el agent por defecto del proyecto.

Un proyecto es privado para quien lo creó hasta que lo comparte, con el mismo diálogo Compartir que usa un agent o un skill: personas, departamentos o toda la organización, cada uno con un nivel.

Nivel de permiso	Permiso	Lo que permite
`read`	`projects:view`	Ver el proyecto, sus archivos y sus instrucciones
`use`	`projects:use`	Chatear en él, subir, crear carpetas, eliminar archivos
`edit`	`projects:edit`	Cambiar sus instrucciones y su agent predeterminado, compartirlo, borrarlo

Los roles los tienen en los ámbitos habituales: Owner y Admin llegan a cada proyecto, un Builder trabaja en los que se le comparten y los edita, un Member edita los suyos y trabaja en los compartidos, y un Viewer lee lo que se le compartió. Un chat cuyo autor pierde projects:use deja de llegar a los archivos del proyecto en su siguiente turno.

Los chats de un proyecto son de sus miembros. Quien puede ver un proyecto lee todos sus chats, y quien puede trabajar en él (use) los continúa: sus mensajes llevan su nombre y su cara, así que un hilo en el que trabajaron varias personas dice quién preguntó qué. Renombrar, archivar o borrar un chat sigue siendo cosa de quien lo empezó. En la pestaña Chats cada fila dice de quién es el chat, qué agents responden en él, cuándo se movió por última vez o quién está trabajando en él ahora, y quién lo ha abierto - las últimas caras, con todos los nombres al pasar el ratón; quien lo tiene abierto ahora mismo va primero, con un punto verde. Un chat fuera de un proyecto sigue siendo de su autor, como en el resto de la consola.

Un chat de un proyecto no se comparte por separado, ni por enlace ni con una persona: se lee a través del proyecto, así que comparte el proyecto.

Trabajar juntos en un chat. Varias personas pueden estar a la vez en un chat de un proyecto. Una barra sobre la transcripción muestra quién más lo tiene abierto, y su propietario puede invitar a alguien desde ahí. Mientras alguien escribe, los demás ven su cara y «Anna está escribiendo» sobre el campo de escritura. La pregunta que hace una de ellas, y la respuesta del agent, aparecen para todos en el chat mientras se escriben. Responder en cualquier mensaje lo cita sobre el campo de escritura, y la respuesta lleva la cita - en pantalla y al agent, que lee el mensaje de cada persona bajo su nombre y sabe que en el chat puede haber varias personas, así sabe quién preguntó qué y a qué se refiere «sí, hazlo».

Borrar un proyecto¶

Borrar un proyecto elimina su contenedor y todos sus archivos. Sus chats se conservan como chats normales, fuera de cualquier proyecto, salvo uno cuyo autor borró su cuenta: solo el proyecto llegaba a él, así que se va con el proyecto.

Dónde aparecen los proyectos¶

Proyectos en la barra lateral muestra los cinco usados más recientemente, encima del enlace a todos.
La lista de chats agrupa cada chat de los proyectos que puedes ver - los tuyos y los de tus compañeros - bajo el nombre del proyecto, encima de los chats que no están en ningún proyecto.
La tarjeta Proyectos del dashboard muestra una fila de ellos, con los chats en cada uno.
GET /api/v1/projects y sus subrutas forman parte de la API pública, así que un script puede crear un proyecto y llenarlo de archivos. Consulta la API.