Skip to content

feat(sre-agent): add FinOps recipe content#2168

Open
MSBrett wants to merge 16 commits into
features/sre-kpi-query-catalogfrom
features/sre-agent-recipe
Open

feat(sre-agent): add FinOps recipe content#2168
MSBrett wants to merge 16 commits into
features/sre-kpi-query-catalogfrom
features/sre-agent-recipe

Conversation

@MSBrett

@MSBrett MSBrett commented Jun 3, 2026

Copy link
Copy Markdown
Contributor

Replaces part of #2111.

Scope:

  • Adds the FinOps Hub SRE Agent recipe content, expected config, scheduled tasks, tools, skills, knowledge, subagents, and azcapman submodule reference.
  • Includes recipe verification/build support and the SRE Agent deploy unit test.

Review notes:

  • Base: features/sre-kpi-query-catalog.
  • Depends on the KPI query catalog PR because the recipe consumes that catalog.
  • Split plan: memory://projects/finops-toolkit/pr-2111-split-plan.

Verification:

@microsoft-github-policy-service microsoft-github-policy-service Bot added the Needs: Review 👀 PR that is ready to be reviewed label Jun 3, 2026
@MSBrett MSBrett marked this pull request as ready for review June 3, 2026 15:54
@MSBrett MSBrett requested a review from flanakin as a code owner June 3, 2026 15:54

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds the FinOps Hub Azure SRE Agent “recipe” content under src/templates/sre-agent/, including subagent definitions, tool manifests (Kusto + Python), skills/reference material, knowledge files, scheduled tasks, and verification/config artifacts intended to support deployment and ongoing ops workflows.

Changes:

  • Introduces the recipes/finops-hub/ recipe (agents, tools, skills, scheduled tasks, connectors, knowledge) for the FinOps Toolkit SRE Agent.
  • Adds verification/config artifacts (expected-config.json, roles.yaml, agent.json, built-in tool overrides) to validate deployments and expected inventory.
  • Adds template guardrails and repository wiring (AGENTS guidance, upstream pin, git attributes/ignore, submodule reference).

Reviewed changes

Copilot reviewed 91 out of 93 changed files in this pull request and generated 4 comments.

