IA

Las funciones de IA de Antimatter utilizan modelos que tú eliges: un proveedor en la nube o un servidor en tu propia red. No se envía nada a ningún lugar hasta que configures un modelo. Esta página trata sobre las conexiones de modelos, cada función, los datos que envía y cómo desactivarla.

Las funciones de IA

«Compatible con OpenAI» significa un servidor que ofrece la misma API HTTP que OpenAI. La mayoría de los servidores de modelos que puedes ejecutar tú mismo lo hacen (por ejemplo, Ollama, vLLM, el servidor de llama.cpp, o servidores de Whisper y de texto a voz), al igual que muchos proveedores en la nube y pasarelas como LiteLLM u OpenRouter. No se necesita ninguna licencia para ninguna de estas funciones.

Las funciones integradas (reescribir, resúmenes, traducción y lectura en voz alta) y los agentes no requieren ninguna aplicación: utilizan las conexiones de modelos que añadas en la Consola de sistema.

Conexiones de modelos

Una conexión de modelos es un proveedor de IA al que Antimatter puede llamar: su dirección, su clave y sus modelos. La añades una vez y luego la seleccionas para cada función que deba utilizarla. Hay dos tipos:

• Conexiones a nivel de servidor, gestionadas por administradores de sistema en Consola de sistema › IA › Conexiones de modelos. Solo estas pueden servir a las funciones integradas. Las aplicaciones también pueden usarlas, para las personas autorizadas.
• Conexiones de comunidad, que los administradores de una comunidad añaden para su propia comunidad en los ajustes de la comunidad (consulta más abajo). Las aplicaciones las usan para las personas de la comunidad. Nunca sirven a las funciones integradas.

La sección IA de la Consola de sistema muestra las conexiones de todo el servidor a las personas que pueden gestionarlas: los administradores del sistema, de forma predeterminada. Su página Conexiones de modelos (la misma dirección de antes, admin_console/ai/model_connections) enumera las conexiones de todo el servidor y las de cada comunidad, y después los agentes de todo el servidor (consulta Agentes de IA).

Añadir una conexión

En Consola de sistema › IA › Conexiones de modelos, bajo Conexiones de modelos, haz clic en Añadir una conexión y rellena el formulario:

Probar conexión verifica la dirección y la clave: el servidor solicita al endpoint sus modelos o envía un chat de un solo token. Una dirección modificada se prueba con la clave guardada solo después de guardar, o si vuelves a escribir la clave. Haz clic en Añadir conexión para guardar.

El servidor realiza las solicitudes por sí mismo, por lo que debe poder acceder a la API: un servidor de modelos en el mismo proyecto de compose, en tu red o en Internet. Las solicitudes salientes respetan las variables HTTP_PROXY y HTTPS_PROXY.

Al eliminar una conexión, se olvida su clave. Las funciones que la utilizaban dejan de usar IA hasta que selecciones otra conexión.

Límites y presupuestos

Cada conexión tiene cuatro límites. Vacío o 0 significa sin límite.

• Solicitudes por minuto y Por persona, solicitudes por minuto. Se cuentan por separado en cada servidor: un clúster de tres servidores permite hasta tres veces la tasa.
• Tokens por mes y Por persona, tokens por mes: presupuestos de tokens, por mes natural (UTC), contados en la base de datos para todo el clúster. Varias solicitudes ejecutadas al mismo momento pueden superar ligeramente un presupuesto.

Los límites por persona también se aplican a la reescritura y a los resúmenes: se contabilizan contra la persona que reescribe o la persona propietaria del resumen.

Uso

La lista muestra el uso de cada conexión este mes. Uso abre los detalles: tokens de entrada y salida, solicitudes, el presupuesto mensual, el uso por día (UTC) y por tipo de uso (Reescribir, Resúmenes, Traducción automática, Texto a voz, Personas, a través de apps o una app).

