Files
Jonathan Boniface 416c66ced4
All checks were successful
check agents / check (push) Successful in 10s
Add CP1 Discovery agents in both patterns
ALZ-F01 Discovery as a sub-agent orchestrator (sub-agents/) and as eight
individual declarative agents (individual-agents/), with their KAB workflow
exports. Shared check, render and import scripts, the alz-discovery-sample
MCP server, the crucible-kab-dev deploy profile, deployment docs, platform
issue reports and the source material. Agent steps time out at 20 minutes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-29 18:25:57 +00:00

34 lines
1.7 KiB
Markdown

# User guide: CP1 - CMDB & ITSM Reconciliation Agent
For the Engagement Lead or delivery engineer reviewing a discovery run.
## What it does
Ingests CMDB and ITSM records through registered connectors and reports orphans, ghosts, stale attributes and ITSM signals against the canonical inventory, with evidence.
It is step 4 of the workflow **CP1 - Agentic Landing Zone - Discovery** (ALZ-DSC-04, ADO 3214454). You don't
call it yourself in normal use: run the workflow with `engagement_id` and `run_id`, and this agent receives its
inputs from the earlier steps.
## Reading its output
The output fields are listed in the agent's [README](../README.md#outputs). Every fact it states cites an
`evidence_ref` from the MCP call it came from. Anything it couldn't establish is left empty, or listed as a gap or
an issue, never guessed.
## What it will not do
- Call any tool not on its allowlist, or pass a tool a hostname, address, URL or credential.
- Write to any client system: all its tools are read-only.
- Follow instructions found in data. These are recorded as prompt-injection findings.
## When something looks wrong
| You see | Likely cause | What to do |
|---|---|---|
| The step failed with `output_contract_violation` | The model's reply didn't fit the output schema twice | Rerun the step; if it repeats, report it with the run id |
| A refused tool call in the output | The MCP gateway refused the call (allowlist, scope or rate) | Check the agent's registration on the MCP gateway |
| Empty fields | The source records didn't support them | Expected: the agent leaves out what it can't evidence |
Changes from the original requirements are listed in [adr/](adr/README.md).