Tekoälyintegraatio

Määritä tekoälychat, LaTeX-virheehdotukset, käyttäjien käyttöoikeudet, kiintiöt ja valinnaiset hakupalvelut.

Tämän ominaisuuden tarjoaa ayaka-notes/ayakaleaf-pro, ja se on saatavilla versiosta v6.3.0 alkaen. Otamme mielellämme vastaan palautetta, jos kohtaat ongelmia.

​

Tekoälyavustaja ja LaTeX-virheavustaja

Ayakaleaf Pro tuo tekoälyominaisuudet editoriin kahdella tavalla.

• Tekoälyavustaja voi käyttää projektisi dokumentteja ja nykyistä valintaa kontekstina vastatessaan kysymyksiin ja ehdottaessaan muokkauksia, jotka voit tarkistaa.
• Virheavustaja ehdottaa kohdennettua korjausta, kun valitset LaTeX-käännösvirheen.

​

Toolkit-määritys

Lisää seuraavat rivit Toolkit-käyttöönottosi config/variables.env-tiedostoon ja korvaa esimerkin URL, avain ja malli palveluntarjoajasi arvoilla:

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

Säilytä oikeat API-avaimet käyttöönoton ympäristötiedostossa äläkä vie niitä versionhallintaan. Yllä olevat arvot ovat paikkamerkkejä, eivät toimivia tunnuksia.

Tekoälyehdotusten laatu riippuu valitsemastasi mallista. Jos sinulla on jo Codex- tai ChatGPT-tilaus, voit yhdistää sen CLIProxyAPI:n OpenAI-yhteensopivan päätepisteen kautta.

AI_BASE_URL on OpenAI-yhteensopivan API:n perus-URL, joka sisältää tarvittaessa palveluntarjoajan versioetuliitteen. Älä lisää loppuun /chat/completions, koska lisäämme sen sisäisesti. Yhdyskäytävän ja mallin on tuettava suoratoistettavia chat completion -vastauksia ja funktiotyökaluja. Molemmat ominaisuudet lähettävät dokumenttikontekstia tälle yhdyskäytävälle; chat voi lähettää myös ladattuja kuvia, kun käytetään kuvia tukevaa mallia.

Toolkit välittää config/variables.env-tiedoston sovelluskonttiin. Käytä tässä esitettyjä muuttujien nimiä; älä lisää OVERLEAF_-etuliitettä. Luo sovelluskontti uudelleen Toolkit-hakemistosta näiden muuttujien muuttamisen jälkeen:

bin/up -d

​

Yhdyskäytävän asetukset

Muuttuja	Oletus	Tarkoitus
AI_ENABLED	false	Aseta täsmälleen arvoon true ottaaksesi chatin ja virheehdotukset käyttöön instanssissa. Jos arvoa ei ole asetettu tai se on jokin muu, ne pysyvät pois käytöstä. Lisäksi tarvitaan toimiva yhdyskäytävämääritys.
AI_BASE_URL	Ei mitään; pakollinen	OpenAI-yhteensopivan API:n perus-URL.
AI_API_KEY	Ei mitään; pakollinen	Kyseisen yhdyskäytävän API-avain, jota palvelin käyttää.
AI_MODEL	Ei mitään; pakollinen	Tekstimalli, jota oletusarvoinen chat-määritys ja LaTeX-virheehdotukset käyttävät.
AI_IMAGE_MODEL	Ei asetettu	Valinnainen kuvia tukeva malli samassa yhdyskäytävässä samalla API-avaimella.
AI_MAX_STEPS	20	Työkalukutsujen enimmäismäärä käyttäjän viestiä kohden tekoälychatissa, automaattiset jatkot mukaan lukien. Käytä positiivista kokonaislukua.
AI_PROXY_URL	Ei asetettu	Valinnainen HTTP-välityspalvelimen URL tekoälyyhdyskäytävän kutsuille. Se ei määritä verkko- tai dokumentaatiohaun asiakkaita.
AI_TOKEN_QUOTA	0	Käyttäjäkohtainen token-raja jaksoa kohden, yhteinen chatille ja virheehdotuksille. Asettamaton tai 0 tarkoittaa rajatonta; käytä rajalle positiivista kokonaislukua.
AI_TOKEN_QUOTA_PERIOD	month	month nollautuu kuukauden ensimmäisenä päivänä klo 00:00 UTC; week nollautuu maanantaina klo 00:00 UTC. Muut arvot käyttävät month-asetusta.

