Agent Blueprints
Overview
The Enterprise Kit ships with 5 pre-built agent blueprints designed to run on Azure AI Foundry Agent Service. Each blueprint deploys as a first-class Foundry Agent Application (ARM resource) with manifest-driven configuration, Foundry Toolbox integration, Foundry Guardrails for content safety, and Azure AI Search for RAG grounding. Blueprints are published to Agent 365 for cross-platform governance and enterprise discovery. Each includes YAML manifests, system prompts, toolbox configuration, and evaluation criteria.
Blueprint Catalog
| Blueprint | Class | Primary Function | Key Tools |
|---|---|---|---|
| Knowledge Agent | retrieval | RAG-based Q&A over enterprise knowledge bases | AI Search, Cosmos DB, File Search |
| Operations Agent | action | ITSM automation (incident create, resolve, escalate) | ServiceNow, PagerDuty, Jira |
| Policy Agent | governance | Policy evaluation and compliance checking | Azure Policy, Policy Graph, Evaluators |
| Workflow Agent | orchestrator | Multi-step workflow orchestration across systems | SAP, Workday, Internal APIs |
| Analyst Agent | analysis | Data analysis, report generation, trend detection | Cosmos DB, AI Search, Code Interpreter |
Manifest Structure
Each agent is defined by a YAML manifest following the Agent Manifest Specification:
# agent-manifest.yaml
apiVersion: foundry.azure.com/v1
kind: AgentManifest
metadata:
name: knowledge-agent
version: "1.0.0"
labels:
class: retrieval
tier: production
spec:
model:
deployment: gpt-4o
temperature: 0.3
max_tokens: 4096
tools:
- name: azure_ai_search
type: azure_ai_search
connection: ai-search-connection
- name: file_search
type: file_search
instructions_file: prompts/system-prompt.md
evaluation:
pack: builtin
threshold: 0.8
governance:
policy_pack: default
certification_level: standard
data_boundary: us-eastCustomizing a Blueprint
- Copy the blueprint directory:
cp -r agent-templates/knowledge-agent my-agent - Edit
agent-manifest.yamlwith your model, tools, and policies - Customize
prompts/system-prompt.mdfor your domain - Map toolbox config in
toolbox-configs/ - Run evaluation:
python sdk-starters/python/eval_runner.py --manifest my-agent/agent-manifest.yaml - Deploy via CI/CD pipeline or SDK client
- Publish to Agent 365:
python trust-extensions/agent365_publisher.py --manifest my-agent/agent-manifest.yaml
Agent Classes
The class label determines the agent's runtime behavior, tool access patterns, and governance requirements:
| Class | Tool Access | Azure Memory | Escalation |
|---|---|---|---|
| retrieval | Azure AI Search, File Search | Session (chatSummary) | Low-priority |
| action | MCP adapters (read + write) | Persistent (userProfile) | Auto-escalate on failure |
| governance | Policy engine + Decision Ledger | Append-only (Cosmos DB) | Block on violation |
| orchestrator | Multi-system via Foundry Toolbox | Workflow state (Durable Functions) | Human-in-loop (SignalR) |
| analysis | Code Interpreter + AI Search | Result cache (Cosmos DB) | On anomaly detection |
Azure Services per Blueprint
| Blueprint | Azure Services Used |
|---|---|
| Knowledge Agent | Azure AI Search, Cosmos DB, Foundry Guardrails, Azure Monitor, Agent Memory |
| Operations Agent | Foundry Toolbox (ServiceNow MCP), Azure Key Vault, App Insights, Entra ID |
| Policy Agent | Foundry Control Plane, Azure Policy, Decision Ledger (Cosmos DB), Policy Graph |
| Workflow Agent | Azure Durable Functions, SignalR (HITL), Foundry Toolbox (multi-adapter), Cosmos DB |
| Analyst Agent | Code Interpreter, Azure AI Search, Cosmos DB, App Insights (KQL dashboards) |
| All Blueprints | Agent 365 (governance publishing), MCP Fleet Governance (tool lifecycle), Decision Ledger (audit) |