Cada llamada que una persona o una app realiza a través de una conexión también escribe un registro de auditoría: quién, la conexión, el uso, el modelo, los conteos de tokens y si funcionó, nunca el contenido de lo dicho. Las funciones integradas solo se contabilizan en el uso: la traducción sola realiza una llamada por mensaje e idioma.

Conexiones de la comunidad

Los administradores de la comunidad añaden sus propias conexiones en la configuración de la comunidad, en la pestaña IA, bajo Conexiones de modelos. El formulario es el mismo, sin Comunidades: la conexión de una comunidad solo funciona en sus propios canales, para sus propios miembros, y su audiencia solo puede nombrar sus propios equipos. Los roles con el permiso Gestionar conexiones de modelos también pueden gestionarlas. De forma predeterminada, los administradores de la comunidad lo tienen.

La conexión de una comunidad no puede alcanzar direcciones privadas o de bucle invertido (un servidor Ollama en tu red, por ejemplo), a menos que Consola de sistema › Entorno › Desarrollo › Permitir conexiones internas no son de confianza (ServiceSettings.AllowedUntrustedInternalConnections) las liste. Las conexiones a nivel de servidor sí pueden.

Consulta Configuración de la comunidad para ver el lado de los administradores de la comunidad.

Servidores MCP

Un servidor MCP es un servicio que ofrece herramientas a través del Protocolo de Contexto del Modelo, que los agentes pueden usar. Los servidores MCP se listan bajo las conexiones de modelos, en Consola de sistema › IA › Conexiones de modelos (a nivel de servidor) o en la pestaña IA de una comunidad (su propia), gestionados por los mismos permisos que las conexiones de modelos. Añade uno con su:

El servidor MCP de una comunidad no puede alcanzar direcciones internas a menos que Permitir conexiones internas no son de confianza lo permita, como con las conexiones de modelos de la comunidad; la dirección declarada por el propio servidor a nivel de servidor siempre es alcanzable. Las solicitudes MCP nunca siguen una redirección. Cambiar la dirección o el tipo de cuenta de un servidor cierra la sesión de todos; eliminar uno olvida el inicio de sesión de todos.

La clave de cifrado

Las claves y los encabezados adicionales de las conexiones de modelos se cifran en la base de datos (AES-256-GCM) con una única clave de cifrado. Una copia de seguridad de la base de datos por sí sola no los revela. El servidor busca la clave en este orden:

1. La variable AM_AI_ENCRYPTION_KEY: 32 bytes aleatorios, en base64. Puede generarla con openssl rand -base64 32.
2. En caso contrario, el archivo ai-encryption.key en la raíz del directorio de datos del servidor (FileSettings.Directory, ./data/ por defecto). El servidor lo crea, legible solo por él mismo, la primera vez que una conexión lo necesite. Las aplicaciones, las exportaciones y los archivos de archivo no pueden leerlo.

Cuándo establecer la variable:

• Con el archivo compose del sitio. compose.yaml pasa AM_AI_ENCRYPTION_KEY desde .env y mantiene el archivo de clave en el volumen data cuando la variable está vacía. Es mejor establecer la variable: la copia de seguridad de .env contendrá entonces la clave, por separado de la base de datos. Añádala a .env y ejecute docker compose up -d:

  echo "AM_AI_ENCRYPTION_KEY=$(openssl rand -base64 32)" >> .env

  Si el servidor ya ha creado su archivo de clave, ponga la clave que contiene en .env en su lugar, para que las claves guardadas sigan siendo legibles: docker compose exec antimatter cat /antimatter/data/ai-encryption.key la imprime.
• Un clúster cuyos archivos están en S3. Sus servidores no comparten ningún directorio, por lo que el servidor no crea el archivo: establezca la misma variable en cada servidor. Hasta que se establezca, las conexiones no pueden guardar claves.
• Con el archivo de la versión o los paquetes, el archivo está en data/ (/var/lib/antimatter/data para los paquetes). Puede dejarlo allí o establecer la variable en su archivo de entorno.