Kuvien lataamista varten aseta AI_IMAGE_MODEL malliin, joka hyväksyy kuvasyötteen ja tukee chatin käyttämiä työkaluja. Jokainen chat-pyyntö, jonka historiassa on kuvaliite, käyttää tätä mallia, myös saman keskustelun myöhemmät viestit. Ilman tätä asetusta kuvapyynnöt käyttävät tavallista chat-mallia, jonka on itse tuettava kuvia. LaTeX-virheehdotukset käyttävät edelleen AI_MODEL-mallia.

Esimerkiksi kuvamallin ja viikoittaisen tekoälykiintiön käyttöönotto:

AI_IMAGE_MODEL=YOUR_IMAGE_CAPABLE_MODEL_ID
AI_TOKEN_QUOTA=100000
AI_TOKEN_QUOTA_PERIOD=week

​

Käyttäjien käyttöoikeudet ja suostumus

Instanssin saatavuus ja käyttäjän käyttöoikeus ovat erillisiä asioita. AI_ENABLED ja yhdyskäytävämääritys ohjaavat instanssin saatavuutta. Kirjautuneen käyttäjän on lisäksi läpäistävä olemassa olevat tilitarkistukset:

• aiFeatures.enabled ei saa olla false. Tämä olemassa oleva tietokantakenttä ohjaa sekä chattia että LaTeX-virheehdotuksia.
• Käyttäjän voimassa olevan features.aiUsageQuota-arvon on vastattava määritettyä rajatonta tasoa (oletuksena unlimited), tai olemassa olevan vanhan features.aiErrorAssistant-oikeuden on oltava käytössä. Voimassa oleviin ominaisuuksiin sisältyvät sovellettavat tilikohtaiset ominaisuusohitukset.

Pelkkä valintaruudun valitseminen ei muuta käyttäjän tilausta. aiUsageQuota-kenttä on oikeustaso, ei numeerinen token-kiintiö. AI_TOKEN_QUOTA on erillinen raja, jota sovelletaan tasapuolisesti jokaiseen oikeutettuun käyttäjään; nykyinen moduuli ei tarjoa tilikohtaista numeerista rajaa.

Valitse ylläpidon käyttäjäluettelosta käyttäjä ja avaa Update account info → AI features. Enable AI features päivittää aiFeatures.enabled-kentän, kun tilimuutokset tallennetaan. Palvelin tarkistaa nykyiset oikeudet uusien tekoälypyyntöjen yhteydessä, myös jo avoinna olevasta editorista tulevissa pyynnöissä. Päivitä editori, jotta sen näkyvät säätimet päivittyvät oikeuksien muutoksen jälkeen.

​

Käyttö ja nollaus

Ylläpidon AI features -välilehti näyttää nykyisen jakson Usage-, Limit- ja Reset-painikkeen yhdellä rivillä. Käyttö luetaan, kun välilehti avataan; sitä ei päivitetä jatkuvasti. Avaa välilehti uudelleen chatin tai virheehdotuksen valmistuttua nähdäksesi viimeisimmän määrän. Nollaus tulee voimaan välittömästi ja tyhjentää vain kyseisen käyttäjän nykyisen jakson laskurin, minkä jälkeen näytetty käyttö ladataan uudelleen. Se ei edellytä muun tililomakkeen tallentamista.

