AI-integration

Konfigurera AI-chatt, förslag för LaTeX-fel, användaråtkomst, kvoter och valfria söktjänster.

Den här funktionen tillhandahålls av ayaka-notes/ayakaleaf-pro och finns tillgänglig från och med v6.3.0. Vi välkomnar din återkoppling om du stöter på problem.

​

AI-assistent och assistent för LaTeX-fel

Ayakaleaf Pro för in AI-funktioner i redigeraren på två sätt.

• AI-assistenten kan använda dina projektdokument och den aktuella markeringen som kontext för att besvara frågor och föreslå ändringar som du kan granska.
• Felassistenten föreslår en riktad korrigering när du väljer ett LaTeX-kompileringsfel.

​

Toolkit-konfiguration

Lägg till följande i config/variables.env i din Toolkit-driftsättning och ersätt exempel-URL:en, nyckeln och modellen med värden från din leverantör:

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

Förvara riktiga API-nycklar i din driftsättnings miljöfil och håll dem utanför versionshanteringen. Värdena ovan är platshållare, inte fungerande inloggningsuppgifter.

Kvaliteten på AI-förslagen beror på vilken modell du väljer. Om du redan har en Codex- eller ChatGPT-prenumeration kan du ansluta den via den OpenAI-kompatibla slutpunkten i CLIProxyAPI.

AI_BASE_URL är bas-URL:en för det OpenAI-kompatibla API:et, inklusive leverantörens versionsprefix där det krävs. Lägg inte till /chat/completions, eftersom vi lägger till det internt. Gatewayen och modellen måste stödja strömmande chat completions och funktionsverktyg. Båda funktionerna skickar dokumentkontext till denna gateway; chatten kan även skicka uppladdade bilder när en modell med bildstöd används.

Toolkit vidarebefordrar config/variables.env till applikationscontainern. Behåll variabelnamnen som visas här; lägg inte till något OVERLEAF_-prefix. Återskapa applikationscontainern från Toolkit-katalogen när du har ändrat dessa variabler:

bin/up -d

​

Gateway-inställningar

Variabel	Standard	Syfte
AI_ENABLED	false	Ange exakt true för att aktivera chatt och felförslag för instansen. Om variabeln inte är satt eller har något annat värde förblir de inaktiverade. En fungerande gateway-konfiguration krävs också.
AI_BASE_URL	Inget; obligatorisk	Bas-URL för det OpenAI-kompatibla API:et.
AI_API_KEY	Inget; obligatorisk	API-nyckel för den gatewayen, används av servern.
AI_MODEL	Inget; obligatorisk	Textmodell som används av standardkonfigurationen för chatt och av förslagen för LaTeX-fel.
AI_IMAGE_MODEL	Inte satt	Valfri modell med bildstöd på samma gateway, med samma API-nyckel.
AI_MAX_STEPS	20	Maximalt antal verktygsanrop per användarmeddelande i AI-chatten, inklusive automatiska fortsättningar. Använd ett positivt heltal.
AI_PROXY_URL	Inte satt	Valfri URL till en HTTP-proxy för anrop till AI-gatewayen. Den konfigurerar inte klienterna för webb- eller dokumentationssökning.
AI_TOKEN_QUOTA	0	Tokengräns per användare som delas av chatt och felförslag under varje period. Inte satt eller 0 innebär obegränsat; använd ett positivt heltal för en gräns.
AI_TOKEN_QUOTA_PERIOD	month	month nollställs den första dagen kl. 00:00 UTC; week nollställs på måndagar kl. 00:00 UTC. Andra värden använder month.

För bilduppladdningar anger du AI_IMAGE_MODEL till en modell som tar emot bildindata och stöder de verktyg som chatten använder. Varje chattförfrågan vars historik innehåller en bifogad bild använder den här modellen, inklusive senare meddelanden i samma konversation. Utan den här inställningen använder bildförfrågningar den vanliga chattmodellen, som då själv måste stödja bilder. Förslagen för LaTeX-fel fortsätter att använda AI_MODEL.

Så här aktiverar du till exempel en bildmodell och en veckovis AI-tilldelning:

AI_IMAGE_MODEL=YOUR_IMAGE_CAPABLE_MODEL_ID
AI_TOKEN_QUOTA=100000
AI_TOKEN_QUOTA_PERIOD=week

​

Användaråtkomst och samtycke

Tillgänglighet på instansnivå och användarbehörighet är separata. AI_ENABLED och gateway-konfigurationen styr instansens tillgänglighet. En inloggad användare måste också klara de befintliga kontokontrollerna:

• aiFeatures.enabled får inte vara false. Detta befintliga databasfält styr både chatt och förslag för LaTeX-fel.
• Användarens effektiva features.aiUsageQuota måste matcha den konfigurerade obegränsade nivån (unlimited som standard), eller så måste den befintliga äldre behörigheten features.aiErrorAssistant vara aktiverad. Effektiva funktioner inkluderar tillämpliga åsidosättningar av kontofunktioner.