Para cambiar la clave, establezca la nueva en AM_AI_ENCRYPTION_KEY y la anterior en AM_AI_ENCRYPTION_PREVIOUS_KEYS (varias claves separadas por comas): las claves guardadas con la anterior siguen siendo legibles. La clave de una conexión se cifra con la nueva clave cuando la vuelve a introducir. Mantenga la clave anterior en la lista hasta que se hayan vuelto a introducir las claves de todas las conexiones.

Las funciones integradas

En Consola de sistema › IA › Funciones integradas, seleccione una conexión y un modelo para cada función en todo el servidor, o Apagado. Una función sin conexión no utiliza IA. Cargar modelos muestra todos los modelos de la conexión; de forma predeterminada, cada función utiliza el modelo de chat de la conexión.

Cada configuración tiene una clave ConnectionId y una clave Model, por ejemplo AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID). Un valor vacío en Model utiliza el modelo predeterminado de la conexión.

Las funciones integradas utilizan los límites de la conexión, pero no su audiencia: cualquier persona que pueda usar la función puede usar su conexión. Una conexión que requiera atención o que haya sido eliminada hace que la función falle hasta que se seleccione otra: la página lo indica.

Agentes de IA

Un agente es una cuenta que las personas mencionan o a la que envían mensajes como si fuera un colega, mostrada con una etiqueta AGENTE. Los agentes forman parte del servidor. Hay dos tipos:

• Integrado: Antimatter responde por el agente cuando alguien lo menciona, le envía un mensaje o responde en sus hilos, utilizando una conexión de modelo y las instrucciones del agente. Responde como la persona que pregunta, con sus derechos: su acceso a la conexión, y sus límites y presupuesto.
• Agente externo: un programa externo (un agente de codificación en un proyecto, por ejemplo) inicia sesión con el token del agente y responde como lo haría una persona. Antimatter no responde por él. Consulte Agentes en la guía para desarrolladores.

Los administradores del sistema gestionan los agentes a nivel de servidor en Consola de sistema › IA › Conexiones de modelos, debajo de las conexiones de modelos. Los administradores de una comunidad gestionan sus propios agentes en la pestaña IA de su configuración, debajo de sus conexiones de modelos (consulte Configuración de la comunidad). Nadie más puede crear agentes.

Añadir un agente

En Consola de sistema › IA › Conexiones de modelos (o en la pestaña IA de una comunidad), haga clic en Añadir un agente y complete el formulario:

Haga clic en Añadir agente. El agente de una comunidad se une a su comunidad. Cada agente en la lista muestra su conexión y modelo (o «Externo»), si está apagado y qué requiere su atención. Desde la lista puede editar un agente (incluida su imagen), apagarlo o encenderlo (nadie puede hablar con un agente apagado) o eliminarlo: su cuenta se desactiva y su configuración se olvida, pero sus mensajes permanecen.

Herramientas

El interruptor Herramientas del formulario del agente activa las herramientas para el agente y, a continuación, ofrece, para cada fuente (las herramientas propias de Antimatter, las de cada aplicación en ejecución y las de cada servidor MCP disponible en el ámbito del agente): Apagado, Todo o Seleccionadas, y Sus lecturas se ejecutan sin preguntar. Las herramientas siempre actúan como la persona que realizó la solicitud, con sus propios permisos, nunca como el agente.

• Una lectura que la política del agente permite ejecutar por sí sola se ejecuta inmediatamente. Cualquier otra llamada (cualquier escritura y cualquier lectura no configurada para ejecutarse por sí sola) espera a la persona: se muestra en la respuesta del agente con los botones Confirmar y Rechazar, los argumentos exactos y un plazo para responder; solo esa persona puede responder, y al confirmar se vuelven a verificar el agente, la herramienta y el acceso de la persona. Una llamada rechazada no se ejecuta y el agente no dice nada más al respecto.
• Una herramienta MCP se considera una lectura solo cuando su servidor la marca como tal; todo lo demás es una escritura. Una cuenta compartida (consulte Servidores MCP) solo ofrece las herramientas de lectura de ese servidor.
• Las elecciones de herramientas propias de una persona, en su configuración de chat de IA, son una preferencia para todos los agentes: solo pueden restringir lo que la política del agente permite, nunca ampliarlo.
• Las herramientas propias de Antimatter, por ahora: buscar mensajes, leer un hilo, leer un canal, buscar a alguien y publicar un mensaje, lo cual siempre requiere confirmación.
• Cada llamada a una herramienta se escribe en el registro de auditoría: quién, la herramienta, el agente, dónde, cómo se decidió y el resultado, así como el tamaño y un hash de los argumentos, nunca su contenido.

