Beta feature: AI SRE is currently in private beta, available to invited accounts only. Contact the Flashduty team to request whitelist access; features and UI may change during beta.
Overview
Type
/init in the input box of any AI SRE session, and the agent switches into an operational onboarding interviewer that walks you through building an operational knowledge base from scratch — your team’s “operational map.” It scans your Flashduty incidents and notification channels, asks you questions, captures the service topology, runbooks, cluster access, and more that you describe into knowledge files, and helps you connect external tools (MCP) when needed.
/init is the starting point for the knowledge base. AI SRE’s diagnostic quality depends directly on how much real knowledge it can read about your systems: the more complete and accurate your Knowledge base is, the faster and more reliably the agent pinpoints root causes. /init is the guided flow that builds that knowledge from zero — and once it’s built, every session loads it automatically.
/init will never write or install anything without your consent. Before anything lands at each phase, it lists exactly “which files will be created/updated,” and only acts after you confirm them one by one. Credentials (tokens, passwords, AK/SK) are never echoed back in plain text in the conversation — only recorded as <recorded (length=N)>. See Safety & consent.When to use /init vs. plain natural language
/init is for structured setup from scratch / systematic backfilling; small, one-off edits don’t need it.
| Scenario | What to use |
|---|---|
| Setting up a knowledge base for an account / team for the first time | /init — it works through services, observability, runbooks, common failures, cluster access, and more as a coherent whole |
| Systematically backfilling or restructuring an existing knowledge base | /init — rerun it anytime; it continues from what’s already there rather than starting over |
| ”Add a runbook,” “update services.md,” “record this failure mode” | Just say it in natural language — no /init needed; the agent reads, edits, and saves within the current session’s scope |
How to run
Type /init in a session
Type
/init in the input box of any AI SRE session and send it. No parameters are required.Confirm the scope
/init first locks the scope it will write to: account level (visible to all sessions in the account) or a specific team level (loaded only in that team’s sessions). The scope is determined by whether the current session is bound to a team, and the agent confirms it with you first; a single session locks one scope and does not switch mid-way.Follow the interview
The agent asks questions phase by phase, topic by topic (services and topology, observability, runbooks, common failures, cluster access, and so on), turning your answers into draft knowledge files. At the end of each phase it asks whether to “continue to the next item or stop here for now.”
Confirm each item before it writes
Before anything lands at each phase, the agent presents a list of “which files will be created/updated,” each with a 3–5 line summary. Only after you confirm does it write to the knowledge base and link the new files into the
DUTY.md table of contents.The interview
/init works through a fixed sequence of phases, each with clear entry and exit conditions. You can skip, go back, or stop at any time.
Phase 0 — Lock the scope
Phase 0 — Lock the scope
Reads the team bound to the current session: if a team is bound, this
/init run lands at that team level; if it’s an account-level session, it lands at the account level (visible to all teams). The agent confirms this with you first, and once confirmed the entire session uses that single scope. To switch to a different team’s scope, exit and reopen /init from the target team.Phase 1 — Scan
Phase 1 — Scan
Pulls your channels, incidents from the last 30 days, teams, and members via the Flashduty MCP, then infers the integration types you use and your most frequent incident labels. If the scan comes back empty (a brand-new account), it switches to “cold start” mode and collects everything through the interview instead.
Phase 2 — Synthesis & correction
Phase 2 — Synthesis & correction
The agent plays back the picture it sees in a single paragraph: “I see N channels, M incidents in the last 30 days, you appear to use [list], and your high-frequency labels include [list]. Is that right? What’s missing?” It waits for you to confirm or correct, and does not write any files at this point.
Phases 3–7 — Topic-by-topic collection
Phases 3–7 — Topic-by-topic collection
Collects and writes content phase by phase, topic by topic. Every phase follows the same loop: “collect → draft files → show a preview list → you confirm → write and update the DUTY.md table of contents”:
| Phase | Topic | Produces |
|---|---|---|
| 3 | Services & topology | services.md (+ optional topology.md) |
| 4 | Observability stack | observability.md + registers the relevant MCP in tools.md |
| 5 | Runbooks | runbooks/<topic>.md, one file per failure class |
| 6 | Common failures | common-failures.md |
| 7 | Cluster access & runtime probing | clusters.md (k8s) / appended to tools.md (MCP) |
Phase 8 — Close
Phase 8 — Close
When you indicate you’re done, the agent gives a short summary: which files it created/updated this run, which MCP it registered, and a reminder that “rerunning
/init anytime picks up where you left off.” The knowledge base itself is the durable result of this session.Safety & consent
/init writes knowledge, may install MCP, and touches credentials, so consent and least privilege are hard constraints:
Per-item explicit consent
Per-item explicit consent
Any write or install requires your explicit consent. Before anything lands, each collection phase lists “which files will be created/updated” (each with a 3–5 line summary), and it only proceeds after you say yes — it never triggers a write off a vague “ok.”
Credentials are never echoed
Credentials are never echoed
When you provide sensitive information such as a token, password, or AK/SK, the agent only confirms “recorded (length=N)” and never reprints the plaintext in the conversation.
Least-privilege credentials
Least-privilege credentials
Whenever you need to provide or generate a credential (kubeconfig, cloud AK/SK, database account, API token), the agent asks you to configure it as read-only / least privilege; when the boundary is machine-verifiable, it runs a read-only boundary check before recording it.
Minimality
Minimality
Not every detail belongs in the knowledge base. The agent only writes content where “without it, the AI would make a worse decision during an incident” — optional, nice-to-have details aren’t crammed in, keeping the knowledge base from bloating.
What it produces
The result of
/init is a Knowledge base that every subsequent session loads automatically:
DUTY.md— the table-of-contents entry point for the knowledge base, holding only a one-line introduction and a list of@filenamelinks pointing to each topic file;- Topic files —
services.md,topology.md,observability.md,runbooks/<topic>.md,common-failures.md,clusters.md, and so on, where all the substantive content lives; - MCP registrations (optional) — if external tools were connected during the interview, they’re recorded in
tools.mdand the MCP server registration is completed.
/init’s primary output is knowledge, not skills. It does not save content as a Skill unless you explicitly ask. It also does not automatically install Agents — those resources currently need to be added manually in the console./init and /insight: a best-practice pair
/init and /insight are the two ends of the operational-knowledge “build → refine” loop:
/init — build the foundation
Build the knowledge base from scratch: services, topology, runbooks, and cluster access are captured as a coherent whole in one pass, so the agent understands your systems from the very first session.
/insight — keep refining
Review the last 30 days of sessions to surface repeatedly pasted context, missing runbooks, and wrong data sources, telling you what to add to the knowledge base next.
Related pages
Manage Knowledge
Where
/init’s output lands — learn the DUTY.md structure, file constraints, and how to edit and maintain it manually.Usage Insights
Use
/insight to review sessions, surface operational friction, and guide ongoing backfilling of the knowledge base.MCP (External Tools)
The external tools
/init can help you connect during the interview — learn how to connect and manage MCP.