Overview —
Bot Matrix
—
—
Mensajes recibidos
—
— comandos
Tool calls
—
— errores
Memoria (RSS)
—
heap —
Herramientas
—
—
Uptime
—
—
🌐 Servicios externos
ServicioURL / EndpointEstadoAcción
Cargando...
🩺 Estado de conectividad
Haz clic en "Ejecutar diagnóstico" para verificar todos los servicios.
🛡️ Plataforma SOC
Grafo de acción ↗
🧠 Agentes
🔧 Herramientas 0
NombreTipoDescripciónParámetros
Cargando...
🩺 Diagnóstico
Haz clic en "Ejecutar" para verificar todos los servicios.
📋 Logs en vivo
Nivel:
0 entradas
Sin logs disponibles.
⚙️ Configuración activa
Matrix
Modelos LLM
IDProveedorModeloMax tokens
APIs REST
IDBase URLAuthEndpoints
Servidores MCP
IDTransportEndpoint / Comando
⚡ Skills SOC Capacidades especializadas para análisis de seguridad
📖 Guía de inicio rápido
1

Registrar cuenta bot en matrix.org

Crea una cuenta nueva (separada de la tuya personal). Usa un nombre como mi-bot.

→ Registrarse en Element
2

O registrar en Synapse propio

register_new_matrix_user -c homeserver.yaml \
  -u mi-bot -p TU_PASSWORD --no-admin \
  http://localhost:8008
3

Verificar la cuenta

Inicia sesión en app.element.io con la cuenta bot para confirmar que funciona.

1

Método recomendado: API REST

curl -XPOST 'https://matrix.org/_matrix/client/v3/login' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "m.login.password",
    "user": "@mi-bot:matrix.org",
    "password": "TU_PASSWORD"
  }'

Copia el valor de access_token de la respuesta.

2

Verificar el token

curl 'https://matrix.org/_matrix/client/v3/account/whoami' \
  -H 'Authorization: Bearer syt_TU_TOKEN'

Debe responder con tu user_id. Error 401 = token inválido.

3

Alternativa: desde Element

Configuración → Seguridad y privacidad → Tokens de acceso → Mostrar token

1

Editar .env en la raíz del proyecto

MATRIX_HOMESERVER_URL=https://matrix.org
MATRIX_ACCESS_TOKEN=syt_tu_token_real
MATRIX_USER_ID=@mi-bot:matrix.org
ANTHROPIC_API_KEY=sk-ant-xxxxx
PORT=9099
2

Reiniciar el bot

Después de editar el entorno, reinicia para que tome los cambios:

# EasyPanel: botón Restart (env/config) · Rebuild (cambios de código)
# Docker:    docker compose restart bot

O usa el botón "Reiniciar bot" del dashboard.

3

Validar con diagnóstico

Ve a la sección Diagnóstico y ejecuta los checks.

1

Invitar al bot a una sala

En Element, crea una sala o usa una existente. Invita al bot por su User ID. Con autoJoin: true acepta automáticamente.

2

Primer comando

!ping

El bot debe responder Pong! 🟢

3

Mensajes directos (DM)

Abre un DM con el bot. En DMs no necesitas prefijo — cualquier mensaje se procesa directamente por el orquestador.

!pingVerifica que el bot responde
!helpLista todos los comandos disponibles
!ai <texto>Envía al orquestador (usa todos los agentes)
!agent <id> <texto>Fuerza un agente específico (ej: !agent analyst analiza esto)
!agentsLista los agentes configurados
!toolsLista herramientas disponibles (incluye MCP y APIs)
@bot <texto>Mención directa en cualquier sala
1

Agregar en config.yaml

apis:
  mi-api:
    baseUrl: https://api.ejemplo.com/v1
    auth:
      type: bearer
      tokenEnvVar: MI_API_TOKEN   # var de entorno con el token
    timeout: 10000
    endpoints:
      - name: listar_items
        description: Lista items activos
        method: GET
        path: /items
        queryParams: [status, limit]
      - name: crear_item
        description: Crea un nuevo item
        method: POST
        path: /items