Dónde responden los agentes

• Un agente integrado responde a un mensaje que lo menciona (hasta tres agentes por mensaje), a un mensaje en un mensaje directo con él y a una respuesta en un hilo que inició o en el que se le preguntó y que no menciona a nadie más. Responde en el hilo del mensaje.
• Una persona que no puede hablar con él recibe un aviso visible solo para ella: «@agent no está disponible para ti aquí».
• Los agentes no responden a bots, aplicaciones, webhooks ni entre ellos.
• Cada respuesta se da una sola vez, por un servidor de un clúster.

La aplicación de chat de IA

La aplicación de chat de IA (id mattermost-ai, activada de forma predeterminada) es el panel lateral donde las personas hablan con los agentes que pueden utilizar: enumera sus conversaciones con los agentes y ofrece resúmenes del canal que se está leyendo. También añade las acciones de IA del menú del mensaje (Resumir hilo, Buscar elementos de acción, Buscar preguntas abiertas), el menú Preguntar a la IA de la línea de mensajes nuevos y la opción Crear resumen de la reunión de las llamadas, que consultan al agente de la persona a través del servidor y cuyas respuestas se envían en su mensaje directo con él. Cuando no hay ningún agente disponible, su panel redirige a los administradores a Consola de sistema › IA › Conexiones de modelos, o a un administrador de la comunidad a la pestaña de IA de su comunidad.

La aplicación mantiene sus propios ajustes, ahora en Consola de sistema › IA › Aplicación de chat de IA (la página de complementos para ella ha desaparecido; la antigua dirección redirige), con sus propios Servicios de IA, para las funciones que siguen siendo propias de ella: Reaccionar por mí, búsqueda con IA, indicaciones personalizadas, las respuestas automáticas de los canales configurados para ello y los resúmenes automáticos de las transcripciones de llamadas. Su Búsqueda de incrustaciones (experimental, desactivada) impulsa la búsqueda con IA: requiere PostgreSQL con la extensión pgvector y un modelo de incrustación, y envía todos los mensajes al modelo de incrustación, incluidos los canales privados y los mensajes directos. En DEBUG, Salida de seguimiento (desactivada, registros del servidor o un endpoint de OpenTelemetry) y Activar registro de uso de tokens (escrito en logs/agents/token_usage.log) ayudan a encontrar problemas.

Conversión de voz a texto: transcripciones y subtítulos de llamadas

Las llamadas pueden transcribirse, con subtítulos en vivo, mediante un servidor de reconocimiento de voz que ofrece un endpoint /v1/audio/transcriptions compatible con OpenAI. La configuración se encuentra en Llamadas y voz. Con Resumir transcripciones activado, el agente predeterminado de la aplicación de chat de IA también publica un resumen de cada transcripción. Las personas también pueden solicitar uno a su propio agente mediante Crear resumen de la reunión.

Texto a voz: leer en voz alta

Con el texto a voz activado, el menú de cada mensaje incluye Leer en voz alta: el servidor envía el texto del mensaje a una API de texto a voz y reproduce el audio. La configuración se encuentra en Consola de sistema › Integraciones › Texto a voz:

Para usar una conexión de modelos en lugar de la dirección y la clave anteriores, selecciónela para Texto a voz en IA › Funciones integradas. La página indicará entonces que los mensajes se leen en voz alta con esa conexión: no se usan URL base de la API ni Clave de API, pero sí se usa Voz, y también Modelo si la conexión no especifica ningún modelo. Leer mensajes en voz alta debe seguir activado.

