Tilslut din Outline-wiki (selvhostet eller getoutline.com cloud) til ReplyRabbit, så AI-kladder kan trække på dit teams vidensbase. Outline-sider forbliver interne som standard: brugt til at hjælpe med at skrive svar, men aldrig vist eller linket til kunder, medmindre du udtrykkeligt markerer sider som kundevisbare.
Brug dette, når dit team opbevarer viden i Outline i stedet for FreeScout Knowledge Base-modulet. Hvis du bruger FreeScout-modulet, se Sådan forbinder du din FreeScout Knowledge Base. Outline fungerer godt sammen med ReplyRabbit, fordi:
Du styrer sideadgang via Outline-tilladelser, og ReplyRabbit læser kun det, din servicebruger har adgang til.
Sider holdes som standard ude af kundesvar, så dine interne runbooks og leverandøroplysninger aldrig lækker ind i udkast.
Én synkronisering om dagen plus manuel "Sync now" holder ReplyRabbit opdateret uden realtids-webhooks.
Hvis din Outline er bag en SSO-proxy (Cloudflare Access, Authentik, oauth2-proxy), kan du muligvis skulle justere dine proxyindstillinger eller bruge Outlines interne adresse.
Opsætningssti
Opret en servicebruger
I din identitetsudbyder (dit SSO-system) skal du oprette en dedikeret brugerkonto som replyrabbit@yourcompany.com. Denne konto bliver ReplyRabbits "øjne" inde i Outline.
Log ind én gang på Outline
Lad den servicebruger logge ind i Outline via din normale SSO-flow. Kontoen skal findes i Outline, før den kan oprette en API-nøgle.
Giv adgang i Outline
Del de Outline-samlinger eller -sider, du vil have ReplyRabbit til at bruge med den servicebruger. Del dem på samme måde, som du ville give adgang til ethvert værktøj som Onyx eller interne wikier. Gør ikke brugeren til admin; et almindeligt medlem med adgang til specifikke samlinger er nok.
Opret en API-nøgle
Log ind på Outline som den servicebruger. Åbn Indstillinger, og derefter API og adgang under Account, og klik Ny API-nøgle. 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øgler ligger under dine egne kontoindstillinger, ikke arbejdsområdets.Navngiv nøglen ReplyRabbit, skriv read i Scopes, og angiv Udløb til "No expiration". Outlines standard er 30 dage, og synkronisering stopper, når nøglen udløber. Klik Opret og kopier nøglen.Læsetilladelsen dækker alt, hvad ReplyRabbit har brug for, og blokerer alle skrivninger.
Åbn ReplyRabbit-indstillinger
I FreeScout skal du gå til postkasseindstillingerne og finde "Dokumentationskilder" under ReplyRabbit.
Tilføj Outline-kilde
Klik på "Add Outline source". Indsæt din Outline-URL (for eksempel, https://wiki.company.com eller din getoutline.com workspace-URL) og den API-nøgle, du netop har kopieret.
Vælg, hvad der skal synkroniseres
Når du har indsat URL'en og nøglen, skal du klikke på "Test connection". Den viser, hvilken Outline-bruger nøglen tilhører, så du kan kontrollere, at det er servicebrugeren og ikke en persons nøgle. Vælg derefter enten "Everything this key can read" (anbefalet, matcher Outlines egne tilladelser) eller "Only specific collections or pages", og markér dem i træet eller indsæt et collection- eller sidelink.
Synkroniser og test
Gem dine indstillinger. Når du gemmer en ny kilde eller ændrer dens adresse, nøgle eller scope, starter en synkronisering med det samme. Derefter synkroniserer den dagligt, og "Sync now" på kilden kører en, når du vil. Test derefter en kladde for at bekræfte, at ReplyRabbit kan bruge indholdet.
Privatliv og sikkerhed
Outline-sider er interne som standard. Sidetekst gemmes i FreeScout og sendes til din AI-udbyder og embedding-udbyder (normalt samme udbyder, som du bruger til udkast). Sider citeres aldrig ord for ord eller linkes til i kundesvar, medmindre du slår "Customers can see these pages" til for kilder, hvor hver valgt side er sikker at dele.
Slå kun "Customers can see these pages" til, hvis:
Hver valgt side åbner og vises korrekt uden at kræve login.
Indholdet er egnet til kunder (ingen interne driftsdetaljer, leverandøroplysninger eller medarbejderinstruktioner).
Del kun det nødvendige. Hvis du deler hele Outline-arbejdsområdet med ReplyRabbit, bliver alt, som tjenestebrugeren kan læse, tilgængeligt for AI'en og gemt i FreeScout. Del specifikke samlinger eller sider i stedet, på samme måde som du ville begrænse adgangen for ethvert andet værktøj.
Håndtering af interne netværksadresser
Hvis din Outline kører på en privat IP-adresse eller et internt værtsnavn (som outline.internal.company.com), slå "Outline er på vores interne netværk" til, når du tilføjer kilden. Dette giver ReplyRabbit mulighed for at:
Nå private IP-adresser (10.x.x.x, 192.168.x.x, 172.16.x.x til 172.31.x.x)
Løs interne værtsnavne via dit netværks DNS
Brug HTTP (ukrypteret) kun på private adresser
Offentlige adresser kræver stadig HTTPS, selv med denne indstilling slået til. Hvis din Outline bruger HTTPS med et certifikat fra din egen interne CA, skal din FreeScout-servers trust store inkludere det CA-certifikat.
Håndtering af SSO-proxier
Outlines egen login: Hvis dit team logger ind på Outline via Google, Microsoft, Slack, OIDC eller e-mail-links, der administreres af Outline selv, er der ikke behov for ekstra opsætning. API-nøglen omgår loginflowet.
SSO-proxy foran Outline: Hvis noget som Cloudflare Access, Authentik eller oauth2-proxy står foran Outline og opsnapper anmodninger, kan ReplyRabbit ikke nå API'et. Du vil se en fejlmeddelelse, der siger "Noget foran Outline beder om et login."
Ret dette ved at vælge en af disse tilgange:
Omgå proxyen for /api/ kun. Konfigurer din proxy, så FreeScout-serveren kan nå /api/* direkte uden login-kontrollen. De fleste proxies understøtter stibaserede eller IP-baserede bypass-regler. Se din proxys dokumentation for indstillingen.
Brug Outlines interne adresse. Hvis din Outline har en privat IP eller et internt værtsnavn, der springer proxyen over, skal du bruge det i ReplyRabbit i stedet. Du skal slå "Outline er på vores interne netværk" til for private adresser.
Hvis du ikke kan omgå proxyen, skal du kontakte din administrator for at aktivere en af disse muligheder for ReplyRabbits server.
Fejlfinding
"Outline begrænser antallet af anmodninger. Det prøver igen ved næste planlagte kørsel." Outline bad ReplyRabbit om at sænke farten. Synkroniseringen ventede allerede så længe, Outline bad om, og prøvede igen, og Outline var stadig optaget, så den prøver igen ved næste daglige synkronisering. Sider, der allerede var indekseret, forbliver tilgængelige i mellemtiden. For at prøve igen tidligere skal du klikke på "Sync now" igen om et par minutter.
"Denne Outline-version er for gammel. Opdater Outline til 0.87 eller nyere, og test derefter forbindelsen igen." Din selvhostede Outline mangler en API-metode, som ReplyRabbit har brug for. Opgrader den til version 0.87 eller nyere, og klik derefter på "Test connection" igen.
"Denne kilde er slået fra. Slå "Brug denne kilde" til, gem, og synkroniser den." Outline-kilden er slået fra. Sæt flueben i "Use this source", gem indstillingerne, og klik derefter på "Sync now".
"Outline afviste den API-nøgle." API-nøglen er ugyldig eller er blevet tilbagekaldt. Generer en ny nøgle i Outline Settings > API med read scope.
"Kunne ikke nå Outline. Tjek URL'en, og prøv igen." URL'en er forkert, eller ReplyRabbit kan ikke nå serveren. Bekræft:
URL'en er korrekt (for eksempel, https://wiki.company.com, ikke startsiden eller en bestemt side).
Hvis Outline er på en privat IP eller et internt værtsnavn, skal du slå "Outline er på vores interne netværk" til.
Hvis Outline er bag en SSO-proxy, skal du tjekke afsnittet "Håndtering af SSO-proxier" ovenfor.
"Indtast Outline API-nøglen først." Indsæt API-nøglen i feltet, før du tester eller synkroniserer.
"Outline-videnskilden er en Team-funktion." Dit nuværende abonnement inkluderer ikke Outline-integration. Opgrader til Team-abonnementet for at bruge denne funktion.
Minimum Outline-version
Selvhostet Outline kræver version 0.87 eller nyere (testet på 1.0 til 1.10). Ældre versioner mangler en del af den API, som ReplyRabbit bruger til at læse sidetræer. Test connection kontrollerer for den manglende page-tree-API. Hvis den rapporterer en gammel version, skal du opdatere Outline først.
Cloudversionen på getoutline.com er altid opdateret og understøttet.
Skift af kilder senere
Flyt til et offentligt dokumentationswebsted: Hvis du senere vil skifte til et offentligt websted (i stedet for at holde Outline internt), skal du tilføje en webstedsdokumentationskilde og deaktivere eller fjerne Outline-kilden, når du er klar. Begge kan køre side om side under flytningen. Fjernelse af en Outline-kilde skjuler dens sider fra kladder og sletter dem fra ReplyRabbits lager.
Nedgradering fra Team: Hvis du nedgraderer fra Team-planen, forbliver dine Outline-kilder og API-indstillinger i databasen, men de synkroniserede sider slettes og bliver utilgængelige for kladdehentning. Din kildekonfiguration bevares, så når du opgraderer tilbage til Team, kan du synkronisere dem igen uden at indtaste URL og API-nøgle på ny.