Yhdistä Outline-wikisi (itse ylläpidetty tai getoutline.com-pilvi) ReplyRabbitiin, jotta AI-luonnokset voivat hyödyntää tiimisi tietämyskantaa. Outline-sivut pysyvät oletuksena sisäisinä: niitä käytetään vastausten kirjoittamisen apuna, mutta niitä ei koskaan näytetä asiakkaille tai linkitetä niihin, ellet erikseen merkitse sivuja asiakkaalle näkyviksi.
Käytä tätä, kun tiimisi pitää tietämystä Outlinessa FreeScout Knowledge Base -moduulin sijaan. Jos käytät FreeScout-moduulia, katso Miten yhdistät FreeScout-tietopohjasi. Outline toimii hyvin yhdessä ReplyRabbitin kanssa, koska:
Hallitset sivun käyttöoikeuksia Outlinen käyttöoikeuksilla, ja ReplyRabbit lukee vain sen, mihin palvelukäyttäjäsi pääsee käsiksi.
Sivut pysyvät oletuksena poissa asiakasvastauksista, joten sisäiset runbookisi ja toimittajatietosi eivät koskaan vuoda luonnoksiin.
Yksi synkronointi päivässä sekä manuaalinen "Synkronoi nyt" pitää ReplyRabbitin ajan tasalla ilman reaaliaikaisia webhookeja.
Jos Outlinesi on SSO-välityspalvelimen takana (Cloudflare Access, Authentik, oauth2-proxy), sinun on ehkä mukautettava välityspalvelinasetuksiasi tai käytettävä Outlinen sisäistä osoitetta.
Asennuspolku
Luo palvelukäyttäjä
Luo identiteetintarjoajassasi (SSO-järjestelmässäsi) erillinen käyttäjätili, kuten replyrabbit@yourcompany.com. Tästä tilistä tulee ReplyRabbitin "silmät" Outlinen sisällä.
Kirjaudu kerran Outlineen
Anna kyseisen palvelukäyttäjän kirjautua Outlineen normaalin SSO-virtauksesi kautta. Tilin on oltava olemassa Outlinessa ennen kuin se voi luoda API-avaimen.
Myönnä pääsy Outlinessa
Jaa ne Outline-kokoelmat tai -sivut, jotka haluat ReplyRabbitin käyttävän kyseisen palvelukäyttäjän kanssa. Jaa ne samalla tavalla kuin antaisit käyttöoikeuden mihin tahansa työkaluun, kuten Onyx tai sisäiset wikis. Älä tee käyttäjästä ylläpitäjää; tavallinen jäsen, jolla on pääsy tiettyihin kokoelmiin, riittää.
Luo API-avain
Kirjaudu Outlineen kyseisenä palvelukäyttäjänä. Avaa Asetukset ja sitten API ja käyttöoikeudet kohdassa Account, ja napsauta Uusi API-avain. Older self-hosted versions call this page "API" or "API and Apps".The screenshots below show Outline's English interface; labels may be translated in your Outline workspace.Henkilökohtaiset API-avaimet sijaitsevat omissa tilin asetuksissasi, eivät työtilan asetuksissa.Nimeä avain ReplyRabbit, kirjoita read kohdassa Laajuudet, ja aseta Vanheneminen arvoon "No expiration". Outlinen oletus on 30 päivää, ja synkronointi pysähtyy, kun avain vanhenee. Napsauta Luo ja kopioi avain.Lukuoikeus kattaa kaiken, mitä ReplyRabbit tarvitsee, ja estää kaikki kirjoitukset.
Avaa ReplyRabbit-asetukset
Siirry FreeScoutissa postilaatikon asetuksiin ja etsi "Dokumentaation lähteet" kohdasta ReplyRabbit.
Lisää Outline-lähde
Napsauta "Add Outline source". Liitä Outline-URL-osoitteesi (esimerkiksi https://wiki.company.com tai getoutline.com-työtilasi URL-osoite) ja juuri kopioimasi API-avain.
Valitse, mitä synkronoidaan
Kun olet liittänyt URL-osoitteen ja avaimen, napsauta "Test connection". Se näyttää, mille Outline-käyttäjälle avain kuuluu, joten voit tarkistaa, että se on palvelukäyttäjän eikä henkilön avain. Valitse sitten joko "Everything this key can read" (suositeltu, vastaa Outlinen omia käyttöoikeuksia) tai "Only specific collections or pages" ja valitse ne puusta tai liitä kokoelman tai sivun linkki.
Synkronoi ja testaa
Tallenna asetuksesi. Uuden lähteen tallentaminen tai sen osoitteen, avaimen tai laajuuden muuttaminen käynnistää synkronoinnin heti. Sen jälkeen se synkronoituu päivittäin, ja lähteen "Synkronoi nyt" suorittaa yhden milloin tahansa. Testaa sitten luonnosta varmistaaksesi, että ReplyRabbit voi käyttää sisältöä.
Tietosuoja ja turvallisuus
Outline-sivut ovat oletuksena sisäisiä. Sivun teksti tallennetaan FreeScoutiin ja lähetetään AI-palveluntarjoajallesi ja embeddings-palveluntarjoajallesi (yleensä sama palveluntarjoaja, jota käytät luonnoksiin). Sivuja ei koskaan lainata sanasta sanaan tai linkitetä asiakasvastauksiin, ellet ota käyttöön "Customers can see these pages" -asetusta lähteille, joissa jokainen valittu sivu on turvallista jakaa.
Ota "Asiakkaat voivat nähdä nämä sivut" käyttöön vain, jos:
Jokainen valittu sivu avautuu ja näkyy oikein ilman kirjautumista.
Sisältö sopii asiakkaille (ei sisäisiä toimintatietoja, toimittajatietoja tai henkilöstöohjeita).
Jaa vain se, mitä tarvitaan. Jos jaat koko Outline-työtilan ReplyRabbitin kanssa, kaikki, mitä palvelukäyttäjä voi lukea, tulee AI:n saataville ja tallennetaan FreeScoutiin. Jaa sen sijaan tietyt kokoelmat tai sivut samalla tavalla kuin rajoittaisit pääsyä mille tahansa muulle työkalulle.
Sisäisten verkko-osoitteiden käsittely
Jos Outlinesi toimii yksityisessä IP-osoitteessa tai sisäisessä isäntänimessä (kuten outline.internal.company.com), kytke "Outline on sisäverkossamme" päälle, kun lisäät lähteen. Tämä sallii ReplyRabbitin:
Ratkaise sisäiset isäntänimet verkkosi DNS:n kautta
Käytä HTTP:tä (salaamatonta) vain yksityisissä osoitteissa
Julkiset osoitteet vaativat silti HTTPS:n, vaikka tämä asetus olisi päällä. Jos Outline-käyttösi käyttää HTTPS:ää oman sisäisen CA-varmenneviranomaisesi varmenteella, FreeScout-palvelimesi luottamusvarastoon on sisällytettävä kyseinen CA-varmenne.
SSO-välityspalvelimien käsittely
Outlinen oma kirjautuminen: Jos tiimisi kirjautuu Outlineen Googlen, Microsoftin, Slackin, OIDC:n tai Outlinen itsensä hallinnoimien sähköpostilinkkien kautta, lisämäärityksiä ei tarvita. API-avain ohittaa kirjautumisprosessin.
SSO-välityspalvelin Outlinen edessä: Jos jokin, kuten Cloudflare Access, Authentik tai oauth2-proxy, on Outlinen edessä ja sieppaa pyyntöjä, ReplyRabbit ei voi tavoittaa API:a. Näet virheilmoituksen "Jokin Outlinen edessä pyytää kirjautumista."
Korjaa tämä valitsemalla jokin näistä lähestymistavoista:
Ohita välityspalvelin kohteelle /api/ vain. Määritä välityspalvelimesi niin, että FreeScout-palvelin voi tavoittaa /api/* suoraan ilman kirjautumistarkistusta. Useimmat välityspalvelimet tukevat polku- tai IP-pohjaisia ohitussääntöjä. Tarkista asetus välityspalvelimesi dokumentaatiosta.
Käytä Outlinen sisäistä osoitetta. Jos Outlinessasi on yksityinen IP-osoite tai sisäinen isäntänimi, joka ohittaa välityspalvelimen, käytä sitä sen sijaan ReplyRabbitissä. Sinun on otettava käyttöön "Outline on sisäverkossamme" yksityisille osoitteille.
Jos et voi ohittaa välityspalvelinta, ota yhteyttä järjestelmänvalvojaasi ottaaksesi käyttöön yhden näistä vaihtoehdoista ReplyRabbitin palvelimelle.
Vianmääritys
"Outline rajoittaa pyyntöjä. Se yrittää uudelleen seuraavalla ajoitetulla ajolla." Outline pyysi ReplyRabbitia hidastamaan. Synkronointi odotti jo niin kauan kuin Outline pyysi ja yritti uudelleen, ja Outline oli edelleen varattu, joten se yrittää uudelleen seuraavassa päivittäisessä synkronoinnissa. Jo indeksoidut sivut pysyvät saatavilla sillä välin. Voit yrittää uudelleen aiemmin napsauttamalla "Sync now" uudelleen muutaman minuutin kuluttua.
"Tämä Outline-versio on liian vanha. Päivitä Outline versioon 0.87 tai uudempaan ja testaa yhteys uudelleen." Itse ylläpitämästäsi Outlinesta puuttuu API-metodi, jota ReplyRabbit tarvitsee. Päivitä se versioon 0.87 tai uudempaan ja napsauta sitten "Test connection" uudelleen.
"Tämä lähde on pois päältä. Kytke "Käytä tätä lähdettä" päälle, tallenna ja synkronoi se." Outline-lähde on pois päältä. Valitse "Use this source", tallenna asetukset ja napsauta sitten "Sync now".
"Outline hylkäsi kyseisen API-avaimen." API-avain on virheellinen tai peruutettu. Luo uusi avain Outline-asetuksissa > API kohdassa read laajuus.
"Outlinen tavoittaminen ei onnistunut. Tarkista URL-osoite ja yritä uudelleen." URL-osoite on väärä tai ReplyRabbit ei tavoita palvelinta. Vahvista:
URL-osoite on oikein (esimerkiksi https://wiki.company.com, ei etusivu tai tietty sivu).
Jos Outline on yksityisessä IP-osoitteessa tai sisäisessä isäntänimessä, ota käyttöön "Outline on sisäverkossamme".
Jos Outline on SSO-välityspalvelimen takana, tarkista yllä oleva osio "SSO-välityspalvelimien käsittely".
"Syötä ensin Outline API -avain." Liitä API-avain kenttään ennen testaamista tai synkronointia.
"Outline-tietolähde on Team-ominaisuus." Nykyinen tilauksesi ei sisällä Outline-integraatiota. Päivitä Team-tilaukseen käyttääksesi tätä ominaisuutta.
Outlinen vähimmäisversio
Itse isännöity Outline vaatii version 0.87 tai uudemman (testattu versioilla 1.0–1.10). Vanhemmista versioista puuttuu osa API:sta, jota ReplyRabbit käyttää sivupuiden lukemiseen. Testiyhteys tarkistaa puuttuvan sivupuu-API:n. Jos se ilmoittaa vanhasta versiosta, päivitä Outline ensin.
Pilviversio osoitteessa getoutline.com on aina ajan tasalla ja tuettu.
Lähteiden vaihtaminen myöhemmin
Siirtyminen julkiselle dokumentaatiosivustolle: Jos haluat myöhemmin vaihtaa julkiseen verkkosivustoon (sen sijaan että pitäisit Outlinen sisäisenä), lisää verkkosivuston dokumentaatiolähde ja poista Outline-lähde käytöstä tai poista se, kun olet valmis. Molemmat voivat toimia rinnakkain siirtymän aikana. Outline-lähteen poistaminen piilottaa sen sivut luonnoksista ja poistaa ne ReplyRabbitin tallennustilasta.
Alennus Teamista: Jos alennat Team-suunnitelmasta, Outline-lähteesi ja API-asetuksesi säilyvät tietokannassa, mutta synkronoidut sivut poistetaan, eivätkä ne ole käytettävissä luonnosten hakemiseen. Lähdemäärityksesi säilytetään, joten kun päivität takaisin Team-suunnitelmaan, voit synkronoida ne uudelleen syöttämättä URL-osoitetta ja API-avainta uudelleen.