Show a summary per file
File Description
src/templates/sre-agent/recipes/finops-hub/roles.yaml Declares managed identity RBAC requirements for subscription/target RGs and ADX.
src/templates/sre-agent/recipes/finops-hub/README.md Recipe overview and deploy usage.
src/templates/sre-agent/recipes/finops-hub/knowledge/teams-notification-guide.md Delivery guidance for Teams/Outlook connector tools.
src/templates/sre-agent/recipes/finops-hub/knowledge/onboarding-recommendations.md Onboarding and connector setup recommendations.
src/templates/sre-agent/recipes/finops-hub/knowledge/document-index.md Knowledge source inventory and verification sentinel.
src/templates/sre-agent/recipes/finops-hub/knowledge/chart-artifact-verification.md Non-visual chart artifact verification guidance.
src/templates/sre-agent/recipes/finops-hub/expected-config.json Expected inventory/config used for verification comparisons.
src/templates/sre-agent/recipes/finops-hub/connectors.json Defines the FinOps Hub Kusto connector for the recipe.
src/templates/sre-agent/recipes/finops-hub/config/tools/vm-quota-usage.yaml Python tool: VM quota usage reporting via ARM REST.
src/templates/sre-agent/recipes/finops-hub/config/tools/suppress-advisor-recommendations.yaml Python tool: bulk Advisor suppression creation via Resource Graph + ARM PUT.
src/templates/sre-agent/recipes/finops-hub/config/tools/resource-graph-query.yaml Python tool: run Resource Graph queries across subscriptions.
src/templates/sre-agent/recipes/finops-hub/config/tools/deploy-bulk-anomaly-alerts.yaml Python tool: deploy Cost Mgmt anomaly alerts across MG subscriptions.
src/templates/sre-agent/recipes/finops-hub/config/tools/deploy-budget.yaml Python tool: create/update subscription budgets via ARM REST.
src/templates/sre-agent/recipes/finops-hub/config/tools/deploy-anomaly-alert.yaml Python tool: create/update anomaly scheduled actions per subscription.
src/templates/sre-agent/recipes/finops-hub/config/tools/capacity-reservation-groups.yaml Python tool: CRG inventory and utilization reporting.
src/templates/sre-agent/recipes/finops-hub/config/tools/benefit-recommendations.yaml Python tool: Cost Mgmt benefit recommendations at billing scope.
src/templates/sre-agent/recipes/finops-hub/config/subagents/ftk-hubs-agent.yaml Subagent definition for hub deployment/ops workflows plus tool/hook config.
src/templates/sre-agent/recipes/finops-hub/config/subagents/ftk-database-query.yaml Subagent definition for Kusto/catalog-based analytics plus tool/hook config.
src/templates/sre-agent/recipes/finops-hub/config/subagents/finops-practitioner.yaml Orchestrator subagent definition and delegation rules.
src/templates/sre-agent/recipes/finops-hub/config/subagents/chief-financial-officer.yaml CFO subagent definition (KB-only) for exec framing.
src/templates/sre-agent/recipes/finops-hub/config/subagents/azure-capacity-manager.yaml Capacity subagent definition plus tool/hook config.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/workflows/ftk-hubs-healthCheck.md Skill reference workflow: hub health checks.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/workflows/ftk-hubs-connect.md Skill reference workflow: connect/discover hub and persist env.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/understand-finops-hub-context.md Foundational grounding step for hub context before analysis.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/top-cost-drivers.md Skill reference for ranking/driver analysis patterns.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/settings-format.md Skill reference for .ftk/environments.local.md schema.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/finops-hubs.md Skill knowledge: query catalog usage, constraints, best practices.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/custom-dimension-analysis.md Skill reference for allocation/tag dimension analysis.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/cost-trend-analysis.md Skill reference for trend analysis patterns.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/cost-spike-investigation.md Skill reference for spike root-cause patterns.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/references/cost-anomaly-detection.md Skill reference for anomaly detection decomposition.
src/templates/sre-agent/recipes/finops-hub/config/skills/finops-toolkit/README.md Skill README describing activation and query catalog usage.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/references/Get-BenefitRecommendations.ps1 Reference script for benefit recommendations via Az REST.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/references/azure-macc.md Cost Mgmt knowledge: MACC tracking and workflows.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/references/azure-credits.md Cost Mgmt knowledge: Azure credits/prepayment workflows.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/references/azure-cost-exports.md Cost Mgmt knowledge: exports config/backfill guidance.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/references/azure-budgets.md Cost Mgmt knowledge: budget creation/notifications/action groups.
src/templates/sre-agent/recipes/finops-hub/config/skills/azure-cost-management/README.md Azure cost management skill README.
src/templates/sre-agent/recipes/finops-hub/config/built-in-tools.json Enables/overrides built-in visualization and log query tools.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/storage-paas-growth-forecast.yaml Scheduled task: storage/PaaS growth forecast.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/sku-availability-audit.yaml Scheduled task: SKU availability audit.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/non-compute-quota-audit.yaml Scheduled task: non-compute quota audit.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/monitoring-scope-validation.yaml Scheduled task: monitoring scope validation.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/db-quota-audit.yaml Scheduled task: DB quota audit.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/compute-utilization-trend.yaml Scheduled task: compute utilization trend.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/capacity-daily-monitor.yaml Scheduled task: daily capacity monitor.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/budget-coverage-audit.yaml Scheduled task: budget coverage audit.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/benefit-recommendation-review.yaml Scheduled task: benefit recommendation executive review.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/alert-coverage-audit.yaml Scheduled task: anomaly alert coverage audit.
src/templates/sre-agent/recipes/finops-hub/automations/scheduled-tasks/advisor-suppression-review.yaml Scheduled task: Advisor suppression review.
src/templates/sre-agent/recipes/finops-hub/agent.json Default agent settings (access/action mode, provider, toggles).
src/templates/sre-agent/AGENTS.md Guardrails and template inventory for contributors/agents.
src/templates/sre-agent/.upstream-pin Upstream pin metadata for the starter-lab template.
src/templates/sre-agent/.gitignore Ignores build gate artifacts and un-ignores bin/.
src/templates/sre-agent/.gitattributes Forces LF EOL for shell scripts.
.gitmodules Adds azcapman submodule reference under the SRE agent template.

Comment thread src/templates/sre-agent/recipes/finops-hub/roles.yaml
Comment thread src/templates/sre-agent/recipes/finops-hub/expected-config.json
Comment thread src/templates/sre-agent/recipes/finops-hub/config/subagents/ftk-hubs-agent.yaml Outdated
Comment thread src/templates/sre-agent/AGENTS.md
@MSBrett MSBrett enabled auto-merge (squash) June 4, 2026 13:19
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Needs: Review 👀 PR that is ready to be reviewed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants