Skip to main content

Knowledge Sources

What are Knowledge Sources

Knowledge Sources are organization-specific documents and rules that OpsWorker references during investigations and chat. They cover two distinct categories:

CategoryWhat It IsExample
Internal knowledgeRunbooks, postmortems, internal docs"Postgres failover runbook"
Best-practice rulesConstraints OpsWorker must respect"Never recommend deleting PersistentVolumes"

Where AI Memory holds short, structured facts, Knowledge Sources holds the documents and rule sets you already maintain in longer form.

How It's Used

When an investigation runs or a chat session starts, OpsWorker loads relevant knowledge source entries into the AI's context. The AI:

  • References internal knowledge when the topic matches — quoting runbook procedures, citing postmortem lessons.
  • Respects best-practice rules as constraints — hard rules act as guardrails, soft rules bias recommendations.

Knowledge Sources vs. Memory

ConcernMemoryKnowledge Sources
FormatOne-line facts and preferencesMulti-paragraph docs and rule sets
SourceManually enteredConnected from existing docs
CadenceAdds as you learnBulk-load from existing material

Use memory for atomic facts ("Team B owns pay-*"). Use knowledge sources for procedures and policies ("How to recover from a Redis failover" or "Never auto-restart prod").

Next Steps