Anslut din Outline-wiki (självhostad eller getoutline.com-moln) till ReplyRabbit så att AI-utkast kan dra nytta av ditt teams kunskapsbas. Outline-sidor förblir interna som standard: de används för att hjälpa till att skriva svar men visas eller länkas aldrig till kunder, om du inte uttryckligen markerar sidor som kundvisningsbara.
Använd detta när ditt team har kunskap i Outline istället för FreeScout Knowledge Base-modulen. Om du använder FreeScout-modulen, se Hur du ansluter din FreeScout Knowledge Base. Outline fungerar bra tillsammans med ReplyRabbit eftersom:
Du styr sidåtkomst via Outline-behörigheter, och ReplyRabbit läser bara det din tjänsteanvändare kan komma åt.
Sidor hålls utanför kundsvar som standard, så dina interna runbooks och leverantörsinformation läcker aldrig in i utkast.
En synkronisering per dag plus manuell "Synkronisera nu" håller ReplyRabbit aktuell utan webhooks i realtid.
Om din Outline ligger bakom en SSO-proxy (Cloudflare Access, Authentik, oauth2-proxy) kan du behöva justera dina proxyinställningar eller använda Outlines interna adress.
Konfigurationsväg
Skapa en tjänsteanvändare
I din identitetsleverantör (ditt SSO-system), skapa ett dedikerat användarkonto som replyrabbit@yourcompany.com. Detta konto blir ReplyRabbits "ögon" inuti Outline.
Logga in en gång på Outline
Låt den tjänsteanvändaren logga in på Outline via ditt vanliga SSO-flöde. Kontot måste finnas i Outline innan det kan skapa en API-nyckel.
Bevilja åtkomst i Outline
Dela de Outline-samlingar eller sidor som du vill att ReplyRabbit ska använda med den tjänsteanvändaren. Dela dem på samma sätt som du skulle ge åtkomst till vilket verktyg som helst, som Onyx eller interna wikier. Gör inte användaren till administratör; en vanlig medlem med åtkomst till specifika samlingar räcker.
Skapa en API-nyckel
Logga in på Outline som den tjänsteanvändaren. Öppna Inställningar och sedan API och åtkomst under Account och klicka Ny API-nyckel. 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.Personliga API-nycklar finns under dina egna kontoinställningar, inte arbetsytans.Namnge nyckeln ReplyRabbit, skriv read i Omfattningar, och ange Utgång till "No expiration". Outlines standard är 30 dagar, och synkroniseringen stoppas när nyckeln löper ut. Klicka Skapa och kopiera nyckeln.Läsbehörigheten täcker allt ReplyRabbit behöver och blockerar alla skrivningar.
Öppna ReplyRabbit-inställningar
I FreeScout, gå till brevlådeinställningarna och hitta "Dokumentationskällor" under ReplyRabbit.
Lägg till Outline-källa
Klicka på "Lägg till Outline-källa". Klistra in din Outline-URL (till exempel, https://wiki.company.com eller din getoutline.com-arbetsyta-URL) och API-nyckeln du just kopierade.
Välj vad som ska synkroniseras
Efter att ha klistrat in URL:en och nyckeln klickar du på "Test connection". Den visar vilken Outline-användare nyckeln tillhör, så du kan kontrollera att det är tjänsteanvändaren och inte en persons nyckel. Välj sedan antingen "Everything this key can read" (rekommenderas, matchar Outlines egna behörigheter) eller "Only specific collections or pages", och markera dem i trädet eller klistra in en samlings- eller sidlänk.
Synka och testa
Spara dina inställningar. Att spara en ny källa, eller ändra dess adress, nyckel eller omfattning, startar en synkronisering direkt. Därefter synkroniseras den dagligen, och "Synkronisera nu" på källan kör en när du vill. Testa sedan ett utkast för att bekräfta att ReplyRabbit kan använda innehållet.
Integritet och säkerhet
Outline-sidor är interna som standard. Sidtext lagras i FreeScout och skickas till din AI-leverantör och embedding-leverantör (vanligtvis samma leverantör som du använder för utkast). Sidor citeras aldrig ordagrant eller länkas till i kundsvar om du inte aktiverar "Kunder kan se dessa sidor" för källor där varje vald sida är säker att dela.
Aktivera endast "Kunder kan se dessa sidor" om:
Varje vald sida öppnas och visas korrekt utan att kräva inloggning.
Innehållet är lämpligt för kunder (inga interna driftdetaljer, leverantörsinformation eller personalinstruktioner).
Dela bara det som behövs. Om du delar hela Outline-arbetsytan med ReplyRabbit blir allt som tjänsteanvändaren kan läsa tillgängligt för AI:n och lagras i FreeScout. Dela specifika samlingar eller sidor i stället, på samma sätt som du skulle begränsa åtkomsten för något annat verktyg.
Hantering av interna nätverksadresser
Om din Outline körs på en privat IP-adress eller ett internt värdnamn (som outline.internal.company.com), slå på "Outline finns på vårt interna nätverk" när du lägger till källan. Detta gör att ReplyRabbit kan:
Nå privata IP-adresser (10.x.x.x, 192.168.x.x, 172.16.x.x till 172.31.x.x)
Lös interna värdnamn via ditt nätverks DNS
Använd HTTP (okrypterat) endast på privata adresser
Offentliga adresser kräver fortfarande HTTPS, även med det här alternativet på. Om din Outline använder HTTPS med ett certifikat från din egen interna CA måste FreeScout-serverns trust store innehålla det CA-certifikatet.
Hantering av SSO-proxyservrar
Outlines egen inloggning: Om ditt team loggar in på Outline via Google, Microsoft, Slack, OIDC eller e-postlänkar som hanteras av Outline självt krävs ingen extra konfiguration. API-nyckeln kringgår inloggningsflödet.
SSO-proxy framför Outline: Om något som Cloudflare Access, Authentik eller oauth2-proxy ligger framför Outline och fångar upp begäranden kan ReplyRabbit inte nå API:et. Du ser ett felmeddelande som säger "Något framför Outline begär inloggning."
Åtgärda detta genom att välja ett av dessa tillvägagångssätt:
Kringgå proxyn för /api/ endast. Konfigurera din proxy så att FreeScout-servern kan nå /api/* direkt utan inloggningskontrollen. De flesta proxyservrar stöder sökvägsbaserade eller IP-baserade undantagsregler. Se din proxys dokumentation för inställningen.
Använd Outlines interna adress. Om din Outline har en privat IP-adress eller ett internt värdnamn som kringgår proxyn, använd det i ReplyRabbit i stället. Du måste aktivera "Outline finns på vårt interna nätverk" för privata adresser.
Om du inte kan kringgå proxyn, kontakta din administratör för att aktivera ett av dessa alternativ för ReplyRabbits server.
Felsökning
"Outline begränsar förfrågningar. Det försöker igen vid nästa schemalagda körning." Outline bad ReplyRabbit att sakta ner. Synkroniseringen väntade redan så länge Outline bad om och försökte igen, och Outline var fortfarande upptagen, så den försöker igen vid nästa dagliga synkronisering. Sidor som redan indexerats finns kvar under tiden. För att försöka igen tidigare klickar du på "Synkronisera nu" igen om några minuter.
"Den här Outline-versionen är för gammal. Uppdatera Outline till 0.87 eller senare och testa sedan anslutningen igen." Din egenhostade Outline saknar en API-metod som ReplyRabbit behöver. Uppgradera den till version 0.87 eller senare och klicka sedan på "Test connection" igen.
"Den här källan är avstängd. Slå på "Använd den här källan", spara och synkronisera den." Outline-källan är avstängd. Kryssa i "Använd denna källa", spara inställningarna och klicka sedan på "Synka nu".
"Outline avvisade den API-nyckeln." API-nyckeln är ogiltig eller har återkallats. Generera en ny nyckel i Outline Settings > API med read omfattning.
"Kunde inte nå Outline. Kontrollera URL:en och försök igen." URL:en är fel, eller så kan ReplyRabbit inte nå servern. Bekräfta:
URL:en är korrekt (till exempel, https://wiki.company.com, inte startsidan eller en specifik sida).
Om Outline finns på en privat IP-adress eller ett internt värdnamn, aktivera "Outline finns på vårt interna nätverk".
Om Outline ligger bakom en SSO-proxy, se avsnittet "Hantering av SSO-proxyservrar" ovan.
"Ange Outline API-nyckeln först." Klistra in API-nyckeln i fältet innan du testar eller synkroniserar.
"Outline-kunskapskällan är en Team-funktion." Din nuvarande plan inkluderar inte Outline-integration. Uppgradera till Team-planen för att använda denna funktion.
Lägsta Outline-version
Självhostad Outline kräver version 0.87 eller senare (testad på 1.0 till 1.10). Äldre versioner saknar en del av API:et som ReplyRabbit använder för att läsa sidträd. Testa anslutning kontrollerar om sidträd-API:et saknas. Om den rapporterar en gammal version, uppdatera Outline först.
Molnversionen på getoutline.com är alltid uppdaterad och stöds.
Byta källor senare
Flytta till en offentlig dokumentationswebbplats: Om du senare vill byta till en offentlig webbplats (i stället för att hålla Outline internt), lägg till en dokumentationskälla för webbplats och inaktivera eller ta bort Outline-källan när du är redo. Båda kan köras sida vid sida under flytten. Att ta bort en Outline-källa döljer dess sidor från utkast och raderar dem från ReplyRabbits lagring.
Nedgradering från Team: Om du nedgraderar från Team-planen stannar dina Outline-källor och API-inställningar i databasen men de synkroniserade sidorna raderas och blir otillgängliga för utkastshämtning. Din källkonfiguration bevaras, så när du uppgraderar tillbaka till Team kan du synkronisera dem igen utan att ange URL och API-nyckel på nytt.