Bots de Slack y Teams

Organization Bot tab: Slack connected, Teams, channel scope with #payments scoped to a team, and MCP tools

Lleva Archyl a las herramientas que tu equipo ya usa. Menciona @Archyl en Slack o Microsoft Teams y haz preguntas sobre la arquitectura de tu software — el modelo C4, los ADR, las dependencias, la propiedad y más — para obtener respuestas basadas en tus datos reales, directamente en el canal.

Descripción general

El bot se conecta por organización. Una vez que un administrador conecta un espacio de trabajo, cualquier persona en él puede preguntarle al bot mencionándolo. El bot responde con los permisos del administrador que lo conectó, y su alcance son los proyectos de tu organización.

De forma predeterminada, ese alcance es todos los proyectos de la organización. Un administrador puede limitar cualquier canal a un equipo o a un conjunto de proyectos — consulta Limitar un canal a un equipo o a proyectos más abajo.

El bot responde de dos maneras:

Modo Cuándo Lo que ves
Directo Ninguna clave API seleccionada Una única respuesta de IA construida a partir del contexto de tu arquitectura.
Agéntico (herramientas MCP) Hay una clave API seleccionada El bot llama a herramientas MCP en vivo para buscar información y actuar, y muestra los pasos que sigue (🔧 …) antes de la respuesta final.

Cambias entre ambos seleccionando una clave API en Organización → Bot → Herramientas MCP (consulta Activar las herramientas MCP más abajo).

Conectar Slack

  1. En Archyl, ve a Organización → Bot.
  2. Haz clic en Añadir a Slack. Se te llevará a Slack para autorizar la aplicación de Archyl y elegir un espacio de trabajo.
  3. Tras aprobar, vuelves a Archyl y el espacio de trabajo aparece en Conectado.
  4. En Slack, invita al bot a un canal y menciónalo:
    @Archyl ¿qué depende del servicio de pagos?

El bot responde en un hilo para mantener los canales ordenados. Menciónalo de nuevo (en el canal o dentro del hilo) para hacer una pregunta de seguimiento.

  • Editar vuelve a ejecutar la instalación de Slack (actualiza la conexión).
  • Desconectar elimina la integración.

Conectar Microsoft Teams

Teams usa un paquete de aplicación y un código de vinculación de un solo uso.

  1. En Archyl, ve a Organización → Bot y haz clic en Descargar app de Teams para obtener archyl-teams-app.zip.
  2. En Teams, instala la aplicación: Aplicaciones → Administrar tus aplicaciones → Cargar una aplicación personalizada, y selecciona el .zip. (Si no ves esa opción, un administrador de Teams debe permitir la carga de aplicaciones personalizadas o cargarla en el catálogo de aplicaciones de tu organización.)
  3. De vuelta en Archyl, haz clic en Conectar Teams. Obtendrás un código como @Archyl link 6GXH6NKL.
  4. En Teams, envía ese mensaje exacto al bot de Archyl (en un chat 1:1, simplemente link 6GXH6NKL). El bot responde ✅ Conectado a tu organización de Archyl.
  5. Ahora menciónalo con tus preguntas:
    @Archyl ¿qué equipo es propietario de la puerta de enlace de API?

El código de vinculación es válido durante 15 minutos y de un solo uso. Genera uno nuevo en cualquier momento desde la pestaña Bot.

Nota: los bots de Microsoft Teams requieren una cuenta profesional o educativa (Microsoft 365) — no funcionan con una cuenta personal de Microsoft.

Activar las herramientas MCP (modo agéntico)

De forma predeterminada, el bot responde directamente a partir del contexto de tu arquitectura. Para permitirle usar herramientas MCP en vivo — buscar proyectos por nombre, rastrear dependencias, crear ADR o documentación y más — dale una clave API:

  1. Crea una clave API en Perfil → Claves API (o reutiliza una existente).
  2. Ve a Organización → Bot → Herramientas MCP y selecciona esa clave.
  3. Eso es todo — la próxima vez que alguien mencione al bot, razonará sobre tu arquitectura con las herramientas del servidor MCP y mostrará cada acción que realiza antes de responder.

El alcance importa:

  • Una clave de lectura permite al bot buscar información pero no cambiar nada.
  • Una clave de escritura además le permite crear o actualizar elementos, ADR, documentación, etc. Elige una clave de escritura solo si quieres que el bot haga cambios.

Selecciona Ninguna en cualquier momento para desactivar el modo agéntico y volver a las respuestas directas.

Limitar un canal a un equipo o a proyectos

De forma predeterminada, cada canal ve todos los proyectos de su organización. A menudo es lo deseado, pero un canal #pagos normalmente no debería responder preguntas sobre la plataforma de préstamos.

Para limitarlo, vaya a Organización → Bot → Alcance del canal y haga clic en Limitar un canal:

  1. Qué ve el canal — un equipo, o uno o varios proyectos.
  2. Qué canal — elija la plataforma, dé un nombre al canal para la lista y haga clic en Obtener el comando.
  3. Pegue el comando — envíe @Archyl scope <código> en ese canal. El bot confirma, y el canal aparece en la lista en cuanto se aplica el alcance.

Los códigos son válidos 15 minutos y de un solo uso. Para volver a ampliar un canal, haga clic en Quitar junto a él en la lista.

¿Por qué un código y no un botón? El bot responde con los permisos del administrador que lo conectó y no puede saber quién habla en un canal. El código es la autorización: lo generó un administrador en Archyl, así que el alcance no puede cambiarlo cualquiera que simplemente escriba en el canal.

Algunas cosas que conviene saber:

  • El alcance por equipo sigue al equipo. Un proyecto añadido después a un equipo limitado queda cubierto automáticamente, sin volver a limitar el canal.
  • El alcance se aplica, no se sugiere. Rige cada llamada a herramienta y cada listado: un canal limitado no puede leer otro proyecto, ni siquiera si se lo piden por identificador.
  • Los ADR, documentos y contratos de API a nivel de organización siguen visibles: pertenecen a la organización, no a un proyecto.
  • El nombre es solo una etiqueta. El bot no tiene acceso a los nombres de los canales; el que escriba es lo que muestra la lista, y el vínculo es con el canal en el que pegue el comando.

Cómo funcionan los permisos

  • El bot responde con los permisos del administrador que conectó el espacio de trabajo, dentro del alcance de los proyectos de tu organización.
  • Un canal limitado solo ve los proyectos de su equipo o de su lista. Se aplica en cada llamada a herramienta y en cada listado, no se deja al prompt.
  • En modo agéntico, lo que el bot puede leer y cambiar se rige además por el alcance de la clave API seleccionada.
  • Cada pregunta cuenta para el uso de IA de tu organización, igual que el chat de la aplicación.

Consejos

  • Sé específico con los nombres. Puedes referirte a proyectos, sistemas, ADR y documentos por su nombre — el bot los asocia a los elementos correctos por ti.
  • Continúa en el hilo. Menciona al bot de nuevo para continuar una línea de preguntas.
  • El Markdown funciona de forma nativa. Las respuestas se formatean para cada plataforma (negrita, listas, enlaces, código).
  • Limita los canales compartidos. Restringe #pagos al equipo de pagos y la respuesta equivocada nunca llegará al canal equivocado (Limitar un canal a un equipo o a proyectos).

Próximos pasos