IA

Les funcions d'IA d'Antimatter utilitzen models que triïs: un proveïdor en la núvol o un servidor a la teva xarxa. No s'envia res enlloc fins que configureu un model. Aquesta pàgina cobreix les connexions de models, cada funció, les dades que envia i com desactivar-la.

Les funcions d'IA

"Compatible amb OpenAI" significa un servidor que ofereix la mateixa API HTTP que OpenAI. La majoria dels servidors de models que pots executar tu mateix ho fan (per exemple Ollama, vLLM, el servidor de llama.cpp, o servidors de Whisper i text a veu), així com molts proveïdors en la núvol i passarelles com LiteLLM o OpenRouter. No cal cap llicència per a cap d'aquestes funcions.

Les funcions integrades (reescriure, resums, traducció i lectura en veu alta) i els agents no necessiten cap aplicació: utilitzen les connexions de models que afegeixis a la Consola del sistema.

Connexions de models

Una connexió de model és un proveïdor d'IA que Antimatter pot cridar: la seva adreça, la seva clau i els seus models. L'afegiu un cop i després el trieu per a cada funció que hauria d'utilitzar-lo. Hi ha dos tipus:

• Connexions de tot el servidor, gestionades per administradors del sistema a la Consola del sistema › IA › Connexions de models. Només elles poden oferir les funcions integrades. Les aplicacions també les poden utilitzar, per a les persones autoritzades.
• Connexions de comunitat, que els administradors d'una comunitat afegixen per a la seva pròpia comunitat a la configuració de la comunitat (vegeu a continuació). Les aplicacions les utilitzen per a les persones de la comunitat. Mai serveixen les funcions integrades.

