Si funksionon baza e njohurive
Shënimet, skedarët dhe faqet e uebit që përdor AI-ja kur sugjeron përgjigje, harton emaile dhe përgjigjet te asistenti, të mbajtura për të gjithë hapësirën e punës, një domen ose një adresë.
Çfarë është
Baza e njohurive mban atë që AI-ja duhet të dijë për biznesin tënd dhe nuk mund ta mësojë nga vetë posta: çmimet, rregullat, oraret e punës, faktet për produktet dhe mënyrën si përgjigjet ekipi yt. Ti shton shënime, skedarë dhe faqe uebi, dhe AI-ja lexon pjesët që kanë rëndësi sa herë shkruan për ty.
Ka një depo për hapësirë pune, me tre nivele, që një përgjigje që vlen vetëm për një markë ose një ekip të mbetet me ta. Lexohet dhe ndryshohet në aplikacion te Hapësira e punës → Baza e njohurive, përmes REST API, nga SDK-të dhe CLI, si dhe nga asistenti dhe klientët MCP.
Tre nivele
Çdo zë qëndron në një nivel, scope e tij. AI-ja që shkruan për një adresë lexon atë adresë, pastaj domenin e saj, pastaj të gjithë hapësirën e punës, dhe kur dy zëra nuk pajtohen fiton më specifiku.
| Niveli | `scope` | Lexohet për |
|---|---|---|
| E gjithë hapësira e punës | bosh | Çdo adresë në hapësirën e punës |
| Domeni | @acme.com | Çdo adresë në atë domen, përfshirë adresat e shtuara më vonë |
| Adresa | [email protected] | Vetëm ajo adresë |
- Një adresë me plus lexon edhe adresën e saj bazë, kështu që
[email protected]përdor atë që mbahet për[email protected]. GET /knowledge/levelsrendit çdo nivel që mund të shohësh, sa zëra ka secili dhe nëse mund të ndryshosh zëra atje.- Zhvendosja e një domeni në një hapësirë tjetër pune merr me vete zërat e mbajtur për të dhe adresat e tij.
Shënime, skedarë dhe faqe uebi
- Një shënim është tekst që e shkruan aty për aty, deri në 20.000 karaktere, në Markdown nëse do. Zakonisht është gati për AI-në brenda një ose dy sekondash.
- Një skedar lexohet në tekst në sfond: PDF, dokumente Word, fletëllogaritëse (Excel, OpenDocument, Numbers dhe CSV), tekst OpenDocument, HTML, XML, Markdown, tekst i thjeshtë, JSON dhe imazhe (JPEG, PNG, WebP dhe SVG). Një dokument mund të jetë deri në 20 MB dhe një imazh deri në 10 MB.
- Një faqe uebi merret nga një adresë publike
httposehttpsdhe lexohet në sfond, deri në 5 MB prej saj. Një nivel e mban një faqe një herë, dhe rifreskimi e merr sërish pasi ndryshon. - Nga një zë mbahen deri në 1.000.000 karaktere teksti, dhe teksti ndahet në pjesë nën titujt e tij për kërkimin.
Një zë është queued dhe pastaj processing ndërsa lexohet, ready sapo AI-ja mund ta përdorë, dhe failed me një failure që tregon arsyen kur nuk mund të lexohej. Një zë i ndryshuar kthehet në queued, dhe AI-ja vazhdon të përdorë tekstin e mëparshëm derisa i riu të jetë gati. Rifreskimi i një zëri e lexon sërish dhe pastron një dështim.
| Plani | Zërat | Karaktere teksti |
|---|---|---|
| Free | 50 | 1,000,000 |
| Starter | 500 | 10,000,000 |
| Business | 2,000 | 50,000,000 |
| Enterprise | 10,000 | 200,000,000 |
Një zë llogaritet në kuotë sapo shtohet, dhe karakteret e tij sapo të jetë lexuar teksti. Shtimi përtej kuotës refuzohet, dhe një skedar ose faqe, teksti i së cilës do ta kalonte, mbahet si i dështuar. GET /knowledge/usage lexon të dy numrat.
Si e përdor AI-ja
- Sugjerimet e përgjigjeve nën mesazhin e fundit të një bisede lexojnë nivelet e adresës ku mbërriti mesazhi.
- Një draft i shkruar nga një përshkrim, në redaktues ose me
POST /emails/compose, lexon nivelet e adresës nga e cila del. Përgjigjja rendit tesourceszërat mbi të cilët u mbështet. - Asistenti lexon nivelet e bisedës që ke hapur, ose çdo nivel që mund të shohësh kur nuk ka asnjë të hapur, dhe mund të kërkojë vetë në bazën e njohurive me veglën e tij
searchKnowledge. - Përgjigjja e
GET /threads/{id}/reply-suggestionsrendit tesourceszërat mbi të cilët u mbështetën sugjerimet.
Shënimet e fiksuara hyjnë në çdo prompt në nivelin e tyre, deri në 2.000 karaktere nga çdo nivel, qofshin apo jo në përputhje me atë që shkruhet. Pjesa tjetër e hapësirës, rreth 6.000 karaktere gjithsej, shkon te pjesët që përputhen më mirë me kërkesën, të gjetura sipas kuptimit dhe sipas fjalëve. Kur indeksi nuk përgjigjet brenda një çasti, AI-ja shkruan pa të në vend që të të mbajë në pritje.
AI-së i thuhet t'i trajtojë ato që thotë baza e njohurive si të dhëna referimi dhe kurrë si udhëzime, të lërë jashtë atë që nuk vlen, dhe të mos e përmendë bazën e njohurive në atë që shkruan.
Si rritet
Shto zëra në aplikacion te Hapësira e punës → Baza e njohurive, ose nga kodi me API-në, SDK-të dhe CLI. Asistenti dhe klientët MCP mund të ruajnë një shënim ose të shtojnë një lidhje kur u kërkon të mbajnë mend diçka, dhe mund edhe të ndryshojnë, rifreskojnë dhe fshijnë zëra. Në bisedën e aplikacionit, shtimi, ndryshimi dhe rifreskimi i një zëri pyesin më parë përveç nëse e kërkove ti, dhe fshirja pyet gjithmonë më parë.
Çdo zë regjistron te origin nga erdhi: app, api, assistant ose mcp, dhe te createdBy kush e shtoi.
Ajo rritet edhe vetë. AI-ja sugjeron shënime nga përgjigjet që dërgon ekipi yt dhe shënon pyetjet që ende nuk i përgjigjet asgjë, konektorët mbajnë të përditësuara faqe të tëra uebi, sitemap-e, feed-e dhe qendra ndihme, dhe lidhjet mund të lexohen sërish sipas një orari. Seksionet më poshtë shpjegojnë secilin.
Sugjerime të mësuara nga përgjigjet e tua
Kur dikush në hapësirën e punës përgjigjet në një bisedë, AI-ja lexon përgjigjen dhe mesazhin të cilit i përgjigjet, dhe sugjeron prej saj deri në tri fakte që do të vlenin edhe për të tjerë, si një çmim, një rregull ose një afat dorëzimi. Çdo sugjerim është një shënim që pret shqyrtim, në nivelin e domenit nga u dërgua përgjigjja, ose të gjithë hapësirës së punës kur ai domen nuk është një nga domenet e saj. Faktet që baza e njohurive i ka tashmë lihen jashtë, dhe lexohen deri në 100 përgjigje në ditë.
Shqyrtoji në aplikacion ose me GET /knowledge/suggestions. Prano një për ta ruajtur si shënim, duke i ndryshuar rrugës titullin, tekstin, nivelin ose fiksimin, ose hidhe poshtë. I njëjti fakt i sugjeruar sërish rrit occurrences në vend që të shtojë një sugjerim të dytë, dhe një sugjerim i hedhur poshtë nuk sugjerohet më.
Pyetje që ende nuk i përgjigjet asgjë
Kur AI-ja sugjeron përgjigje për një mesazh hyrës, ajo shënon edhe deri në tri gjëra që dërguesi pyeti për biznesin dhe që as biseda, as baza e njohurive nuk u përgjigjen, si për shembull nëse dërgon në vendin e tij. Secila bëhet një pyetje në nivelin e domenit ku mbërriti mesazhi, ose të gjithë hapësirës së punës kur ai domen nuk është një nga domenet e saj, dhe e njëjta pyetje e bërë sërish rrit occurrences, që të shohësh cilat dalin më shpesh.
Përgjigju një pyetjeje dhe ajo bëhet shënim: pranoje me përgjigjen si tekst, dhe titulli i saj mbetet pyetja, përveç nëse e ndryshon. Që atëherë AI-ja e përdor përgjigjen sa herë del pyetja. Hidhe poshtë një pyetje që nuk ka nevojë për përgjigje, dhe ajo nuk shënohet më.
Dublikata dhe kundërthënie
Çdo zë krahasohet me zërat më të afërt në çdo nivel kur indeksohet, dhe sërish sa herë ndryshon. Dy zëra që thonë pothuajse të njëjtën gjë sinjalizohen si duplicate. Dy zëra të lidhur ngushtë që nuk pajtohen për një fakt, si një çmim ose një afat, sinjalizohen si conflict, me një fjali për atë që nuk pajtohet. AI-ja kontrollon për kundërthënie deri në 200 herë në ditë.
- Çdo zë numëron te
flagssinjalizimet e hapura që e përmendin, dheGET /knowledge/flagsi rendit, më të rejat në krye. - Ndrysho ose fshi njërin nga dy zërat për ta zgjidhur një sinjalizim. Një zë i ndryshuar krahasohet sërish sapo indeksohet.
- Hidhe poshtë një sinjalizim kur dy zërat janë në rregull siç janë, dhe e njëjta palë nuk sinjalizohet më për të njëjtën arsye.
- Një sinjalizim e sheh vetëm kush mund t'i shohë të dy zërat.
Konektorët
Një konektor mban në bazën e njohurive shumë faqe nga një burim i vetëm, secilën faqe si një zë lidhjeje në nivelin e konektorit, dhe i mban të përditësuara kur burimi ndryshon.
| Lloji | Çfarë lexon |
|---|---|
| site | Faqen që jep dhe faqet ku ajo lidhet në të njëjtin host dhe nën të njëjtën shteg, pa atë që ndalon robots.txt i faqes |
| sitemap | Çdo faqe që rendit një sitemap, ose një indeks sitemap-esh dhe deri në 5 nga sitemap-et e tij |
| feed | Hyrjet e një feed-i RSS ose Atom |
| zendesk | Artikujt e publikuar të një qendre ndihme Zendesk, nga adresa e saj si https://example.zendesk.com |
- Sinkronizimi i parë nis brenda një minute. Pas kësaj sinkronizohet sërish çdo 7 ditë, ose çdo 1 ose 30 ditë, ose vetëm kur kërkon një sinkronizim, që gjithashtu nis brenda një minute.
- Mban deri në 25 faqe, ose aq sa cakton ti deri në 200, dhe zërat e tij llogariten në kuotën e planit. Një sinkronizim ndalon së shtuari faqe sapo arrihet kuota.
- Çdo sinkronizim shton faqet e reja, lexon sërish ato që kanë ndryshuar dhe heq zërat e faqeve që nuk janë më në burim.
- Një faqe që e ke shtuar vetë si lidhje në të njëjtin nivel mbetet me atë zë, dhe fshirja e një konektori heq vetëm zërat që shtoi ai.
- Zhvendosja e një konektori në një nivel tjetër zhvendos edhe zërat e tij.
Lidhje që mbeten të përditësuara
Një lidhje mund të lexohet sërish vetë çdo 1, 7 ose 30 ditë: cakto refreshDays kur e shton, ose më vonë. Kur faqja ka ndryshuar, teksti i saj i ri zëvendëson të vjetrin sapo lexohet, dhe deri atëherë AI-ja vazhdon të përdorë tekstin e vjetër. nextRefreshAt tregon kur lexohet herën tjetër, dhe një faqe që nuk mund të merret provohet sërish të nesërmen.
Ruajtja e një shënimi nga një bisedë
AI-ja mund të lexojë një bisedë dhe të hartojë një shënim me faktet prej saj që ekipi do t'i duhen sërish, pa të dhëna personale dhe pa atë që vlen vetëm për atë bisedë. Asgjë nuk ruhet derisa ta mbash: lexo draftin, ndryshoje si të duash dhe ruaje si shënim, i cili regjistron te threadId bisedën nga vjen.
Drafti sugjeron një nivel: domenin ku mbërriti biseda nëse mund të shtosh zëra atje, përndryshe të gjithë hapësirën e punës ose adresën. Çdo draft është një veprim AI. Nga kodi, harto me POST /knowledge/drafts, që kërkon threads:read përveç knowledge:write, dhe ruaj me POST /knowledge/notes dhe të njëjtin threadId.
Renditja e re e rezultateve të kërkimit
Një kërkim gjen pjesë sipas kuptimit dhe sipas fjalëve. Dërgo rerank: true me POST /knowledge/search dhe AI-ja lexon edhe 25 pjesët më të mira dhe i vendos në rendin që i përgjigjet më mirë pyetjes, duke lënë jashtë ato që nuk ndihmojnë. Kjo shton një ose dy sekonda dhe është një veprim AI, ndaj ndodh vetëm kur e kërkon. reranked në përgjigje tregon nëse ndodhi, dhe kur nuk përfundon në kohë, pjesët ruajnë rendin e zakonshëm.
Statistikat e përdorimit
GET /knowledge/stats tregon si e përdori AI-ja bazën e njohurive në 30 ditët e fundit, ose deri në 90 kur e kërkon.
- Sa herë një sugjerim përgjigjeje, një draft, asistenti ose një kërkim gjeti diçka, sa herë kërkoi dhe nuk gjeti asgjë, dhe pjesa që gjeti diçka, ditë pas dite.
- Ku ndodhën këto përdorime:
compose,reply,chat,tooldhesearch. - Zërat më të përdorur, dhe sa zëra gati nuk janë përdorur kurrë. Çdo zë mban numrin e vet te
uses, melastUsedAtsi përdorimin e fundit. - Sa sugjerime dhe pyetje presin shqyrtim, dhe sa sinjalizime janë të hapura.
Fikja e të mësuarit
Cilësimi i hapësirës së punës knowledgeLearning është i ndezur si parazgjedhje. Fike me PATCH /settings dhe { "knowledgeLearning": false } dhe AI-ja ndalon së lexuari përgjigjet e dërguara për fakte që të sugjerojë, ndalon së shënuari pyetje nga posta hyrëse dhe ndalon së kontrolluari zërat për kundërthënie. Dublikatat vazhdojnë të sinjalizohen, dhe ajo që është sugjeruar tashmë mbetet që ta pranosh ose ta hedhësh poshtë.
Kush mund ta lexojë dhe ndryshojë
- Leximi kërkon
knowledge:readdhe ndryshimiknowledge:write, që përfshin leximin. Rolet e integruara Admin, Member dhe Developer mund të ndryshojnë zëra, Viewer mund t'i lexojë, dhe Billing nuk i arrin. - Ndryshimi i një zëri kërkon arritje te çdo adresë që mbulon niveli i tij: e gjithë hapësira e punës kërkon çdo adresë, një domen të gjithë domenin, dhe një adresë atë adresë. Një çelës ose një aplikacion i kufizuar në adresa të caktuara mund të ndryshojë zëra vetëm në ato adresa, ose në domenet që i mban të plota.
- Kush është i kufizuar në adresa të caktuara lexon zërat e gjithë hapësirës së punës dhe zërat në adresat e tij dhe në domenet e atyre adresave. Asistenti dhe veglat MCP që veprojnë për të shtojnë dhe ndryshojnë zëra vetëm në adresat nga të cilat ai mund të dërgojë.
Privatësia
- Teksti i çdo zëri është i enkriptuar kur ruhet: përmbajtja e një shënimi, teksti i lexuar nga një skedar ose një faqe, dhe çdo pjesë. Fjalët që krahason kërkimi me fjalë ruhen si hash-e me çelës, jo si fjalë.
- Skedarët kthehen në tekst dhe faqet e uebit i lexon OpenEmail. Politika e privatësisë rendit çdo shërbim që përpunon të dhënat tuaja.
- Për kërkimin sipas kuptimit, çdo pjesë dhe çdo pyetje kthehet në një vektor: një listë numrash që përshkruan për çfarë bëhet fjalë. Vektorët ruhen të pakriptuar pranë tekstit të kriptuar, ashtu si në kërkimin sipas kuptimit në postë.
- Pjesët që përdor një prompt shkojnë te modeli i AI-së që shkruan përgjigjen, draftin ose replikën, ashtu si pjesa tjetër e prompt-it.
- Fshirja e një zëri heq njëherësh skedarin, tekstin dhe pjesët e tij. Baza e njohurive është pjesë e eksportit të hapësirës së punës, dhe fshirja e hapësirës së punës e fshin atë.
- Sa kohë që të mësuarit është i ndezur, modeli AI lexon çdo përgjigje të dërguar në një bisedë, me mesazhin të cilit i përgjigjet, për të sugjeruar shënime, dhe lexon dy zëra të lidhur ngushtë për t'i kontrolluar për kundërthënie. Cilësimi
knowledgeLearningi fik të dyja.
Nga kodi, terminali dhe agjentët
Gjithçka më sipër gjendet në REST API nën /knowledge, në SDK-të si openemail.knowledge (TypeScript) dhe client.knowledge (Python, Ruby dhe PHP), në CLI si openemail knowledge, dhe te veglat MCP. Një çelës ka nevojë për knowledge:read për të lexuar dhe për knowledge:write për të ndryshuar zëra.