2

Autorizar al agente

Agrega el nombre de la tool al allowedTools del agente en config.yaml:

agents:
  - id: collector
    allowedTools:
      - api_mi-api_listar_items
      - api_mi-api_crear_item
1

Servidor MCP local (stdio)

mcpServers:
  filesystem:
    transport: stdio
    command: npx
    args: ["-y", "@modelcontextprotocol/server-filesystem", "/ruta/permitida"]
2

Servidor MCP remoto (HTTP)

mcpServers:
  mi-mcp:
    transport: http
    url: https://mi-servidor.com/mcp
    headers:
      Authorization: "Bearer mi-token"
3

Las tools se descubren automáticamente

Al arrancar, el bot conecta al servidor MCP y registra todas sus tools como mcp_<id>_<toolname>. Aparecerán en la sección Herramientas con el badge mcp.

⚙️ Ajustes
Chatbots activos
Cargando...
⚠️ Requiere SYNAPSE_ADMIN_TOKEN en las variables de entorno del bot.
Obtén el token con: curl -X POST http://synapse:8008/_matrix/client/v3/login -d '{"type":"m.login.password","user":"admin","password":"TuPass"}'
Claves de API — Modelos de IA
Cargando...
Conexión Matrix
Cargando...
Define agentes, modelo LLM, system prompt y herramientas asignadas
Cargando...
Proveedores de IA: Anthropic Claude, OpenAI o endpoints compatibles
Cargando...
Un servidor MCP expone herramientas mcp_<id>_<tool> que los agentes pueden invocar
Cargando...
Cada API genera herramientas api_<id>_<endpoint> — asígnalas luego en Agentes
Cargando...
YAML válido · Guardar reinicia el bot para aplicar los cambios
🛡️ Plataforma SOC LangGraph · CTI · Shuffle SOAR · Email · LangSmith
⚡ Feature Flags
🧠 Modelos por rol de la cascada
💾 Memoria — KB de entidades y casos
🔌 Integraciones CTI · SOAR · Email
📊 Observabilidad — LangSmith
🗺️ Cascada de incidentes
triage→ enrich→ N1 · Haiku→ CTI/ N2 · Sonnet (ACH)→ N3 · Opus→ decide → HITL / email
N3 solo en incidentes materiales (<1% del volumen). El comportamiento real (memoria B0–B5, copiloto L1/L2, ruteo de postura) se ve arriba en los flags. Detalle: docs/ARQUITECTURA.md.
⚠️ Aprobaciones Pendientes
🔌 Conectores Integraciones activas y disponibles por plan
🔑 Licencia Estado del plan y capacidades habilitadas
📰 Novedades Versión actual y últimos cambios
🚀 Asistente de configuración Conecta tu servidor Matrix y pon en marcha tu primer agente
① Servidor Matrix
Homeserver + credenciales
② Crear agente
Perfil y configuración
③ Probar el bot
Verificar funcionamiento
Conectar servidor Matrix

Matrix AI Bots necesita conectarse a un homeserver Matrix con una cuenta de bot dedicada. Configura las siguientes variables de entorno antes de arrancar el contenedor.

VariableEjemploDescripción
MATRIX_HOMESERVER_URLhttps://matrix.miempresa.comURL base del homeserver
MATRIX_USER_ID@bot:miempresa.comUser ID del bot (MXID)
MATRIX_ACCESS_TOKENsyt_…Token de acceso (login o registration)
MATRIX_DEVICE_IDMATRIX_BOTDevice ID (opcional, para E2EE)
Obtener un token de acceso:
  1. Crea una cuenta de bot en tu homeserver (ej. Element Web)
  2. En Ajustes → Ayuda y acerca de → Acceso avanzado → Ver token de acceso
  3. Copia el token y guárdalo en MATRIX_ACCESS_TOKEN