AI-integrasjon

Konfigurer AI-chat, forslag til LaTeX-feilrettinger, brukertilgang, kvoter og valgfrie søketjenester.

Denne funksjonen leveres av ayaka-notes/ayakaleaf-pro og er tilgjengelig fra v6.3.0. Vi setter pris på tilbakemeldinger hvis du støter på problemer.

​

AI-assistent og LaTeX-feilassistent

Ayakaleaf Pro bringer AI-funksjoner inn i editoren på 2 måter.

• AI-assistenten kan bruke prosjektdokumentene dine og det gjeldende utvalget som kontekst for å svare på spørsmål og foreslå endringer som du kan gjennomgå.
• Feilassistenten foreslår en målrettet rettelse når du velger en LaTeX-kompileringsfeil.

​

Toolkit-konfigurasjon

Legg til følgende i config/variables.env i Toolkit-distribusjonen din, og erstatt eksempel-URL-en, nøkkelen og modellen med verdier fra leverandøren din:

AI_ENABLED=true
AI_BASE_URL=https://ai-gateway.example.com/v1
AI_API_KEY=REPLACE_WITH_YOUR_GATEWAY_API_KEY
AI_MODEL=YOUR_TEXT_MODEL_ID

Oppbevar ekte API-nøkler i miljøfilen for distribusjonen og utenfor versjonskontroll. Verdiene ovenfor er plassholdere, ikke fungerende legitimasjon.

Kvaliteten på AI-forslagene avhenger av modellen du velger. Hvis du allerede har et Codex- eller ChatGPT-abonnement, kan du koble det til via det OpenAI-kompatible endepunktet til CLIProxyAPI.

AI_BASE_URL er basis-URL-en til det OpenAI-kompatible API-et, inkludert leverandørens versjonsprefiks der det kreves. Ikke legg til /chat/completions, siden vi legger dette til internt. Gatewayen og modellen må støtte strømmende chat completions og funksjonsverktøy. Begge funksjonene sender dokumentkontekst til denne gatewayen; chatten kan også sende opplastede bilder når det brukes en modell som støtter bilder.

Toolkit videresender config/variables.env til applikasjonscontaineren. Behold variabelnavnene som vises her; ikke legg til et OVERLEAF_-prefiks. Fra Toolkit-katalogen gjenoppretter du applikasjonscontaineren etter at du har endret disse variablene:

bin/up -d

​

Gateway-innstillinger

Variabel	Standard	Formål
AI_ENABLED	false	Sett nøyaktig til true for å aktivere chat og feilforslag for instansen. Hvis den ikke er satt eller har en annen verdi, forblir funksjonene deaktivert. En fungerende gateway-konfigurasjon kreves også.
AI_BASE_URL	Ingen; påkrevd	Basis-URL for OpenAI-kompatibelt API.
AI_API_KEY	Ingen; påkrevd	API-nøkkel for denne gatewayen, brukt av serveren.
AI_MODEL	Ingen; påkrevd	Tekstmodell som brukes av standard chatkonfigurasjon og av forslag til LaTeX-feilrettinger.
AI_IMAGE_MODEL	Ikke satt	Valgfri bildekompatibel modell på samme gateway, med samme API-nøkkel.
AI_MAX_STEPS	20	Maksimalt antall verktøykall per brukermelding i AI-chatten, inkludert automatiske fortsettelser. Bruk et positivt heltall.
AI_PROXY_URL	Ikke satt	Valgfri URL til en HTTP-proxy for kall til AI-gatewayen. Den konfigurerer ikke klientene for nett- eller dokumentasjonssøk.
AI_TOKEN_QUOTA	0	Tokengrense per bruker, delt mellom chat og feilforslag for hver periode. Ikke satt eller 0 betyr ubegrenset; bruk et positivt heltall for en grense.
AI_TOKEN_QUOTA_PERIOD	month	month nullstilles den første dagen kl. 00:00 UTC; week nullstilles mandag kl. 00:00 UTC. Andre verdier bruker month.

For bildeopplastinger setter du AI_IMAGE_MODEL til en modell som godtar bildeinndata og støtter verktøyene chatten bruker. Alle chatforespørsler der historikken inneholder et bildevedlegg, bruker denne modellen, også senere meldinger i samme samtale. Uten denne innstillingen bruker bildeforespørsler den vanlige chatmodellen, som da selv må støtte bilder. Forslag til LaTeX-feilrettinger fortsetter å bruke AI_MODEL.

For eksempel, for å aktivere en bildemodell og en ukentlig AI-kvote:

AI_IMAGE_MODEL=YOUR_IMAGE_CAPABLE_MODEL_ID
AI_TOKEN_QUOTA=100000
AI_TOKEN_QUOTA_PERIOD=week

​

Brukertilgang og samtykke

Tilgjengelighet på instansen og brukertillatelse er to separate ting. AI_ENABLED og gateway-konfigurasjonen styrer tilgjengeligheten på instansen. En innlogget bruker må i tillegg bestå de eksisterende kontokontrollene:

