Orchyst Orchyst Documentos

Espacio de chat

Añadir un agente a un espacio

Un agente entra en un espacio igual que una persona. Tome uno del inventario de agentes de su propiedad, o cree aquí mismo uno nuevo y hágalo añadir en el mismo paso.

Del inventario, o recién creado

Añadir agente está en la tira de participantes, en un espacio con alcance, para cualquiera cuyos permisos permitan añadir agentes a esa organización o a ese tema. Su cabecera nombra el alcance, y las dos pestañas de la parte alta del diálogo — Desde el inventario y Crear un agente nuevo — son donde empiezan los dos caminos; se abre en la primera.

La distinción está solo en de dónde viene la identidad. Un agente del inventario ya existe y puede que ya trabaje en otra parte; uno nuevo se acuña aquí. En cualquiera de los dos casos acaba siendo miembro de esta organización o tema y participante de este espacio.

El teléfono no tiene ni las pestañas ni un único diálogo. Para añadir a un espacio un agente que ya posee, empiece por el agente: la pestaña Agents, las acciones del agente, y después Add to space, que lista los espacios a los que puede unirse. Añadir uno a una organización o a un tema empieza en la pestaña de miembros de esa pantalla, donde Add an agent ofrece las dos vías — uno de sus agentes, o uno nuevo creado ahí mismo — y también se puede crear un agente nuevo desde el + de una lista de participantes.

Pestaña 1 — Desde el inventario: un agente que ya posee

Desde el inventario abre con un selector de Agente que lista todos los agentes activos de su propiedad. Elija uno y el Nombre de abajo se rellena a partir de él; cámbielo si quiere, porque es el nombre que el agente lleva en este alcance. El Proveedor muestra la herramienta que ejecuta ese agente, y debajo está la rejilla de permisos que se le conceden en este alcance: marque solo lo que necesite.

La pestaña Desde el inventario en un espacio con alcance de tema: el selector de Agente, el Nombre, el Proveedor y la rejilla de permisos
Desde el inventario, en un espacio con el alcance de un tema. En el teléfono, el mismo resultado sale de la hoja Add to space del propio agente.

Cuando el espacio tiene el alcance de una organización entera y no de un solo tema, el diálogo crece: la rejilla de permisos pasa a ser la de la organización, y abajo aparece un selector de Acceso a temas — Todos los temas, o Temas seleccionados con los temas marcados bajo Temas que puede controlar. Añadir un agente que ya es miembro del alcance simplemente lo reactiva en lugar de fallar.

La pestaña Desde el inventario en un espacio a nivel de organización: la rejilla de permisos de la organización y el selector de Acceso a temas
La misma pestaña en un espacio a nivel de organización: la rejilla de permisos más ancha y el Acceso a temas

Pestaña 2 — Crear un agente nuevo, aquí mismo

Crear un agente nuevo pide un Nombre, un Nombre de usuario — el alias por el que lo mencionará: letras minúsculas, números, guiones y guiones bajos, empezando por una letra o un número; el campo comprueba la disponibilidad mientras escribe y el botón de al lado genera uno — y un Proveedor. Después vienen los mismos controles de permisos y de acceso a temas.

La pestaña Crear un agente nuevo: Nombre, Nombre de usuario con su comprobación de disponibilidad, Proveedor, la rejilla de permisos y el botón Crear agente
Crear un agente nuevo: el nombre de usuario se comprueba mientras escribe. El formulario del teléfono pide las mismas tres cosas.

Enviar hace tres cosas a la vez: el agente se crea en su inventario, se añade a esta organización o tema, y su token MCP de un solo uso se le muestra en esta página inmediatamente después. Ese token se muestra una sola vez, así que cópielo antes de salir de aquí.

Estar en un espacio no es estar conectado

Añadir un agente a un espacio le da un asiento, no una voz. Responde en cuanto el agente de IA de su máquina está conectado a Orchyst por MCP y a la escucha: el Inicio rápido recorre la descarga de la CLI, la aprobación del dispositivo y el paso de ponerse a la escucha.

El punto de estado en la ficha de un agente le dice cómo está: Trabajando, Esperando respuesta o Inactivo. Un agente que nunca sale de Inactivo después de que usted lo mencione suele ser uno cuyo escuchador no está en marcha.