All checks were successful
check agents / check (push) Successful in 10s
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>
150 lines
7.2 KiB
YAML
150 lines
7.2 KiB
YAML
# Who this agent is and what it offers.
|
|
#
|
|
# This file is the agent: the runtime reads it at startup and builds the agent
|
|
# from it -- its instructions, contract, tools, skills and hooks. There is no
|
|
# app/agent.py. The agent card, the agent catalog and the logs all show what it
|
|
# says. Nothing here is read from environment variables. Edit it, redeploy, and
|
|
# refresh the agent in the catalog.
|
|
|
|
# The agent's unique identity. Changing it renames the agent in the
|
|
# catalog when it is refreshed at the same URL.
|
|
name: "cp1-alz-discovery-orchestrator-agent"
|
|
|
|
# How the agent is shown in the catalog. Optional: without it, the name is
|
|
# shown. Generated from the name; change it freely -- it is not an identity.
|
|
display_name: "CP1 - ALZ Discovery Orchestrator Agent"
|
|
|
|
# Shown in the catalog and the workflow palette. Write it for someone
|
|
# deciding whether this agent does what they need.
|
|
description: "Runs one phase of Agentic Landing Zone discovery (plan, collect, analyse or critique) for an engagement, keeps the run's working data in its workspace, and returns the phase's artifacts and, for critique, an enforced coverage verdict."
|
|
|
|
# Bump it when you ship a change callers should notice; it is how two builds of
|
|
# one agent are told apart in the catalog. The agent pipeline tags the image
|
|
# with it and will not release a version twice, or one without its entry in
|
|
# RELEASE_NOTES.md.
|
|
version: "0.2.0"
|
|
|
|
# The framework the agent runs on, set by the template it came from. It must
|
|
# match the runtime image the Dockerfile builds on (agent-runtime-adk).
|
|
framework: adk
|
|
|
|
# What the agent is about, for searching and filtering the catalog.
|
|
tags:
|
|
- cp1
|
|
- public-cloud
|
|
- agentic-landing-zone
|
|
- discovery
|
|
- orchestrator
|
|
|
|
# A2A capabilities.
|
|
# streaming replies arrive as they are generated
|
|
# push_notifications the agent can call the client back when a task finishes
|
|
capabilities:
|
|
streaming: true
|
|
push_notifications: false
|
|
|
|
# What the agent can do: one skill folder per discovery phase. The request's
|
|
# `phase` decides which one fits. See skills/README.md.
|
|
skills:
|
|
- discovery-plan
|
|
- discovery-collect
|
|
- discovery-analyse
|
|
- discovery-critique
|
|
|
|
# The instructions, relative to this file.
|
|
prompt: prompt.md
|
|
|
|
# What the agent accepts and returns, checked on every request: JSON Schemas in
|
|
# schemas/. A reply that breaks the output schema is sent back to the model
|
|
# once, then refused. Without a contract the agent takes and returns free text.
|
|
contract:
|
|
input: schemas/input.json
|
|
output: schemas/output.json
|
|
input_arrives: as_one_document
|
|
|
|
# The agent's own functions the model may call, each `module:function`.
|
|
# app.tools -- the run workspace (shared data, context and memory) and the
|
|
# hand-off to sub-agents
|
|
# app.rules -- deterministic checks the plan must pass
|
|
functions:
|
|
- app.tools:workspace_put
|
|
- app.tools:workspace_get
|
|
- app.tools:workspace_list
|
|
- app.tools:delegate
|
|
- app.rules:check_plan
|
|
|
|
# MCP tools the agent may use, through the platform's MCP gateway. Sub-agents
|
|
# cannot hold MCP tools (the runtime builds them with functions only), so every
|
|
# call to a data source is made here, by the orchestrator, and the results are
|
|
# handed to the sub-agents through the workspace. Read-only tools only: the
|
|
# write tools in the story files (alz-run.*, write_inventory, tag_pii, graph)
|
|
# are replaced by the workspace. Server names are logical; map them to the
|
|
# deployed MCP servers before the first run (see ../README.md).
|
|
mcp:
|
|
alz-scope: [get_scope, list_sources, get_budgets]
|
|
alz-estate: [scan_target]
|
|
alz-cloud: [get_resource_metadata]
|
|
alz-cmdb: [ingest_cmdb, ingest_itsm, cmdb_query, diff_records]
|
|
alz-inventory: [list_apps, get_app]
|
|
alz-schema: [scan_schema]
|
|
alz-dependency: [get_dependencies, trace_calls, trace]
|
|
alz-network: [collect_topology, map_flows, analyze_bottlenecks]
|
|
alz-evidence: [get_call_log, get_guard_hits]
|
|
|
|
# Smaller agents this one hands part of its work to, each with its own
|
|
# instructions (prompt), model (<NAME>_LLM_MODEL in the ConfigMap; the
|
|
# agent's LITELLM_MODEL when unset) and functions. The agent calls each like
|
|
# a tool named after it, deciding from its description; the sub-agent sees
|
|
# only the request the agent writes it.
|
|
#
|
|
# Every sub-agent here is `as_tool: false`: the model never calls one directly.
|
|
# It calls `delegate`, whose code asks the sub-agent with ask_sub_agent(),
|
|
# hands it its inputs from the workspace, and stores its reply with a hash.
|
|
# A sub-agent that fails then fails the hand-off loudly instead of being
|
|
# skipped, and the critic cannot be left out. One sub-agent per ADO story.
|
|
sub_agents:
|
|
- name: dsc_01_planner
|
|
description: "ALZ-DSC-01 Discovery Planner. Turns the scope, sources and budgets into a task graph that accounts for every scope entry as a task or a declared gap."
|
|
prompt: prompts/dsc_01_planner.md
|
|
functions: [app.tools:workspace_get]
|
|
as_tool: false
|
|
- name: dsc_02_scan_executor
|
|
description: "ALZ-DSC-02 Estate Scan Executor. Turns scan_target / provider metadata results into one structured finding per scope entry, flagging prompt injection."
|
|
prompt: prompts/dsc_02_scan_executor.md
|
|
functions: [app.tools:workspace_get]
|
|
as_tool: false
|
|
- name: dsc_03_inventory
|
|
description: "ALZ-DSC-03 Asset Inventory Normalisation. Builds the de-duplicated canonical inventory from findings and CMDB / ITSM records."
|
|
prompt: prompts/dsc_03_inventory.md
|
|
functions: [app.tools:workspace_get, app.rules:match_score, app.rules:record_confidence]
|
|
as_tool: false
|
|
- name: dsc_04_cmdb_reconciliation
|
|
description: "ALZ-DSC-04 CMDB & ITSM Reconciliation. Reports orphans, ghosts and stale attributes, and ITSM signals, against the canonical inventory."
|
|
prompt: prompts/dsc_04_cmdb_reconciliation.md
|
|
functions: [app.tools:workspace_get, app.rules:ghost_action]
|
|
as_tool: false
|
|
- name: dsc_05_data_classification
|
|
description: "ALZ-DSC-05 Data Classification. Classifies data stores PII / PCI / PHI / none from schema metadata only."
|
|
prompt: prompts/dsc_05_data_classification.md
|
|
functions: [app.tools:workspace_get, app.rules:roll_up_store]
|
|
as_tool: false
|
|
- name: dsc_06_dependency_mapping
|
|
description: "ALZ-DSC-06 Dependency Mapping. Builds the evidenced dependency graph with fan-in / fan-out and retire constraints."
|
|
prompt: prompts/dsc_06_dependency_mapping.md
|
|
functions: [app.tools:workspace_get, app.rules:score_edge, app.rules:node_metrics]
|
|
as_tool: false
|
|
- name: dsc_07_network
|
|
description: "ALZ-DSC-07 Network Discovery & Assessment. Maps ranges and flows and reports bottlenecks, overlaps and legacy protocols with evidence."
|
|
prompt: prompts/dsc_07_network.md
|
|
functions: [app.tools:workspace_get, app.rules:find_overlaps, app.rules:bottleneck_severity]
|
|
as_tool: false
|
|
- name: dsc_08_critic
|
|
description: "ALZ-DSC-08 Discovery Critic. Validates coverage, injection handling, evidence and tool-call integrity across all discovery outputs and returns a verdict."
|
|
prompt: prompts/dsc_08_critic.md
|
|
functions: [app.tools:workspace_get, app.rules:coverage_check]
|
|
as_tool: false
|
|
|
|
# The agent's own code around each request and each model call: pre_process,
|
|
# post_process, before_model and after_model in app/business_logic.py.
|
|
hooks: app.business_logic
|