Chat ja virheehdotukset jakavat yhden Redis-laskurin, joka päivitetään mallin tarjoajan ilmoittamalla tokenien kokonaismäärällä pyynnön valmistuttua. Tähän sisältyvät syöte- ja tulostetokenit kaikista mallin vaiheista. Syöte voi sisältää keskusteluhistorian, dokumenttikontekstin ja työkalujen tulokset, joten jatkokysymys voi kuluttaa enemmän tokeneita kuin pelkkä uusi viesti. Käyttö kirjataan, vaikka raja olisi Unlimited. Pyynnöt, joille ei ilmoiteta tokenien kokonaismäärää, eivät kasvata laskuria; moduuli ei pysty jälkikäteen rekonstruoimaan kirjaamatonta historiallista käyttöä.

Kiintiötarkistukset tehdään ennen suoratoistoa. Yksi pyyntö tai useampi samanaikainen pyyntö voi ylittää jäljellä olevan kiintiön ennen kuin myöhemmät pyynnöt estetään. Kyseessä on käyttökiintiö eikä palveluntarjoajan tiukka kulukatto. Jos kiintiön haku epäonnistuu, pyyntö sallitaan ja virhe kirjataan lokiin.

Molemmat ominaisuudet käyttävät AI_TOKEN_QUOTA-arvoa; virheehdotuksilla ei ole erillistä pyyntömäärärajaa. Laskurin nollaaminen ei muuta käyttöoikeutta, suostumusta, määritettyä rajaa tai palveluntarjoajan omia laskutustietoja. Laskurit käyttävät UTC-jaksoavaimia ja vanhenevat 40 päivän kuluttua; Redis-datan säilyttäminen säilyttää nykyisen käytön sovelluksen uudelleenkäynnistysten yli.

​

Valinnaiset hakupalvelut

Verkkohaku käyttää Tavily-yhteensopivaa API:a. Se on käytettävissä, kun haun API-avain on määritetty. Nämä asetukset ovat riippumattomia tekoälyyhdyskäytävästä:

Muuttuja	Oletus	Tarkoitus
TAVILY_API_KEY	Ei asetettu	Haun API-avain. Menee WEB_SEARCH_API_KEY-arvon edelle.
WEB_SEARCH_API_KEY	Ei asetettu	Vaihtoehtoinen nimi haun API-avaimelle.
WEB_SEARCH_URL	https://api.tavily.com/search	Haun päätepiste; mukautettujen päätepisteiden on hyväksyttävä Tavilyn pyyntö- ja vastausmuoto.
WEB_SEARCH_MAX_RESULTS	5	Hakua kohden pyydettyjen tulosten määrä; käytä palvelun tukemaa positiivista kokonaislukua.
WEB_SEARCH_DEPTH	basic	Haun syvyys, tavallisesti basic tai advanced.
WEB_SEARCH_PROVIDER	tavily	Nykyinen toteutus tukee vain Tavily-yhteensopivaa protokollaa; tämän arvon muuttaminen ei valitse toista sovitinta.
DOCS_MCP_URL	https://docs.overleaf.com/~gitbook/mcp	Dokumentaatiohaun päätepiste. Aseta tyhjäksi merkkijonoksi poistaaksesi dokumentaatiohaun käytöstä.

Esimerkiksi:

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

Dokumentaatiohaku kutsuu määritetyn GitBook MCP -päätepisteen searchDocumentation-työkalua ja hyväksyy JSON- tai SSE-vastaukset. Kyseessä on MCP-asiakas dokumentaatiohakua varten; nämä moduulit eivät tarjoa projektitiedostoja MCP-palvelimena eivätkä tarjoa yleiskäyttöistä MCP-palvelinrekisteriä.

Hakukyselyt lähetetään määritettyyn hakupalveluun. Hakutuloksia voidaan sitten sisällyttää tekoälyyhdyskäytävälle lähetettäviin pyyntöihin. Chatin Tools-valikosta käyttäjät voivat ottaa Web- ja Documentation-työkalut käyttöön tai poistaa ne käytöstä pyynnöissään; työkalu on myös määritettävä palvelimella, jotta se on mallin käytettävissä.