Agent Lifecycle Governance
Overview
This guide covers the complete agent lifecycle from creation through decommissioning, with zone-specific governance requirements at each stage. Effective lifecycle management ensures agents remain compliant, secure, and aligned with business objectives throughout their operational life.
See Governance and security best practices for Microsoft's recommended approach.
Lifecycle Phases
flowchart LR
A[Creation] --> B[Development]
B --> C[Testing]
C --> D[Deployment]
D --> E[Monitoring]
E --> F[Maintenance]
F --> G[Decommission]
E -.->|Issues| B
F -.->|Updates| C
| Phase | Description | Key Activities |
|---|---|---|
| Creation | Initial agent setup | Zone classification, environment selection |
| Development | Building and configuring | Topics, knowledge sources, connectors |
| Testing | Validation before promotion | Functional testing, security review |
| Deployment | Production release | Channel publication, user access |
| Monitoring | Ongoing observation | Performance, usage, compliance |
| Maintenance | Updates and changes | Enhancements, fixes, retraining |
| Decommission | Secure retirement | Data retention, access removal |
Phase 1: Creation - Building Safely Within the Right Zone
Zone Selection
Before creating an agent, determine the appropriate governance zone:
| Factor | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Data sensitivity | Public/internal only | Departmental data | Customer PII, financial |
| User scope | Individual | Team/department | Enterprise-wide |
| External access | No | No | Yes (with approval) |
| Approval required | Self-service | Manager | Governance committee |
See Zones Guide for detailed zone selection criteria.
Environment Routing
Makers are automatically routed to appropriate environments based on security group membership:
- Zone 1: Personal developer environment (auto-provisioned)
- Zone 2: Team/departmental environment
- Zone 3: Enterprise managed environment
See Control 2.15: Environment Routing for configuration.
Initial Governance Classification
| Requirement | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Business justification | Optional | Required | Detailed |
| Sponsor approval | None | Manager | Executive |
| Risk assessment | None | Basic | Comprehensive |
| Documentation | Minimal | Standard | Full |
Phase 2: Development - Controlled Building
Developer Environment Usage
| Environment Type | Purpose | Governance Level |
|---|---|---|
| Personal developer | Individual experimentation | Minimal (Zone 1) |
| Shared development | Team collaboration | Standard (Zone 2) |
| Controlled development | Enterprise solutions | Full (Zone 3) |
Version Control with Solutions
For Zone 2-3 agents, use Power Platform solutions for version control:
- Create a solution containing the agent
- Export solution for backup/deployment
- Use ALM pipelines for promotion
See Overview of pipelines for ALM guidance.
Co-Authoring Controls
| Zone | Co-Authoring | Configuration |
|---|---|---|
| Zone 1 | Disabled | Single owner only |
| Zone 2 | Limited | Team members via security group |
| Zone 3 | Controlled | Governance-approved editors only |
Development Checklist
- [ ] Agent created in appropriate environment
- [ ] Solution created (Zone 2-3)
- [ ] Knowledge sources configured
- [ ] Connectors reviewed for DLP compliance
- [ ] Authentication configured appropriately
- [ ] Initial testing completed
Phase 3: Testing - Validation Before Promotion
Test Environment Requirements
| Zone | Test Environment | Requirements |
|---|---|---|
| Zone 1 | Same as development | Basic functional testing |
| Zone 2 | Dedicated test environment | Formal test plan |
| Zone 3 | Production-like environment | Full validation suite |
Validation Checklists by Zone
Zone 1 Testing
- [ ] Agent responds correctly to expected queries
- [ ] No sensitive data exposed
- [ ] Performance acceptable
Zone 2 Testing
- [ ] All Zone 1 checks
- [ ] Connectors function correctly
- [ ] Team members can access appropriately
- [ ] Manager approval obtained
Zone 3 Testing
- [ ] All Zone 2 checks
- [ ] Security testing completed
- [ ] Compliance review passed
- [ ] Performance benchmarks met
- [ ] Fallback scenarios tested
- [ ] User acceptance testing completed
- [ ] Governance committee approval
Security Testing Requirements
| Test Type | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| DLP policy validation | Automatic | Required | Required |
| Authentication testing | N/A | Required | Required |
| Data access review | Optional | Required | Required |
| Penetration testing | N/A | Optional | Required |
| Bias assessment | N/A | Optional | Required |
See Control 2.5: Testing and Validation for detailed procedures.
Phase 4: Deployment - Controlled Promotion
Zone Promotion Process
flowchart TD
A[Zone 1 Agent] -->|Share beyond creator| B{Meets Zone 2 criteria?}
B -->|Yes| C[Promote to Zone 2]
B -->|No| D[Remain Zone 1]
C -->|Production deployment| E{Meets Zone 3 criteria?}
E -->|Yes| F[Promote to Zone 3]
E -->|No| G[Remain Zone 2]
F --> H[Enterprise Production]
ALM Pipeline Usage
For Zone 2-3 promotions, use Power Platform pipelines:
- Configure pipeline in Power Apps (Solutions → Pipelines)
- Add stages (Development, Test, Production)
- Deploy solution with agent through pipeline
- Validate deployment in target environment
Warning
Target environments in pipelines must be enabled as Managed Environments. Configure this in PPAC → Deployment → Settings.
Admin monitoring: Use PPAC → Deployment → Overview to track pending approvals and failed deployments.
See Set up pipelines for configuration steps.
Approval Workflows
| Promotion | Approvers | Documentation |
|---|---|---|
| Zone 1 → Zone 2 | Manager, Environment owner | Business justification |
| Zone 2 → Zone 3 | Governance committee, Compliance, Security | Full assessment package |
| Within Zone | Environment owner | Change request |
Channel Publication
| Channel | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Microsoft 365 Chat | ✓ | ✓ | ✓ |
| Teams | ✗ | ✓ | ✓ |
| SharePoint | ✗ | ✓ | ✓ |
| External website | ✗ | ✗ | ✓ (approved) |
| Direct Line | ✗ | ✗ | ✓ (approved) |
Phase 5: Monitoring - Ongoing Governance
Performance Monitoring
| Metric | Zone 1 Target | Zone 2 Target | Zone 3 Target |
|---|---|---|---|
| Success rate | >80% | >90% | >95% |
| Response time | <10s | <5s | <3s |
| Availability | 95% | 99% | 99.9% |
See Control 3.2: Usage Analytics for monitoring setup.
Usage Tracking
| Tracking | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Session counts | Monthly | Weekly | Daily |
| User analytics | Optional | Required | Required |
| Conversation logs | N/A | Sampled | Full |
| Cost tracking | Aggregate | Department | Per-agent |
Compliance Verification
| Verification | Frequency | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|---|
| DLP compliance | Automatic | ✓ | ✓ | ✓ |
| Access review | Quarterly | ✗ | ✓ | ✓ |
| Security scan | Monthly | ✗ | ✓ | ✓ |
| Full audit | Annual | ✗ | ✗ | ✓ |
Alert Configuration
Configure alerts for:
- Success rate drops below threshold
- Unusual usage patterns
- Security events
- Capacity approaching limits
See Control 3.2: Usage Analytics for alert setup.
Phase 6: Maintenance - Updates and Changes
Change Management Process
| Change Type | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Minor updates | Self-service | Notify manager | Change request |
| Major changes | Self-service | Manager approval | CAB approval |
| Knowledge updates | Self-service | Review required | Formal process |
| Connector changes | Self-service | Security review | Full assessment |
See Control 2.3: Change Management for detailed procedures.
Version Updates
- Create new solution version in development
- Test changes in test environment
- Deploy via pipeline to production
- Validate deployment and rollback if needed
Owner Transitions
When agent ownership changes:
| Task | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Transfer ownership | Self-service | Document transfer | Formal handover |
| Update documentation | Optional | Required | Required |
| Notify stakeholders | N/A | Team | All users |
| Compliance review | N/A | Optional | Required |
Periodic Reviews
| Review Type | Zone 1 | Zone 2 | Zone 3 |
|---|---|---|---|
| Business value | Annual | Quarterly | Monthly |
| Security posture | N/A | Semi-annual | Quarterly |
| Compliance | N/A | Annual | Quarterly |
| Performance | As needed | Monthly | Weekly |
Phase 7: Decommissioning - Secure Retirement
Agent Retirement Process
flowchart TD
A[Retirement Decision] --> B[Notify Stakeholders]
B --> C[Disable Agent]
C --> D[Export Data]
D --> E[Retain per Policy]
E --> F[Delete Agent]
F --> G[Update Inventory]
G --> H[Close Documentation]
Decommission Checklist
- [ ] Business justification for retirement documented
- [ ] Stakeholders notified (users, compliance, security)
- [ ] Agent disabled (not deleted initially)
- [ ] User access removed
- [ ] Conversation history exported (if required)
- [ ] Data retention requirements met
- [ ] Agent deleted from environment
- [ ] Inventory updated
- [ ] Documentation archived
Data Retention Requirements
| Data Type | Retention Period | Zone Requirement |
|---|---|---|
| Conversation logs | Per retention policy | Zone 2-3 |
| Configuration | 7 years (FSI) | Zone 3 |
| Audit trail | 7 years (FSI) | Zone 2-3 |
| User data | Per privacy policy | All zones |
See Control 1.9: Data Retention for detailed requirements.
Audit Trail Preservation
For Zone 3 agents:
- Export complete audit log
- Document reason for retirement
- Preserve approval chain
- Archive in compliance system
- Retain per regulatory requirements
Zone-Specific Lifecycle Summary
Zone 1: Personal Productivity
| Phase | Governance |
|---|---|
| Creation | Auto-provisioned developer environment |
| Development | Self-service, minimal oversight |
| Testing | Basic functional testing |
| Deployment | Creator-only access, M365 Chat channel |
| Monitoring | Basic metrics, aggregate reporting |
| Maintenance | Self-service updates |
| Decommission | Creator-initiated, minimal retention |
Zone 2: Team Collaboration
| Phase | Governance |
|---|---|
| Creation | Manager approval, team environment |
| Development | Team collaboration, version control |
| Testing | Formal test plan, security review |
| Deployment | Team access, internal channels |
| Monitoring | Weekly metrics, compliance checks |
| Maintenance | Documented changes, manager approval |
| Decommission | Stakeholder notification, data export |
Zone 3: Enterprise Managed
| Phase | Governance |
|---|---|
| Creation | Committee approval, risk assessment |
| Development | Controlled environment, full documentation |
| Testing | Complete validation, security testing |
| Deployment | Phased rollout, all channels (approved) |
| Monitoring | Daily metrics, continuous compliance |
| Maintenance | CAB approval, formal change process |
| Decommission | Full audit trail, 7-year retention |
Regulatory Considerations
FSI Regulatory Requirements by Lifecycle Phase
| Phase | FINRA | SEC | SOX | GLBA |
|---|---|---|---|---|
| Creation | Supervision (3110) | - | IT Controls | - |
| Development | Documentation (4511) | 17a-3/4 | 302 | 501(b) |
| Testing | Validation | 17a-4 | 404 | - |
| Deployment | Approval records | - | 302 | 501(b) |
| Monitoring | Supervision (3110) | 17a-3/4 | 404 | 501(b) |
| Maintenance | Change records (4511) | 17a-4 | 404 | - |
| Decommission | Retention (4511) | 17a-4 | 802 | 501(b) |
Examination Readiness
Maintain documentation at each phase for regulatory examinations:
- Agent creation requests and approvals
- Development records and version history
- Test results and validation evidence
- Deployment approvals and access lists
- Monitoring reports and incident records
- Change history and maintenance logs
- Decommission decisions and data retention proof
Related Controls
- Control 2.1: Managed Environments
- Control 2.3: Change Management
- Control 2.5: Testing and Validation
- Control 2.15: Environment Routing
- Control 3.1: Agent Inventory
- Control 3.6: Orphaned Agent Detection
Support & Questions
For lifecycle governance questions, contact:
- AI Governance Lead (governance direction)
- Compliance Officer (regulatory requirements)
- Power Platform Admin (technical setup)
Last Updated: December 2025 Version: 1.0 Beta