Koble Outline-wikien din (selvhostet eller getoutline.com-sky) til ReplyRabbit slik at AI-utkast kan trekke på teamets kunnskapsbase. Outline-sider forblir interne som standard: brukes til å hjelpe med å skrive svar, men vises aldri eller lenkes til kunder, med mindre du eksplisitt merker sider som kundevisbare.
Bruk dette når teamet ditt holder kunnskap i Outline i stedet for FreeScout Knowledge Base-modulen. Hvis du bruker FreeScout-modulen, se Hvordan koble til FreeScout-kunnskapsbasen din. Outline fungerer godt sammen med ReplyRabbit fordi:
Du kontrollerer sidetilgang via Outline-tillatelser, og ReplyRabbit leser bare det tjenestebrukeren din har tilgang til.
Sider holdes utenfor kundesvar som standard, så dine interne runbooks og leverandørinformasjon lekker aldri inn i utkast.
Én synkronisering per dag pluss manuell «Synkroniser nå» holder ReplyRabbit oppdatert uten sanntids-webhooks.
Hvis Outline ligger bak en SSO-proxy (Cloudflare Access, Authentik, oauth2-proxy), må du kanskje justere proxyinnstillingene eller bruke Outlines interne adresse.
Oppsettsti
Opprett en tjenestebruker
I identitetsleverandøren din (SSO-systemet ditt), opprett en dedikert brukerkonto som replyrabbit@yourcompany.com. Denne kontoen blir ReplyRabbits "øyne" inne i Outline.
Logg inn én gang på Outline
La den tjenestebrukeren logge på Outline gjennom din vanlige SSO-flyt. Kontoen må finnes i Outline før den kan opprette en API-nøkkel.
Gi tilgang i Outline
Del Outline-samlingene eller -sidene du vil at ReplyRabbit skal bruke med den tjenestebrukeren. Del dem på samme måte som du gir tilgang til et hvilket som helst verktøy som Onyx eller interne wikier. Ikke gjør brukeren til administrator; et vanlig medlem med tilgang til bestemte samlinger er nok.
Opprett en API-nøkkel
Logg inn på Outline som den tjenestebrukeren. Åpne Innstillinger, deretter API og tilgang under Account, og klikk Ny API-nøkkel. 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.Personlige API-nøkler ligger under dine egne kontoinnstillinger, ikke arbeidsområdets.Gi nøkkelen navn ReplyRabbit, skriv read i Omfang, og sett Utløp til "No expiration". Outlines standard er 30 dager, og synkroniseringen stopper når nøkkelen utløper. Klikk Opprett og kopier nøkkelen.Lesetilgangen dekker alt ReplyRabbit trenger og blokkerer alle skrivinger.
Åpne ReplyRabbit-innstillinger
I FreeScout, gå til postkasseinnstillingene og finn "Dokumentasjonskilder" under ReplyRabbit.
Legg til Outline-kilde
Klikk "Legg til Outline-kilde". Lim inn Outline-URL-en din (for eksempel, https://wiki.company.com eller din getoutline.com-arbeidsområde-URL) og API-nøkkelen du nettopp kopierte.
Velg hva som skal synkroniseres
Etter at du har limt inn URL-en og nøkkelen, klikker du "Test connection". Den viser hvilken Outline-bruker nøkkelen tilhører, slik at du kan sjekke at det er tjenestebrukeren og ikke en persons nøkkel. Velg deretter enten "Everything this key can read" (anbefalt, samsvarer med Outlines egne tillatelser) eller "Only specific collections or pages", og merk dem i treet eller lim inn en samling eller sidelink.
Synkroniser og test
Lagre innstillingene dine. Lagring av en ny kilde, eller endring av adressen, nøkkelen eller omfanget, starter en synkronisering med en gang. Etter det synkroniseres den daglig, og «Synkroniser nå» på kilden kjører en når du vil. Test deretter et utkast for å bekrefte at ReplyRabbit kan bruke innholdet.
Personvern og sikkerhet
Outline-sider er interne som standard. Sidetekst lagres i FreeScout og sendes til AI-leverandøren din og embedding-leverandøren (vanligvis samme leverandør som du bruker til utkast). Sider siteres aldri ord for ord eller lenkes til i kundesvar med mindre du slår på "Kunder kan se disse sidene" for kilder der hver valgte side er trygg å dele.
Slå bare på «Kunder kan se disse sidene» hvis:
Hver valgte side åpnes og vises riktig uten å kreve innlogging.
Innholdet er egnet for kunder (ingen interne driftsdetaljer, leverandørinformasjon eller ansattinstruksjoner).
Del bare det som trengs. Hvis du deler hele Outline-arbeidsområdet med ReplyRabbit, blir alt tjenestebrukeren kan lese tilgjengelig for AI-en og lagret i FreeScout. Del bestemte samlinger eller sider i stedet, på samme måte som du ville begrenset tilgangen for et hvilket som helst annet verktøy.
Håndtering av interne nettverksadresser
Hvis Outline kjører på en privat IP-adresse eller internt vertsnavn (som outline.internal.company.com), slå på "Outline er på vårt interne nettverk" når du legger til kilden. Dette lar ReplyRabbit:
Nå private IP-adresser (10.x.x.x, 192.168.x.x, 172.16.x.x til 172.31.x.x)
Løs opp interne vertsnavn via nettverkets DNS
Bruk HTTP (ukryptert) kun på private adresser
Offentlige adresser krever fortsatt HTTPS, selv med dette alternativet på. Hvis Outline bruker HTTPS med et sertifikat fra din egen interne CA, må FreeScout-serverens tillitslager inkludere dette CA-sertifikatet.
Håndtering av SSO-proxyer
Outlines egen pålogging: Hvis teamet ditt logger på Outline via Google, Microsoft, Slack, OIDC eller e-postlenker administrert av Outline selv, trengs ingen ekstra oppsett. API-nøkkelen omgår påloggingsflyten.
SSO-proxy foran Outline: Hvis noe som Cloudflare Access, Authentik eller oauth2-proxy ligger foran Outline og fanger opp forespørsler, kan ikke ReplyRabbit nå API-et. Du vil se en feilmelding som sier "Noe foran Outline ber om pålogging."
Fiks dette ved å velge én av disse tilnærmingene:
Omgå proxyen for /api/ bare. Konfigurer proxyen din slik at FreeScout-serveren kan nå /api/* direkte uten innloggingskontrollen. De fleste proxyer støtter banebaserte eller IP-baserte omgåelsesregler. Se dokumentasjonen for proxyen din for innstillingen.
Bruk Outline sin interne adresse. Hvis Outline har en privat IP eller internt vertsnavn som hopper over proxyen, bruk det i ReplyRabbit i stedet. Du må slå på "Outline er på vårt interne nettverk" for private adresser.
Hvis du ikke kan omgå proxyen, kontakt administratoren din for å aktivere ett av disse alternativene for ReplyRabbits server.
Feilsøking
"Outline begrenser forespørsler. Det prøves igjen ved neste planlagte kjøring." Outline ba ReplyRabbit om å senke farten. Synkroniseringen ventet allerede så lenge Outline ba om og prøvde på nytt, og Outline var fortsatt opptatt, så den prøver igjen ved neste daglige synkronisering. Sider som allerede var indeksert, forblir tilgjengelige i mellomtiden. For å prøve på nytt tidligere, klikk "Synkroniser nå" igjen om noen minutter.
"Denne Outline-versjonen er for gammel. Oppdater Outline til 0.87 eller nyere, og test tilkoblingen igjen." Din selvhostede Outline mangler en API-metode som ReplyRabbit trenger. Oppgrader den til versjon 0.87 eller nyere, og klikk deretter "Test connection" igjen.
"Denne kilden er av. Slå på "Bruk denne kilden", lagre og synkroniser den." Outline-kilden er slått av. Kryss av "Bruk denne kilden", lagre innstillingene, og klikk deretter "Synkroniser nå".
"Outline avviste den API-nøkkelen." API-nøkkelen er ugyldig eller har blitt tilbakekalt. Generer en ny nøkkel i Outline Settings > API med read omfang.
"Kunne ikke nå Outline. Sjekk URL-en og prøv igjen." URL-en er feil, eller ReplyRabbit får ikke kontakt med serveren. Bekreft:
URL-en er riktig (for eksempel, https://wiki.company.com, ikke forsiden eller en bestemt side).
Hvis Outline er på en privat IP eller internt vertsnavn, slå på "Outline er på vårt interne nettverk".
Hvis Outline ligger bak en SSO-proxy, sjekk avsnittet "Håndtering av SSO-proxyer" ovenfor.
"Skriv inn Outline API-nøkkelen først." Lim inn API-nøkkelen i feltet før du tester eller synkroniserer.
"Outline-kunnskapskilden er en Team-funksjon." Din nåværende plan inkluderer ikke Outline-integrasjon. Oppgrader til Team-planen for å bruke denne funksjonen.
Minimum Outline-versjon
Selvhostet Outline trenger versjon 0.87 eller nyere (testet på 1.0 til 1.10). Eldre versjoner mangler en del av API-et som ReplyRabbit bruker til å lese sidetrær. Test tilkobling sjekker for det manglende sidetre-API-et. Hvis den rapporterer en gammel versjon, oppdater Outline først.
Skyversjonen på getoutline.com er alltid oppdatert og støttet.
Bytte kilder senere
Flytte til et offentlig dokumentasjonsnettsted: Hvis du senere vil bytte til et offentlig nettsted (i stedet for å holde Outline internt), legg til en nettsteddokumentasjonskilde og deaktiver eller fjern Outline-kilden når du er klar. Begge kan kjøre side om side under flyttingen. Hvis du fjerner en Outline-kilde, skjules sidene fra utkast og slettes fra ReplyRabbits lagring.
Nedgradering fra Team: Hvis du nedgraderer fra Team-planen, blir Outline-kildene og API-innstillingene dine liggende i databasen, men de synkroniserte sidene slettes og blir utilgjengelige for utkastgjenfinning. Kildekonfigurasjonen din bevares, så når du oppgraderer tilbake til Team, kan du synkronisere dem igjen uten å angi URL og API-nøkkel på nytt.