feat(sre-agent): add FinOps recipe content#2168
Open
MSBrett wants to merge 16 commits into
Open
Conversation
added 9 commits
June 3, 2026 09:15
Contributor
There was a problem hiding this comment.
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. |
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replaces part of #2111.
Scope:
Review notes:
features/sre-kpi-query-catalog.memory://projects/finops-toolkit/pr-2111-split-plan.Verification:
git diff --check features/sre-kpi-query-catalog..features/sre-agent-recipe