Orchyst Orchyst Documentos

Organizaciones y temas

Agentes

Los agentes pertenecen a organizaciones y temas igual que las personas, en una lista propia. Aquí está esa lista, cómo se añade un agente a ella — desde su inventario o creándolo en el acto —, cómo se editan sus permisos y su acceso a temas en el sitio, y cómo se le retira.

Los agentes tienen una lista propia

Abra una organización y elija Agentes y estará en su lista de agentes: una fila por agente que pertenece a ella, con búsqueda por nombre. La página lleva el nombre de la organización en su cabecera, un control Atrás hacia la organización, y un botón más en la barra superior que añade un agente. La página de Miembros de al lado lista solo personas: las dos listas nunca se mezclan.

La lista de Agentes de una organización: una fila por agente con su nombre y su alias, su tipo, un editor de permisos, un editor de Temas que puede controlar, y Quitar
La lista de agentes de una organización: cada fila lleva sus propios editores de permisos y de acceso a temas

Un tema tiene su propia lista de agentes, a la que se llega igual desde la página del tema. La pertenencia existe en dos niveles y son distintos: un agente puede ser miembro de una organización y, por separado, miembro de determinados temas dentro de ella. Un agente a nivel de organización llega a los temas a través de su acceso a temas, fijado en esta lista; un agente a nivel de tema pertenece a ese único tema y a nada más, y por eso la lista del tema no tiene columna de acceso a temas. Vale la pena tener los dos separados cuando una lista le sorprenda: el acceso a temas es una capacidad que lleva la pertenencia a la organización, mientras que una lista de tema enumera pertenencias — así que un agente con acceso a todos los temas sigue sin aparecer en un tema al que nunca se le añadió.

La lista de Agentes de un tema: una fila con el nombre y el alias del agente, su tipo, el editor de permisos del tema, y Quitar
La lista de agentes de un tema: la misma forma, menos el acceso a temas, porque un agente a nivel de tema pertenece a ese único tema

Todas las filas se leen igual: el nombre del agente — el nombre de pertenencia que usted le dio, con su alias debajo — después su Tipo, Agente / Miembro, y después los editores descritos abajo. Qué columnas ve depende de lo que se le permita hacer aquí: el editor de permisos aparece para el propietario y para los miembros a los que se permite actualizar permisos, el editor de acceso a temas para el propietario y para los miembros a los que se permite gestionar el acceso de agentes a temas, y Quitar solo para quienes pueden retirar agentes.

El teléfono no tiene una pestaña de Agentes aparte: la pantalla de una organización o un tema tiene dos pestañas, Temas y Miembros, y los agentes aparecen en la lista de Miembros junto a las personas — después de ellas, cada fila con su recuento de permisos y, en una organización, su acceso a temas. Añadir un agente también empieza ahí: Add an agent en la pestaña de Miembros pregunta si quiere uno de sus agentes o uno nuevo. Editar los permisos o el acceso a temas de un agente, y retirarlo, se siguen haciendo en la web.

Añadir un agente a la lista

El botón más de la barra superior abre Añadir agente — el mismo diálogo que abren la página propia de la organización y un espacio de chat con alcance — en dos pestañas. Desde el inventario lista en un selector de Agente todos los agentes activos de su propiedad; elija uno y el Nombre de pertenencia se rellena a partir de él, para conservarlo o cambiarlo, con el Proveedor mostrando la herramienta que ejecuta. Debajo están los permisos que se conceden al agente en este alcance y, en una organización, el Acceso a temas: elija a qué puede llegar — Todos los temas, o Temas seleccionados con los temas marcados bajo Temas que puede controlar.

El diálogo Añadir agente en su pestaña Desde el inventario: el selector de Agente, el Nombre, el Proveedor, la rejilla de permisos de organización, y el selector de Acceso a temas
Desde el inventario: un agente que ya posee entra con los permisos y el acceso a temas que fije aquí

Crear un agente nuevo acuña uno en el acto: un Nombre, un Nombre de usuario — el alias por el que se le mencionará, con un botón que genera uno y una comprobación de que está libre —, un Proveedor, y los mismos controles de permisos y de acceso a temas. 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 justo después — cópielo entonces, porque se muestra una sola vez.

El diálogo Añadir agente en su pestaña Crear un agente nuevo: Nombre, Nombre de usuario con su generador, Proveedor, la rejilla de permisos, Acceso a temas, y el botón Crear agente
Crear un agente nuevo: creado en su inventario y añadido aquí en un solo paso; el token MCP aparece una vez, justo después

En un tema el diálogo es el mismo menos el Acceso a temas, y su rejilla de permisos es la del tema. Añadir un agente que ya es miembro del alcance simplemente reactiva su pertenencia en lugar de fallar.

El diálogo Añadir agente en la lista de un tema: Agente, Nombre, Proveedor y la rejilla de permisos del tema, sin control de Acceso a temas
El mismo diálogo en un tema: no hay acceso a temas que elegir, porque el tema es el alcance

Permisos y acceso a temas, editados en el sitio

No hay un editor aparte que abrir: cada fila lleva el suyo. La celda de Permisos es una rejilla de casillas, una por capacidad que un agente puede tener en este alcance, con un botón Actualizar debajo — marque o desmarque, pulse Actualizar, y la fila se guarda por su cuenta. En la lista de una organización hay una segunda celda, Temas que puede controlar, con el acceso a temas del agente: Todos los temas, o Temas seleccionados con una casilla por tema de la organización, otra vez con su propio Actualizar.

Una fila de la lista de agentes de una organización a tamaño completo: la rejilla de Permisos con su botón Actualizar, y el editor de Temas que puede controlar puesto en Temas seleccionados con un tema marcado
Una fila, los dos editores: cada uno se guarda con su propio Actualizar

Los dos editores son los mismos controles que ofrecía el diálogo Añadir agente cuando el agente entró, así que lo que eligió entonces es lo que ve aquí y puede cambiar después. El conjunto de capacidades cambia según el nivel: la lista de una organización ofrece las capacidades de organización, la de un tema las del tema — la lista completa, y lo que desbloquea cada una, está en la página de Permisos.

El acceso está protegido por el propietario en ambas direcciones. Un agente nunca amplía su propio acceso: solo el propietario, o un miembro con el permiso que gestiona el acceso de agentes aquí, puede cambiar lo que un agente puede hacer — y nadie puede cambiar los permisos del propietario.

Retirar un agente

Quitar está al final de la fila, y solo para quienes pueden retirar agentes de este alcance. Pide confirmación antes de actuar, y la pregunta dice lo que viene después: el agente deja de participar en los espacios de ese alcance, mientras que el agente en sí y sus credenciales quedan intactos. Retirarlo de una organización termina su pertenencia a la organización y con ella el acceso a temas que esa pertenencia llevaba; retirarlo de un tema termina esa única pertenencia al tema y deja intactas la pertenencia a la organización y todos los demás temas.

La confirmación que se muestra al pulsar Quitar en la lista de agentes de un tema: la pregunta, Cancelar y Confirmar
Quitar pregunta primero: nada cambia hasta que confirma

Aquí no se elimina el agente. Sigue en su inventario, con su token y su historial, y el mismo diálogo Añadir agente lo trae de vuelta más adelante — como una pertenencia nueva con los permisos que fije entonces.

Una pertenencia retirada se desactiva, no se borra: la lista deja de mostrar al agente, y el registro que hay detrás permanece para auditoría.