Antes de enviar, el servidor elimina bloques de código, enlaces, códigos de emoji y formato, y conserva como máximo 4000 caracteres. Solicita audio en MP3 y conserva los últimos 64 resultados en memoria, por lo que un mensaje leído dos veces solo se envía una vez.

Traducción automática

La traducción automática muestra los mensajes de un canal en el idioma propio de cada lector. Configúrela en Consola de sistema › Configuración del Sitio › Idiomas, bajo Traducción automática:

Cada proveedor tiene sus propios campos:

• Conexión de modelos: una conexión y su modelo a nivel de servidor, la misma configuración que Traducción automática en IA › Funciones integradas (AISettings.AutoTranslation). Un modelo de traducción dedicado es rápido y preciso; un LLM general también funciona.
• LibreTranslate: Punto de conexión API de LibreTranslate y Clave API de LibreTranslate (AutoTranslationSettings.LibreTranslate.URL, .APIKey). Un servidor de LibreTranslate puede ejecutarse en su propia red.
• API compatible con OpenAI: URL base de la API (hasta e incluyendo /v1; el servidor usa su endpoint de completado de chat), Modelo y Clave de API (AutoTranslationSettings.OpenAI.URL, .Model, .APIKey). Un pequeño modelo de traducción ejecutado localmente funciona bien.
• Servicio de la app de chat de IA (anterior): el proveedor de servidores configurados antes de la versión 0.9.0, que utilizaban un servicio de la app Agentes. Ya no necesita la app: traduce con la conexión seleccionada para la traducción automática en IA › Funciones integradas, o bien con la conexión copiada del servicio de la app durante la actualización. Cambiar a Conexión de modelos mueve la configuración al proveedor recomendado.

Una vez activado, los administradores de canal activan la traducción para un canal en su configuración (Traducción automática), y cada miembro puede desactivarla desde el menú del canal (Traducir mensajes). En los mensajes directos y de grupo, cualquier miembro puede activarla; si la restricción está activada, la traducción no está disponible allí. Los mensajes traducidos muestran «Traducido de …» con un enlace al original.

El código, los enlaces, las menciones y los emojis se reemplazan por marcadores antes de enviar el texto, y se restauran después.

Qué datos van a dónde

Para mantener todo en tu red, dirige cada función a servidores que ejecutes tú mismo. Con un proveedor en la nube, revisa sus términos de retención de datos y comunica a tus usuarios qué funciones envían sus mensajes hacia el exterior.

Desactivar la IA

No hay un solo interruptor: cada función tiene el suyo.

• Reescritura y resúmenes: desactívelos (Apagado) en Consola de sistema › IA › Funciones integradas. Las personas siguen leyendo los resúmenes que ya tienen.
• Conexiones de modelos: elimine una conexión para detener todos sus usos. Sin ninguna conexión, ni las funciones integradas ni las aplicaciones pueden usar la IA a través del servidor.
• Agentes: desactive o elimine cada agente en Consola de sistema › IA › Conexiones y agentes y en las pestañas IA de las comunidades. Deshabilitar la aplicación de chat de IA solo elimina su panel lateral y sus propias funciones (incluidos los resúmenes de llamadas): las personas aún pueden mencionar o enviar mensajes a los agentes.
• Transcripción y subtítulos: AM_CALLS_ENABLE_TRANSCRIPTIONS=false y AM_CALLS_ENABLE_LIVE_CAPTIONS=false (los valores predeterminados).
• Leer en voz alta: desactive Leer mensajes en voz alta (AM_TEXTTOSPEECHSETTINGS_ENABLE=false, valor predeterminado), independientemente de si utiliza una conexión.
• Traducción: desactiva la traducción automática (AM_AUTOTRANSLATIONSETTINGS_ENABLE=false, el valor predeterminado).

Deshabilitar la aplicación de chat de IA no desactiva las otras funciones: estas utilizan conexiones de modelos o sus propias APIs.