• aiFeatures.enabled må ikke være false. Dette eksisterende databasefeltet styrer både chat og forslag til LaTeX-feilrettinger.
• Brukerens effektive features.aiUsageQuota må samsvare med det konfigurerte ubegrensede nivået (unlimited som standard), eller den eksisterende eldre tillatelsen features.aiErrorAssistant må være aktivert. Effektive funksjoner inkluderer gjeldende overstyringer av kontofunksjoner.

Å aktivere avkrysningsboksen alene endrer ikke brukerens abonnement. Feltet aiUsageQuota er et tillatelsesnivå, ikke en numerisk tokenkvote. AI_TOKEN_QUOTA er en separat grense som gjelder likt for hver bruker med tillatelse; den nåværende modulen tilbyr ingen individuell numerisk grense per konto.

I brukerlisten for administratorer velger du en bruker og åpner Update account info → AI features. Enable AI features oppdaterer aiFeatures.enabled når kontoendringene lagres. Serveren kontrollerer gjeldende tillatelser ved nye AI-forespørsler, også forespørsler fra en editor som allerede er åpen. Oppdater editoren for å oppdatere de synlige kontrollene etter en endring i tillatelser.

​

Forbruk og nullstilling

Fanen for AI-funksjoner i administrasjonspanelet viser gjeldende periodes Usage, Limit og Reset-knappen på én rad. Forbruket leses når fanen åpnes; det oppdateres ikke kontinuerlig. Åpne fanen på nytt etter at en chat eller et feilforslag er fullført for å se det siste tallet. Nullstilling trer i kraft umiddelbart og tømmer bare telleren for den aktuelle brukerens gjeldende periode, og laster deretter inn det viste forbruket på nytt. Det krever ikke at resten av kontoskjemaet lagres.

Forbruket for chat og feilforslag deler én Redis-teller, som oppdateres med det totale antallet tokens modelleverandøren rapporterer etter at en forespørsel er fullført. Dette inkluderer inn- og utdatatokens på tvers av modelltrinn. Inndata kan omfatte samtalehistorikk, dokumentkontekst og verktøyresultater, så en oppfølging kan bruke flere tokens enn den nye meldingen alene. Forbruket registreres selv når grensen er Unlimited. Forespørsler uten rapportert tokentotal legges ikke til i telleren; historisk forbruk som ikke er registrert, kan ikke rekonstrueres av modulen.

Kvotekontroller skjer før strømmingen starter. En forespørsel, eller flere samtidige forespørsler, kan overskride gjenværende kvote før senere forespørsler blokkeres. Dette er en forbrukskvote snarere enn et strengt utgiftstak hos leverandøren. Hvis kvoteoppslaget mislykkes, tillates forespørselen, og feilen logges.

Begge funksjonene bruker AI_TOKEN_QUOTA; feilforslag har ingen separat grense for antall forespørsler. Nullstilling av telleren endrer ikke tillatelse, samtykke, den konfigurerte grensen eller leverandørens egne faktureringsdata. Tellerne bruker periodenøkler i UTC og utløper etter 40 dager; hvis Redis-data beholdes, bevares gjeldende forbruk på tvers av omstarter av applikasjonen.

​

Valgfrie søketjenester

Nettsøk bruker et Tavily-kompatibelt API. Det er tilgjengelig når en API-nøkkel for søk er konfigurert. Disse innstillingene er uavhengige av AI-gatewayen:

Variabel	Standard	Formål
TAVILY_API_KEY	Ikke satt	API-nøkkel for søk. Har forrang over WEB_SEARCH_API_KEY.
WEB_SEARCH_API_KEY	Ikke satt	Alternativt navn på API-nøkkelen for søk.
WEB_SEARCH_URL	https://api.tavily.com/search	Søkeendepunkt; egendefinerte endepunkter må godta Tavilys forespørsels- og svarformat.
WEB_SEARCH_MAX_RESULTS	5	Antall resultater som etterspørres per søk; bruk et positivt heltall som tjenesten støtter.
WEB_SEARCH_DEPTH	basic	Søkedybde, vanligvis basic eller advanced.
WEB_SEARCH_PROVIDER	tavily	Den nåværende implementasjonen støtter kun den Tavily-kompatible protokollen; å endre denne verdien velger ikke en annen adapter.
DOCS_MCP_URL	https://docs.overleaf.com/~gitbook/mcp	Endepunkt for dokumentasjonssøk. Sett til en tom streng for å deaktivere dokumentasjonssøk.

For eksempel:

TAVILY_API_KEY=REPLACE_WITH_YOUR_SEARCH_API_KEY
WEB_SEARCH_MAX_RESULTS=5
WEB_SEARCH_DEPTH=basic
DOCS_MCP_URL=https://docs.overleaf.com/~gitbook/mcp

Dokumentasjonssøk kaller verktøyet searchDocumentation på det konfigurerte GitBook MCP-endepunktet og godtar JSON- eller SSE-svar. Dette er en MCP-klient for dokumentasjonssøk; disse modulene eksponerer ikke prosjektfiler som en MCP-server og tilbyr ikke noe generelt register for MCP-servere.

Søkespørringer sendes til den konfigurerte søketjenesten. Søkeresultatene kan deretter inkluderes i forespørsler til AI-gatewayen. Chattens Tools-meny lar brukerne aktivere eller deaktivere Web og Documentation for forespørslene sine; et verktøy må også være konfigurert på serveren for å være tilgjengelig for modellen.