La secció IA de la Consola del sistema es mostra a les persones que poden gestionar les connexions de tot el servidor: administradors del sistema, de manera predeterminada. La seva pàgina Connexions de models (la mateixa adreça que abans, admin_console/ai/model_connections) enumera les connexions de tot el servidor i les de cada comunitat, després els agents de tot el servidor (vegeu Agents d'IA).

Afegeix una connexió

A Consola del sistema › IA › Connexions de models, sota Connexions de models, feu clic a Afegeix una connexió i, a continuació, ompliu el formulari:

Provar connexió comprova l'adreça i la clau: el servidor demana al punt d'accés els seus models, o envia un xat d'un sol token. Una adreça canviada es prova amb la clau desada només després de desar, o si escriviu la clau de nou. Feu clic a Afegeix connexió per desar.

El servidor fa les peticions per si mateix, per la qual cosa ha d'arribar a l'API: un servidor de models al mateix projecte de compose, a la vostra xarxa o a Internet. Les peticions sortents respecten les variables HTTP_PROXY i HTTPS_PROXY.

Si suprimiu una connexió, se'n perd la clau. Les funcions que l'utilitzaven deixen d'usar la IA fins que n'escolliu una altra.

Límits i pressupostos

Cada connexió té quatre límits. Si un camp és buit o 0, no hi ha cap límit.

• Peticions per minut i Per persona, peticions per minut. Cada servidor les compta per separat: un clúster de tres servidors deixa passar fins a tres vegades la taxa.
• Tokens per mes i Per persona, tokens per mes: pressupostos de tokens, per mes calendàric (UTC), comptats a la base de dades per a tot el clúster. Diferents peticions que s'executen al mateix moment poden superar lleugerament un pressupost.

Els límits per persona també s'apliquen a la reescriptura i als resums: es compten contra la persona que reescriu o que és la propietària del resum.

Ús

La llista mostra l'ús d'aquest mes de cada connexió. Ús obre els detalls: tokens d'entrada i de sortida, peticions, el pressupost mensual, l'ús per dia (UTC) i per ús (Reescriu, Resums, Traducció automàtica, Text a veu, Persones, a través d'aplicacions o una aplicació).

Cada crida que una persona o una aplicació fa a través d'una connexió també escriu un registre d'auditoria: qui, la connexió, l'ús, el model, el nombre de tokens i si ha funcionat, mai el que s'ha dit. Les funcions integrades només es compten a l'ús: la traducció, per si sola, fa una crida per missatge i per idioma.

Connexions de comunitat

Els administradors de la comunitat afegeixen les seves pròpies connexions a la configuració de la comunitat, a la pestanya IA, sota Connexions de models. El formulari és el mateix, sense Comunitats: una connexió de la comunitat només funciona als seus propis canals, per als seus propis membres, i el seu públic només pot nomenar els seus propis equips. Els rols amb el permís Gestiona les connexions de models també les poden gestionar. De manera predeterminada, els administradors de la comunitat en disposen.

La connexió d'una comunitat no pot arribar a adreces privades o de loopback (per exemple, un servidor Ollama a la vostra xarxa), llevat que Consola del sistema › Entorn › Desenvolupador › Permet connexions internes no fiables a (ServiceSettings.AllowedUntrustedInternalConnections) les llisti. Les connexions de tot el servidor sí que hi poden arribar.

Vegeu Configuració de la comunitat per al costat dels administradors de comunitat.

Servidors MCP

Un servidor MCP és un servei que ofereix eines a través del Model Context Protocol, que els agents poden utilitzar. Els servidors MCP s'enumeren sota les connexions de models, a Consola del sistema › IA › Connexions de models (de tot el servidor) o a la pestanya IA d'una comunitat (les seves pròpies), gestionats pels mateixos permisos que les connexions de models. Afegiu-ne un amb el seu:

El servidor MCP d'una comunitat no pot accedir a adreces internes llevat que Permet connexions internes no fiables a les permeti, com passa amb les connexions de models de la comunitat; l'adreça declarada pel propi servidor d'abast global sempre és accessible. Les sol·licituds MCP mai segueixen una redirecció. Canviar l'adreça o el tipus de compte d'un servidor tanca la sessió de tothom; eliminar-ne un fa oblidar la sessió iniciada de tothom.

La clau de xifratge

Les claus i les capçaleres addicionals de les connexions de models s'xifren a la base de dades (AES-256-GCM) amb una sola clau de xifrat. Una còpia de seguretat de la base de dades per si sola no les revela. El servidor cerca la clau en aquest ordre:

1. La variable AM_AI_ENCRYPTION_KEY: 32 bytes aleatoris, en base64. En crea un amb openssl rand -base64 32.
2. En cas contrari, el fitxer ai-encryption.key a l'arrel del directori de dades del servidor (FileSettings.Directory, ./data/ per defecte). El servidor el crea, només llegible per ell mateix, la primera vegada que una connexió el necessita. Les aplicacions, les exportacions i els arxius de fitxers no el poden llegir.

Quan cal establir la variable:

• En el fitxer compose del lloc. compose.yaml passa AM_AI_ENCRYPTION_KEY des de .env i manté el fitxer de la clau al volum data quan la variable és buida. És millor establir la variable: la còpia de seguretat de .env llavors conté la clau, separada de la base de dades. Afegiu-la a .env i executeu docker compose up -d:

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

  Si el servidor ja ha creat el seu fitxer de clau, poseu la clau que conté a .env en lloc d'una de nova, perquè les claus desades continuïn sent llegibles: docker compose exec antimatter cat /antimatter/data/ai-encryption.key la mostra.
• Un clúster els fitxers del qual estan a S3. Els seus servidors no comparteixen cap directori, així que el servidor no crea el fitxer: establiu la mateixa variable en cada servidor. Fins que no s'estableixi, les connexions no poden desar claus.
• Amb l'arxiu de la versió o els paquets, el fitxer està a data/ (/var/lib/antimatter/data per als paquets). Podeu mantenir-lo allà, o establir la variable al vostre fitxer d'entorn.

Per canviar la clau, establiu la nova a AM_AI_ENCRYPTION_KEY i l'antiga a AM_AI_ENCRYPTION_PREVIOUS_KEYS (varies claus separades per comes): les claus desades amb l'antiga encara es poden llegir. La clau d'una connexió s'xifra amb la nova clau quan la torneu a escriure. Mantingueu la clau antiga a la llista fins que hagueu tornat a escriure la clau de totes les connexions.

Les funcions integrades

A Consola del sistema › IA › Funcions integrades, tria per a cada funció una connexió de tot el servidor i el seu model, o bé Desactivat. Una funció sense connexió no utilitza IA. Carrega els models llista tots els models de la connexió; per defecte, cada funció utilitza el model de xat de la connexió.

Cada configuració té una clau ConnectionId i una clau Model, per exemple AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID). Un Model buit utilitza el model per defecte de la connexió.

Les funcions integrades utilitzen els límits de la connexió, però no el seu públic: tothom que pot utilitzar la funció pot utilitzar la seva connexió. Una connexió que requereix atenció, o que s'ha suprimit, fa que la funcioni falli fins que en triïs una altra: la pàgina ho indica.

Agents d'IA

Un agent és un compte que les persones mencionen o al qual envien missatges com si fos un/a company/a, mostrat amb l'etiqueta AGENT. Els agents formen part del servidor. N'hi ha de dos tipus:

• Integrat: Antimatter respon per l'agent quan algú el menciona, li envia un missatge o respon als seus fils, utilitzant una connexió de model i les instruccions de l'agent. Respon com la persona que pregunta, amb els seus drets: el seu accés a la connexió, i els seus límits i pressupost.
• Agent extern: un programa en un altre lloc (un agent de codificació en un projecte, per exemple) inicia sessió amb el testimoni de l'agent i respon com ho faria una persona. Antimatter no respon per ell. Consulta Agents a la guia per a desenvolupadors.

Els administradors del sistema gestionen els agents d'abast global a Consola del sistema › IA › Connexions de models, per sota de les connexions de models. Els administradors d'una comunitat gestionen els seus propis agents a la pestanya IA de la configuració de la comunitat, per sota de les connexions de models (vegeu Configuració de la comunitat). Ningú més pot crear agents.

Afegeix un agent

A Consola del sistema › IA › Connexions de models (o a la pestanya IA d'una comunitat), feu clic a Afegeix un agent i, a continuació, ompliu el formulari:

Fes clic a Afegeix agent. Un agent de comunitat s'uneix a la seva comunitat. Cada agent de la llista mostra la seva connexió i el seu model (o "Extern"), si està desactivat i què requereix la teva atenció. Des de la llista pots editar un agent (també la seva imatge), activar-lo o desactivar-lo (ningú pot parlar amb un agent desactivat) o eliminar-lo: el seu compte es desactiva i la seva configuració s'oblida, però els seus missatges es conserven.

Eines

El commutador Eines del formulari de l'agent activa les eines per a l'agent i, a continuació, ofereix, per a cada font (les eines pròpies d'Antimatter, les de cada aplicació en execució i les de cada servidor MCP disponible en l'àmbit de l'agent): Desactivat, Tot o Seleccionades, i Les seves lectures s'executen sense preguntar. Les eines sempre actuen com la persona que ha fet la pregunta, amb els seus propis drets, mai com l'agent.

• Una lectura que la política de l'agent permet executar per si sola s'executa immediatament. Qualsevol altra crida (qualsevol escriptura i una lectura no configurada per executar-se per si sola) espera la persona: es mostra a la resposta de l'agent amb Confirma i Rebutja, els arguments exactes i un termini per respondre; només aquesta persona pot respondre, i l'agent, l'eina i l'accés de la persona es tornen a comprovar quan confirma. Una crida rebutjada no s'executa, i l'agent no en diu res més.
• Una eina MCP compta com a lectura només quan el seu servidor la marca com a tal; tota la resta és una escriptura. Un compte compartit (vegeu Servidors MCP) només ofereix les eines d'aquell servidor que fan lectures.
• Les opcions d'eines pròpies d'una persona, a la configuració del xat d'IA, són una preferència per a tots els agents: només poden restringir el que la política de l'agent permet, mai ampliar-ho.
• Les eines pròpies d'Antimatter, de moment: cercar missatges, llegir un fil, llegir un canal, buscar algú i publicar un missatge, que sempre necessita confirmació.
• Cada crida d'eina es registra al registre d'auditoria: qui, l'eina, l'agent, on, com es va decidir i el resultat, així com la mida i un hash dels arguments, mai el seu contingut.

On responen els agents

• Un agent integrat respon a un missatge que el menciona (fins a tres agents per missatge), a un missatge en un missatge directe amb ell i a una resposta en un fil que ha iniciat o en el qual se li ha preguntat i que no menciona ningú més. Respon al fil del missatge.
• Una persona que no pot parlar amb ell rep un avís que només veu ella: "@agent no està disponible per a tu aquí."
• Els agents no responen a bots, aplicacions, webhooks ni a altres agents.
• Cada resposta es dona una sola vegada, per un servidor d'un clúster.

L'aplicació de xat amb IA

L'aplicació de xat d'IA (id mattermost-ai, activada per defecte) és el panell lateral on les persones parlen amb els agents que poden utilitzar: mostra les seves converses amb els agents i ofereix resums del canal que estan llegint. També afegeix les accions d'IA del menú del missatge (Resumeix el fil, Troba elements d'acció, Troba preguntes obertes), el menú Pregunta a la IA de la línia de nous missatges i l'opció Crea un resum de la reunió de les trucades, que consulten l'agent de la persona a través del servidor i reben resposta en el seu missatge directe amb ell. Quan no hi ha cap agent per oferir, el seu panell envia els administradors a Consola del sistema › IA › Connexions de models, o un administrador de la comunitat a la pestanya d'IA de la seva comunitat.

L'aplicació encara té la seva pròpia configuració, ara a Consola del sistema › IA › Aplicació de xat d'IA (la pàgina de connectors per a ella ha desaparegut; la vella adreça redirigeix), amb els seus propis Serveis d'IA, per a les funcionalitats que encara són seves: Reacciona per mi, cerca d'IA, indicacions personalitzades, les respostes automàtiques dels canals configurats per a això i els resums automàtics de les transcripcions de les trucades. La seva Cerca d'incorporacions (experimental, desactivada) alimenta la cerca d'IA: necessita PostgreSQL amb l'extensió pgvector i un model d'incorporacions, i envia tots els missatges al model d'incorporacions, inclosos els canals privats i els missatges directes. A DEBUG, Sortida de traça (desactivada, registres del servidor o un punt final d'OpenTelemetry) i Activa el registre de l'ús de tokens (escriu a logs/agents/token_usage.log) ajuden a trobar problemes.

Veu a text: transcripcions i subtítols de trucades

Les trucades es poden transcriure, amb subtítols en directe, mitjançant un servidor de reconeixement de veu a text que ofereix un punt final /v1/audio/transcriptions compatible amb OpenAI. La configuració es troba a Trucades i veu. Amb Resumeix les transcripcions activat, l'agent predeterminat de l'aplicació de xat amb IA també publica un resum de cada transcripció. Les persones també poden demanar-ne un al seu propi agent amb Crea un resum de la reunió.

Text a veu: llegeix en veu alta

Amb el text a veu activat, el menú de cada missatge inclou Llegeix en veu alta: el servidor envia el text del missatge a una API de text a veu i reprodueix l'àudio. La configuració es troba a Consola del sistema › Integracions › Text a veu:

Per utilitzar una connexió de model en lloc de l'adreça i la clau anteriors, trieu-la per a Text a veu a IA › Funcions integrades. La pàgina indica llavors que els missatges es llegeixen en veu alta amb aquesta connexió: URL base de l'API i Clau d'API no s'utilitzen, Veu encara s'utilitza, i també Model quan la connexió no especifica cap model. Llegeix els missatges en veu alta ha de continuar activat.

Abans d'enviar-lo, el servidor elimina els blocs de codi, els enllaços, els codis d'emoji i el format, i conserva com a màxim 4000 caràcters. Sol·licita àudio MP3 i conserva els darrers 64 resultats a la memòria, de manera que un missatge que es llegeix dues vegades només s'envia una.

Traducció automàtica

La traducció automàtica mostra els missatges d'un canal en la llengua pròpia de cada lector. Configureu-la a Consola del sistema › Configuració del lloc › Localització, sota Traducció automàtica:

Cada proveïdor té els seus camps propis:

• Connexió de model: una connexió a nivell de servidor i el seu model, la mateixa configuració que Traducció automàtica a IA › Funcions integrades (AISettings.AutoTranslation). Un model de traducció dedicat és ràpid i precís; un LLM general també funciona.
• LibreTranslate: Punt d’accés de l’API de LibreTranslate i Clau d’API de LibreTranslate (AutoTranslationSettings.LibreTranslate.URL, .APIKey). Un servidor de LibreTranslate es pot executar a la vostra pròpia xarxa.
• API compatible amb OpenAI: URL base de l'API (fins a /v1 inclòs; el servidor n'utilitza el punt d'accés de completaments de xat), Model i Clau d'API (AutoTranslationSettings.OpenAI.URL, .Model, .APIKey). Funciona bé un petit model de traducció executat localment.
• Servei de l'aplicació de xat d'IA (més antic): el proveïdor dels servidors configurats abans de la 0.9.0, que utilitzaven un servei de l'aplicació Agents. Ja no necessita l'aplicació: tradueix amb la connexió triada per a la traducció automàtica a IA › Funcions integrades, o bé amb la connexió copiada del servei de l'aplicació durant la actualització. Canvia a Connexió de model mou la configuració al proveïdor recomanat.

Quan està activat, els administradors de canal activen la traducció per a un canal a la seva configuració (Traducció automàtica), i cada membre pot desactivar-la des del menú del canal (Tradueix els missatges). En missatges directes i de grup, qualsevol membre pot activar-la; amb la restricció activada, la traducció no hi està disponible. Els missatges traduïts mostren «Traduït de…» amb un enllaç a l'original.

El codi, els enllaços, les mencions i els emoji es substitueixen per marcadors abans d'enviar el text i es restitueixen després.

Quins dades van on

Per mantenir-ho tot a la vostra xarxa, apunteu cada funció a servidors que executeu vosaltres mateixos. Amb un proveïdor en la núvol, reviseu les seves condicions de retenció de dades i informeu els vostres usuaris de quines funcions envien els seus missatges cap a l'exterior.

Desactivar la IA

No hi ha un únic interruptor: cada funció en té el seu propi.

• Reescriptures i resums: configura-los a Desactivat a Consola del sistema › IA › Funcions integrades. La gent continua llegint els resums que ja té.
• Connexions de models: suprimiu una connexió per aturar-ne tot l'ús. Sense cap connexió, ni les funcions integrades ni les aplicacions poden utilitzar la IA a través del servidor.
• Agents: desactiveu o elimineu cada agent a la Consola del sistema › IA › Connexions de models i a les pestanyes d'IA de les comunitats. Desactivar l'aplicació de xat d'IA només n'elimina el panell lateral i les seves pròpies funcionalitats (incloses les resums de les trucades): les persones encara poden mencionar o enviar missatges als agents.
• Transcripció i subtítols: AM_CALLS_ENABLE_TRANSCRIPTIONS=false i AM_CALLS_ENABLE_LIVE_CAPTIONS=false (els valors per defecte).
• Llegeix en veu alta: desactiveu Llegeix els missatges en veu alta (AM_TEXTTOSPEECHSETTINGS_ENABLE=false, el valor per defecte), independentment de si utilitza una connexió o no.
• Traducció: desactiveu la traducció automàtica (AM_AUTOTRANSLATIONSETTINGS_ENABLE=false, el valor per defecte).

Desactivar l'aplicació de xat d'IA no desactiva les altres funcionalitats: aquestes utilitzen connexions de models o les seves pròpies APIs.