agent hive

CUSTOMER SUPPORT

KB Search-Miss Miner: Route Doc Gaps to Engineering When No Article Exists

Daily, it joins help-center search queries that returned zero results with tickets that had no KB match, drafts an article when docs can fix it.

CategoryCustomer Support
Enginesim
Difficultyadvanced
Triggerschedule
Steps6
Setup~25 min

How it runs

The automated pipeline, trigger to output.

  • TriggerDaily schedule fires
  • ActionJoin zero-result searches with unanswered tickets in ZendeskZendeskZendesk
  • LogicClassify each gap as documentable or product issueOpenAI
  • ActionDraft article as Notion review page for doc gapsNotionNotion
  • ActionFile Linear issue for product gaps with evidenceLinearLinear
  • OutputPost triage digest to SlackSlack

What it does

Not every KB gap is solved by writing an article. This workflow distinguishes documentation gaps from product gaps: it cross-references failed help-center searches with unanswered tickets, drafts an article when the answer exists, and escalates to engineering when the real fix is a product change.

When to use it

Use it when failed searches and confused tickets point at the same topics, and you need to separate "we should document this" from "the product needs to change." Strong fit for teams who triage in Linear.

How it works

  1. 1A daily schedule triggers the run.
  2. 2It pulls zero-result help-center search queries from Zendesk and joins them with tickets that closed without a KB match.
  3. 3An OpenAI step classifies each clustered gap as documentable or a product/engineering issue.
  4. 4Documentable gaps get a drafted article created as a Notion review page.
  5. 5Product gaps get a Linear issue filed with the supporting ticket and search evidence.
  6. 6It posts a triage digest to Slack summarizing both branches.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect ZendeskTickets, queues, knowledge base.
  2. 2
    Connect OpenAIModels, embeddings, files.
  3. 3
    Connect NotionPages, databases, comments.
  4. 4
    Connect LinearIssues, projects, cycles, triage.
  5. 5
    Connect SlackChannels, DMs, threads, mentions.
  6. 6
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  7. 7
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  8. 8
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.