AI

Antimatters AI-funktioner bruger de modeller, du vælger: en cloududbyder eller en server på dit eget netværk. Der sendes intet nogen steder, før du har konfigureret en model. Denne side dækker modelforbindelser, hver funktion, de data, den sender, og hvordan du slår den fra.

AI-funktionerne

"OpenAI-kompatibel" betyder en server, der tilbyder den samme HTTP-API som OpenAI. De fleste modelservere, du kan køre selv, gør det (for eksempel Ollama, vLLM, llama.cpp's server eller Whisper og tekst-til-tale-servere), ligesom mange cloududbydere og gateways som LiteLLM eller OpenRouter gør. Der kræves ingen licens for nogen af disse funktioner.

De indbyggede funktioner (omformulering, opsummeringer, oversættelse og oplæsning) og agenterne kræver ingen app: de bruger de modelforbindelser, du tilføjer i Systemkonsollen.

Modelforbindelser

En modelforbindelse er en AI-udbyder, som Antimatter kan kontakte: dens adresse, dens nøgle og dens modeller. Du tilføjer den én gang og vælger den derefter til hver funktion, der skal bruge den. Der er to typer:

• Serverdækkende forbindelser, administreret af systemadministratorer i Systemkonsol › AI › Modelforbindelser. Kun de kan betjene de indbyggede funktioner. Apps kan også bruge dem, for de personer, der har tilladelse til det.
• Teamforbindelser, som et teams administratorer tilføjer til deres eget team i teamets indstillinger (se nedenfor). Apps bruger dem for teamets brugere. De betjener aldrig de indbyggede funktioner.

Afsnittet AI i Systemkonsollen vises for de personer, der må administrere serverdækkende forbindelser: systemadministratorer som standard. Siden Modelforbindelser (samme adresse som før, admin_console/ai/model_connections) viser serverdækkende forbindelser og forbindelser for hvert fællesskab, efterfulgt af serverdækkende agenter (se AI-agenter).

Tilføj en forbindelse

I Systemkonsol › AI › Modelforbindelser, under Modelforbindelser, klik på Tilføj en forbindelse, og udfyld formularen:

Test forbindelse tjekker adressen og nøglen: serveren spørger slutpunktet om dets modeller eller sender en chat med ét token. En ændret adresse testes kun med den gemte nøgle, efter at du har gemt, eller hvis du indtaster nøglen igen. Klik på Tilføj forbindelse for at gemme.

Serveren udfører selv anmodningerne, så den skal kunne nå API'en: en modelserver i samme compose-projekt, på dit netværk eller på internettet. Udgående anmodninger respekterer variablerne HTTP_PROXY og HTTPS_PROXY.

Når du sletter en forbindelse, gemmes nøglen ikke længere. De funktioner, der brugte forbindelsen, stopper med at bruge AI, indtil du vælger en anden forbindelse.

Grænser og budgetter

Hver forbindelse har fire grænser. Tom eller 0 betyder ingen grænse.

• Anmodninger pr. minut og Anmodninger pr. person pr. minut. Disse tælles separat af hver server: en klynge med tre servere tillader op til tre gange så mange anmodninger.
• Tokens pr. måned og Tokens pr. person pr. måned: tokenbudgetter, pr. kalendermåned (UTC), talt i databasen for hele klyngen. Flere samtidige anmodninger kan overskride budgettet en smule.

Grænserne pr. person gælder også for omskrivning og opsummeringer: de tæller mod den person, der omskriver, eller som ejer opsummeringen.

Forbrug

Listen viser hvert forbindelses forbrug denne måned. Forbrug åbner detaljerne: tokens ind og ud, anmodninger, det månedlige budget, forbrug pr. dag (UTC) og pr. brug (Omskriv, Opsummeringer, Automatisk oversættelse, Tekst til tale, Personer, via apps, eller en app).

Hver opkald, som en person eller en app foretager via en forbindelse, skriver også en revisionspost: hvem, forbindelsen, brugen, modellen, tokenantal og om det lykkedes, aldrig hvad der blev sagt. De indbyggede funktioner tælles kun med i forbruget: oversættelse alene foretager ét opkald pr. besked og sprog.

Samfundsforbindelser

Fællesskabsadministratorer tilføjer deres fællesskabs egne forbindelser i fællesskabets indstillinger, under fanen AI, under Modelforbindelser. Formularen er den samme, uden Fællesskaber: En fællesskabsforbindelse virker kun i dets egne kanaler, for dets egne medlemmer, og dens målgruppe kan kun nævne sine egne teams. Roller med tilladelsen Administrer modelforbindelser kan også administrere dem. Som standard har fællesskabsadministratorer denne tilladelse.

En fællesskabsforbindelse kan ikke nå private eller loopback-adresser (f.eks. en Ollama-server på dit netværk), medmindre de er opført i Systemkonsol › Miljø › Udvikler › Tillad upålidelige interne forbindelser til (ServiceSettings.AllowedUntrustedInternalConnections). Serverdækkende forbindelser kan.

Se Fællesskabsindstillinger for fællesskabsadministratorernes side.

MCP-servere

En MCP-server er en tjeneste, der tilbyder værktøjer via Model Context Protocol, som agenter kan bruge. MCP-servere vises under modelforbindelserne, i Systemkonsol › AI › Modelforbindelser (serverdækkende) eller i et fællesskabs fane AI (dets egne), administreret med de samme tilladelser som modelforbindelser. Tilføj en med dens:

En communities MCP-server kan ikke nå interne adresser, medmindre Tillad upålidelige interne forbindelser til tillader det, ligesom for community-modeltilslutninger; en serverdækkende servers egen erklærede adresse er altid tilgængelig. MCP-forespørgsler følger aldrig en omdirigering. Ændring af en servers adresse eller kontotype logger alle ud fra den; sletning af en glemmer alles logind.

Krypteringsnøglen

Nøgler og ekstra headers i modelforbindelser krypteres i databasen (AES-256-GCM) med én krypteringsnøgle. En databasebackup alene afslører dem ikke. Serveren finder nøglen i denne rækkefølge:

1. Variablen AM_AI_ENCRYPTION_KEY: 32 tilfældige bytes, i base64. Opret en med openssl rand -base64 32.
2. Eller filen ai-encryption.key i roden af serverens datamappe (FileSettings.Directory, som standard ./data/). Serveren opretter den, kun læsbar for sig selv, første gang en forbindelse har brug for den. Apps, eksporter og filarkiver kan ikke læse den.

Hvornår variablen skal sættes:

• I site'ens compose-fil. compose.yaml videregiverer AM_AI_ENCRYPTION_KEY fra .env og gemmer nøglefilen i data-volumenet, når variablen er tom. Det er bedre at sætte variablen: Så indeholder backuppen af .env nøglen, adskilt fra databasen. Tilføj den til .env og kør docker compose up -d:

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

  Hvis serveren allerede har oprettet sin nøglefil, skal nøglen, som den indeholder, sættes i .env i stedet, så de gemte nøgler forbliver læsbare: docker compose exec antimatter cat /antimatter/data/ai-encryption.key udskriver den.
• En klynge, hvis filer er i S3. Serverne deler ingen mappe, så serveren opretter ikke filen: angiv den samme variabel på alle servere. Indtil variabel er angivet, kan forbindelser ikke gemme nøgler.
• Med udgivelsesarkivet eller pakkerne er filen i data/ (/var/lib/antimatter/data for pakkerne). Du kan beholde den der, eller angive variablen i din miljøfil.

For at ændre nøglen skal du angive den nye i AM_AI_ENCRYPTION_KEY og den gamle i AM_AI_ENCRYPTION_PREVIOUS_KEYS (flere nøgler adskilt af kommaer): nøgler gemt med den gamle kan stadig læses. En forbindelses nøgle krypteres med den nye nøgle, når du indtaster den igen. Behold den gamle nøgle i listen, indtil alle forbindelsers nøgler er indtastet igen.

De indbyggede funktioner

I Systemkonsol › AI › Indbyggede funktioner skal du vælge en serverdækkende forbindelse og dens model for hver funktion, eller Fra. En funktion uden forbindelse bruger ikke AI. Indlæs modeller viser alle modellerne i forbindelsen; som standard bruger hver funktion forbindelsens chatmodel.

Hver indstilling har en ConnectionId- og en Model-nøgle, for eksempel AISettings.Rewrite.ConnectionId (AM_AISETTINGS_REWRITE_CONNECTIONID). En tom Model bruger forbindelsens standardmodel.

De indbyggede funktioner bruger forbindelsens begrænsninger, men ikke dens målgruppe: alle, der kan bruge funktionen, kan bruge dens forbindelse. En forbindelse, der kræver opmærksomhed, eller som er slettet, får funktionen til at fejle, indtil du vælger en anden: siden angiver dette.

AI-agenter

En agent er en konto, som brugere omtaler eller sender beskeder til som en kollega, vist med et AGENT-mærke. Agenter er en del af serveren. Der er to typer:

• Indbygget: Antimatter svarer på vegne af agenten, når nogen omtaler den, sender en besked til den eller svarer i dens tråde, ved hjælp af en modelforbindelse og agentens instruktioner. Den svarer som den person, der spørger, med deres rettigheder: deres adgang til forbindelsen samt deres begrænsninger og budget.
• Ekstern agent: Et program et andet sted (f.eks. en kodningsagent på et projekt) logger ind med agentens token og svarer, som en person ville gøre det. Antimatter svarer ikke på vegne af den. Se Agenter i udviklerguiden.

Systemadministratorer administrerer de serverdækkende agenter i Systemkonsol › AI › Modelforbindelser, under modeltilslutningerne. En communities administratorer administrerer deres communities egne agenter i fanen AI i indstillingerne, under deres modeltilslutninger (se Community-indstillinger). Ingen andre kan oprette agenter.

Tilføj en agent

I Systemkonsol › AI › Modelforbindelser (eller i et communities AI-fane) skal du klikke på Tilføj en agent og derefter udfylde formularen:

Klik på Tilføj agent. En agents tilhørsforhold til et fællesskab oprettes, når den føjes til fællesskabet. Hver agent på listen viser sin forbindelse og model (eller "Ekstern"), om den er slået fra, og hvad der kræver din opmærksomhed. Fra listen kan du redigere en agent (inklusive billede), slå den fra eller til (ingen kan tale med en agent, der er slået fra) eller slette den: Kontoen deaktiveres og indstillingerne slettes, men beskederne bevares.

Værktøjer

Agentformularen Værktøjer-kontakt aktiverer værktøjer for agenten og tilbyder derefter for hver kilde (Antimatters egne værktøjer, hvert kørende apps værktøjer og hver MCP-server tilgængelig i agentens omfang): Fra, Alt eller Valgte, samt Dens læsninger kører uden forespørgsel. Værktøjer handler altid som den person, der spurgte, med deres egne rettigheder, aldrig som agenten.

• En læsning, som agentens politik tillader at køre på egen hånd, kører med det samme. Alle andre kald (alle skrivninger og en læsning, der ikke er sat til at køre på egen hånd) venter på personen: Det vises på agentens svar med Bekræft og Afvis, de præcise argumenter og en frist for svar; kun den person kan svare, og agenten, værktøjet og personens adgang kontrolleres igen, når de bekræfter. Et afvist kald kører ikke, og agenten siger ikke mere om det.
• Et MCP-værktøj tæller kun som en læsning, når dets server markerer det som sådan; alt andet er en skrivning. En delt konto (se MCP-servere) tilbyder kun de værktøjer fra den server, der læser.
• En persons egne værktøjsvalg i deres AI-chatindstillinger er én præference for alle agenter: De kan kun indsnævre, hvad agentens politik tillader, aldrig udvide det.
• Antimatters egne værktøjer, foreløbig: Søg i beskeder, læs en tråd, læs en kanal, slå nogen op og send en besked, som altid kræver bekræftelse.
• Alle kald af værktøjer skrives til revisionsloggen: hvem, værktøjet, agenten, hvor, hvordan det blev besluttet, og resultatet, samt størrelsen på og en hash af argumenterne, aldrig deres indhold.

Hvor agenter svarer

• En indbygget agent svarer på en besked, der nævner den (op til tre agenter pr. besked), en besked i en direkte besked med den, og et svar i en tråd, som den har startet eller blevet spurgt i, og hvor ingen andre er nævnt. Den svarer i tråden til beskeden.
• En person, der ikke må tale med agenten, får en meddelelse, som kun vedkommende kan se: "@agent er ikke tilgængelig for dig her."
• Agenter svarer ikke på bots, apps, webhooks eller hinanden.
• Hvert svar gives kun én gang af én server i en klynge.

AI-chatappen

AI-chatappen (id mattermost-ai, aktiveret som standard) er sidepanelet, hvor folk taler med de agenter, de må bruge: den viser deres samtaler med agenter og tilbyder resuméer af den kanal, der læses. Den tilføjer også AI-handlingerne i beskedmenuen (Opsummer tråd, Find handlingspunkter, Find åbne spørgsmål), menuen Spørg AI på linjen for nye beskeder og Opret møderesumé i opkald, som spørger personens agent via serveren og besvares i deres direkte besked med den. Når der ikke er nogen agent at tilbyde, sender panelet administratorer til Systemkonsol › AI › Modelforbindelser, eller en fællesskabsadministrator til fællesskabets AI-fane.

Appen har stadig sine egne indstillinger, nu i Systemkonsol › AI › AI-chatapp (Plugins-siden for den er væk; den gamle adresse videresender), med sine egne AI-tjenester for de funktioner, der stadig er dens egne: Reager for mig, AI-søgning, brugerdefinerede prompts, de automatiske svar i de kanaler, der er sat op til dem, og de automatiske resuméer af opkaldstranskriptioner. Dens Indlejringssøgning (eksperimentel, slået fra) driver AI-søgning: den kræver PostgreSQL med pgvector-udvidelsen og en indlejringssmodel, og den sender alle beskeder til indlejringssmodellen, inklusive private kanaler og direkte beskeder. Under DEBUG hjælper Sporskrivning (slået fra, serverlogfiler eller et OpenTelemetry-endepunkt) og Aktiver logning af tokenforbrug (skrives til logs/agents/token_usage.log) med at finde problemer.

Speech-to-text: opkaldstranskriptioner og undertitler

Opkald kan transkriberes med live undertitler af en tale-til-tekst-server, der tilbyder et OpenAI-kompatibelt /v1/audio/transcriptions-endpoint. Opsætningen findes under Opkald og lyd. Når Opsummer transkriptioner er aktiveret, udsender AI-chat-appens standardagent også en opsummering af hver transkription. Brugere kan også bede deres egen agent om en opsummering via Opret mødeopsummering.

Tekst til tale: Læs højt

Når tekst til tale er slået til, har hver besked en Læs højt-mulighed i menuen: serveren sender beskedens tekst til en tekst-til-tale-API og afspiller lyden. Indstillingerne findes under Systemkonsol › Integrationer › Tekst til tale:

Hvis du vil bruge en modelforbindelse i stedet for adressen og nøglen ovenfor, skal du vælge den under Tekst til tale i AI › Indbyggede funktioner. Siden angiver derefter, at beskeder læses op med den forbindelse: API-basis-URL og API-nøgle bruges ikke, Stemme bruges stadig, og det gør Model også, når forbindelsen ikke angiver nogen model. Læs beskeder højt skal stadig være aktiveret.

Før afsendelse fjerner serveren kodeblokke, links, emoji-koder og formatering og bevarer højst 4000 tegn. Den anmoder om MP3-lyd og bevarer de seneste 64 resultater i hukommelsen, så en besked, der læses to gange, kun sendes én gang.

Automatisk oversættelse

Automatisk oversættelse viser kanalens beskeder på hver læserens eget sprog. Konfigureres under Systemkonsol › Sitekonfiguration › Lokalisering, i Automatisk oversættelse:

Hver udbyder har sine egne felter:

• Modelforbindelse: en serverdækkende forbindelse og dens model, samme indstilling som Automatisk oversættelse i AI › Indbyggede funktioner (AISettings.AutoTranslation). En dedikeret oversættelsesmodel er hurtig og præcis; en generel LLM fungerer også.
• LibreTranslate: LibreTranslate API-endpoint og LibreTranslate API-nøgle (AutoTranslationSettings.LibreTranslate.URL, .APIKey). En LibreTranslate-server kan køre på dit eget netværk.
• OpenAI-kompatibel API: API-basis-URL (op til og med /v1; serveren bruger dens chat completions-endpoint), Model og API-nøgle (AutoTranslationSettings.OpenAI.URL, .Model, .APIKey). Et lille oversættelsesmodel, der køres lokalt, virker godt.
• AI-chat-appens tjeneste (ældre): udbyderen af servere, der er opsat før 0.9.0, som brugte en tjeneste fra Agenter-appen. Den behøver ikke længere appen: den oversætter med den forbindelse, der er valgt til automatisk oversættelse under AI › Indbyggede funktioner, eller ellers med den forbindelse, der er kopieret fra appens tjeneste ved opgraderingen. Skift til modelforbindelse flytter indstillingen til den anbefalede udbyder.

Når det er aktiveret, kan kanaladministratorer slå oversættelse til for en kanal i kanalens indstillinger (Automatisk oversættelse), og hvert medlem kan fravælge det fra kanalmenuen (Oversæt beskeder). I direkte beskeder og gruppebeskeder kan ethvert medlem slå det til; med begrænsningen aktiveret er oversættelse ikke tilgængelig der. Oversatte beskeder viser "Oversat fra …" med et link til den originale besked.

Kode, links, omtaler og emoji'er erstattes af pladsholdere, før teksten sendes, og indsættes igen bagefter.

Hvilke data sendes hvorhen

For at holde det hele på dit netværk, peger du hver funktion på servere, som du selv driver. Med en cloud-udbyder, tjek dennes dataopbevaringsvilkår, og oplyse dine brugere om, hvilke funktioner der sender deres beskeder ud.

Slå AI fra

Der er ikke én enkelt kontakt: hver funktion har sin egen.

• Omskrivninger og resuméer: Sæt dem til Fra under Systemkonsol › AI › Indbyggede funktioner. Brugere kan stadig læse de resuméer, de allerede har.
• Modelforbindelser: Slet en forbindelse for at stoppe al brug af den. Uden nogen forbindelse kan hverken de indbyggede funktioner eller appsene bruge AI via serveren.
• Agenter: Slå fra eller slet hver agent i Systemkonsol › AI › Modelforbindelser og i samfundenes AI-faner. Hvis du deaktiverer AI-chatappen, fjernes kun dens sidepanel og dens egne funktioner (inklusive opkaldsreferater): Man kan stadig omtale eller sende beskeder til agenterne.
• Transkription og undertitler: AM_CALLS_ENABLE_TRANSCRIPTIONS=false og AM_CALLS_ENABLE_LIVE_CAPTIONS=false (standardindstillingerne).
• Læs højt: Sæt Læs beskeder højt fra (AM_TEXTTOSPEECHSETTINGS_ENABLE=false, standardværdien), uanset om det bruger en forbindelse eller ej.
• Oversættelse: Slå automatisk oversættelse fra (AM_AUTOTRANSLATIONSETTINGS_ENABLE=false, standardindstillingen).

Hvis du deaktiverer AI-chatappen, slår det ikke de andre funktioner fra: De bruger modelforbindelser eller deres egne API'er.