From bed2399d7e3c8eae6f63f1017e6a0183482be688 Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 2 Oct 2025 14:40:23 -0400 Subject: [PATCH 1/2] add indexing example, take out some accordions --- .../ask-fern/pages/features/slack-app.mdx | 58 ++++++++++++++----- 1 file changed, 45 insertions(+), 13 deletions(-) diff --git a/fern/products/ask-fern/pages/features/slack-app.mdx b/fern/products/ask-fern/pages/features/slack-app.mdx index 62a668567..7e4dea672 100644 --- a/fern/products/ask-fern/pages/features/slack-app.mdx +++ b/fern/products/ask-fern/pages/features/slack-app.mdx @@ -11,8 +11,7 @@ Fern stores all questions and answers from Slack interactions for [analytics pur Install the Ask Fern app and add the bot to customer channels. - - +### Install for your organization To install Ask Fern in your organization's Slack workspace, you must be a Slack admin. Follow these steps: @@ -23,8 +22,7 @@ To install Ask Fern in your organization's Slack workspace, you must be a Slack Allow Ask Fern for Slack workspace - - +### Enable for customer workspaces To give customers access to the Ask Fern bot in their own Slack workspaces: @@ -41,15 +39,12 @@ To give customers access to the Ask Fern bot in their own Slack workspaces: 1. Once the customer has installed the Ask Fern app, you must add the bot to your customer Slack channel to give it access. Once added, customers will see that `@Ask Fern was added to the channel`. They can start asking questions immediately. - - ## Configuration Customize the bot's behavior to match your workflow needs. - - +### Bot settings per channel Use the `/configure` slash command in any channel to adjust the settings: @@ -64,8 +59,7 @@ Use the `/configure` slash command in any channel to adjust the settings: Respond all setting in Slack - - +### Customize the bot name You can rename the bot to match your brand (example: "YourCompanyName Support"): @@ -80,8 +74,8 @@ You can rename the bot to match your brand (example: "YourCompanyName Support"): Now customers will see `@YourCompanyName Support was added to the channel` instead of the default `@Ask Fern` name. - - + +### Improve responses with indexing You can improve the Slack bot's knowledge base by teaching it from real customer interactions. When the bot provides answers in Slack, you can refine those responses and save them for future reference. @@ -96,8 +90,46 @@ How it works: Once indexed, Ask Fern will use this curated question-answer pair to inform future responses to similar questions, giving more accurate answers over time. + + + +**User –** *@PlantSupport* what's the best way to care for succulents +indoors? + +**Plant Support bot –** Succulents need bright, indirect light and should be watered every 2-3 weeks. Make sure the soil dries out completely between waterings. + +**Support Lead –** *@PlantSupport* This is good but you should mention drainage holes and the +risk of root rot. Also, watering frequency depends on the season - less in +winter. Let's index this thread. + +**Plant Support bot:** I'd be happy to help you index this thread! Let me work +with you to create a clear Q&A pair for your knowledge base. Based on the +conversation, the main question is about caring for indoor succulents. Let me +draft an improved Q&A pair: + +Question: "What's the best way to care for succulents indoors?" + +Ideal Response: + +Succulents thrive indoors with the following care:* + +- Light: Provide bright, indirect sunlight (6+ hours daily near a south or east-facing window) +- Watering: Water thoroughly every 2-3 weeks during spring and summer, +reducing to once a month in winter. Always wait until the soil is +completely dry between waterings +- Drainage: Use pots with drainage holes and well-draining soil +(cactus/succulent mix) to prevent root rot +- Warning: Overwatering is the most common cause of succulent death. Root rot +develops quickly in waterlogged soil + +Does this capture the question and response accurately? Would you like me to adjust anything before saving it to your knowledge base? + +**Support Lead:** *@PlantSupport* Perfect! Please save this. + +**Plant Support bot –** Successfully indexed! This Q&A pair has been added to your knowledge base and will be used to inform future responses about indoor succulent care. + - + ## Architecture From ef740fae2dd08156b30132f6d6d2d83c233718bd Mon Sep 17 00:00:00 2001 From: Devin Logan Date: Thu, 2 Oct 2025 15:06:43 -0400 Subject: [PATCH 2/2] wording updates --- fern/products/ask-fern/pages/features/slack-app.mdx | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/fern/products/ask-fern/pages/features/slack-app.mdx b/fern/products/ask-fern/pages/features/slack-app.mdx index 7e4dea672..0bc98b300 100644 --- a/fern/products/ask-fern/pages/features/slack-app.mdx +++ b/fern/products/ask-fern/pages/features/slack-app.mdx @@ -75,7 +75,7 @@ You can rename the bot to match your brand (example: "YourCompanyName Support"): Now customers will see `@YourCompanyName Support was added to the channel` instead of the default `@Ask Fern` name. -### Improve responses with indexing +### Collaborative FAQ generation You can improve the Slack bot's knowledge base by teaching it from real customer interactions. When the bot provides answers in Slack, you can refine those responses and save them for future reference. @@ -136,7 +136,6 @@ Does this capture the question and response accurately? Would you like me to adj When a user asks Ask Fern a question in Slack, a webhook triggers Fern's servers to search your documentation database and retrieve relevant context. Using that context, Ask Fern generates a response. - ```mermaid sequenceDiagram autonumber