Att bara aktivera kryssrutan ändrar inte användarens plan. Fältet aiUsageQuota är en behörighetsnivå, inte en numerisk tokentilldelning. AI_TOKEN_QUOTA är en separat gräns som tillämpas lika för varje behörig användare; den nuvarande modulen erbjuder ingen individuell numerisk gräns per konto.

I administratörens användarlista väljer du en användare och öppnar Update account info → AI features. Enable AI features uppdaterar aiFeatures.enabled när kontoändringarna sparas. Servern kontrollerar aktuella behörigheter vid nya AI-förfrågningar, inklusive förfrågningar från en redan öppen redigerare. Uppdatera redigeraren för att uppdatera dess synliga kontroller efter en behörighetsändring.

​

Användning och nollställning

Administratörsfliken AI features visar den aktuella periodens Usage, Limit och knappen Reset på en rad. Användningen läses in när fliken öppnas; den uppdateras inte kontinuerligt. Öppna fliken igen när en chatt eller ett felförslag har slutförts för att se det senaste värdet. Nollställningen träder i kraft omedelbart och rensar endast den användarens räknare för den aktuella perioden, varefter den visade användningen läses in på nytt. Du behöver inte spara resten av kontoformuläret.

Användningen av chatt och felförslag delar en Redis-räknare, som uppdateras utifrån det totala antal tokens som modellleverantören rapporterar när en förfrågan har slutförts. Detta omfattar in- och utdatatokens över alla modellsteg. Indata kan omfatta konversationshistorik, dokumentkontext och verktygsresultat, så en uppföljningsfråga kan förbruka fler tokens än bara det nya meddelandet. Användningen registreras även när gränsen är Unlimited. Förfrågningar utan rapporterat tokenantal läggs inte till i räknaren; historisk oregistrerad användning kan inte rekonstrueras av modulen.

Kvotkontroller görs innan strömningen börjar. En förfrågan, eller flera samtidiga förfrågningar, kan överskrida den återstående tilldelningen innan senare förfrågningar blockeras. Detta är en användningstilldelning snarare än ett strikt utgiftstak hos leverantören. Om kvotuppslaget misslyckas tillåts förfrågan och felet loggas.

Båda funktionerna använder AI_TOKEN_QUOTA; felförslag har ingen separat gräns för antal förfrågningar. Att nollställa räknaren ändrar inte behörighet, samtycke, den konfigurerade gränsen eller leverantörens egna faktureringsuppgifter. Räknarna använder periodnycklar i UTC och upphör efter 40 dagar; om Redis-data behålls bevaras aktuell användning när applikationen startas om.

​

Valfria söktjänster

Webbsökning använder ett Tavily-kompatibelt API. Den är tillgänglig när en API-nyckel för sökning har konfigurerats. Dessa inställningar är oberoende av AI-gatewayen:

Variabel	Standard	Syfte
TAVILY_API_KEY	Inte satt	API-nyckel för sökning. Har företräde framför WEB_SEARCH_API_KEY.
WEB_SEARCH_API_KEY	Inte satt	Alternativt namn för API-nyckeln för sökning.
WEB_SEARCH_URL	https://api.tavily.com/search	Sökslutpunkt; anpassade slutpunkter måste acceptera Tavilys format för förfrågningar och svar.
WEB_SEARCH_MAX_RESULTS	5	Antal resultat som begärs per sökning; använd ett positivt heltal som tjänsten stöder.
WEB_SEARCH_DEPTH	basic	Sökdjup, normalt basic eller advanced.
WEB_SEARCH_PROVIDER	tavily	Den nuvarande implementeringen stöder endast det Tavily-kompatibla protokollet; att ändra detta värde väljer inte någon annan adapter.
DOCS_MCP_URL	https://docs.overleaf.com/~gitbook/mcp	Slutpunkt för dokumentationssökning. Ange en tom sträng för att inaktivera dokumentationssökning.

Till exempel:

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

Dokumentationssökningen anropar verktyget searchDocumentation på den konfigurerade GitBook MCP-slutpunkten och accepterar JSON- eller SSE-svar. Detta är en MCP-klient för dokumentationssökning; dessa moduler exponerar inte projektfiler som en MCP-server och tillhandahåller inte något allmänt register över MCP-servrar.

Sökfrågor skickas till den konfigurerade söktjänsten. Sökresultaten kan sedan inkluderas i förfrågningar till AI-gatewayen. Chattens meny Tools låter användarna aktivera eller inaktivera Web och Documentation för sina förfrågningar; ett verktyg måste också vara konfigurerat på servern för att vara tillgängligt för modellen.