Agent Creation Approvals
When the approval workflow is enabled in Settings, agent creation requests are queued for human review instead of being executed immediately. The Approvals page lets administrators examine proposed configurations, assess risk, and approve or deny each request.
Accessing Approvals
Navigate to System Admin > Agent Self-Service > Approvals.
A badge next to the page title shows the number of pending requests when there are items awaiting review.
Filtering Approvals
Use the status filter buttons at the top of the page to view requests by status:
| Filter | Description |
|---|---|
| Pending | Requests awaiting administrator review (default view) |
| Approved | Previously approved requests |
| Denied | Previously denied requests |
| All | Every request regardless of status |
Approval Queue Table
The approvals table displays the following information for each request:
| Column | Description |
|---|---|
| Proposed Agent | The name and system identifier of the agent to be created. An SME badge appears if the request is for a Specialist Agent. |
| Requesting Agent | The existing agent that initiated the creation request |
| Risk Score | AI-generated danger assessment (see below) |
| Status | Current status: Pending, Approved, or Denied |
| Requested | Date and time the request was submitted |
| Actions | Click Review to open the detail modal |
Reviewing a Request
Click Review on any request (or click the table row) to open the review modal. The modal displays comprehensive information to help you make an informed decision.
Proposed Agent Details
- Name - The system identifier for the new agent (e.g.,
marketing_content_agent) - Display Name - Human-readable name shown in the admin console
- Type - Whether this is a standard agent or a Subject Matter Expert (SME)
- Requested By - Which existing agent initiated the creation
- Risk Score - Color-coded danger assessment
Proposed Instructions
The full system prompt that the new agent would use. Review this carefully for:
- Appropriate scope and boundaries
- No references to sensitive data access beyond what's needed
- Clear, well-defined responsibilities
- No instructions that could lead to harmful behavior
Requested Tools
The list of tools the new agent would receive. Remember that an agent can only grant tools it already has. Verify that the requested tools are appropriate for the agent's stated purpose.
AI Safety Analysis
The system provides AI-generated analysis to assist your review:
- Analysis Summary - A brief assessment of the overall risk level and reasoning
- Recommendations - Specific suggestions for improving safety (if any)
- Flags - Highlighted concerns that warrant attention (shown in red)
Risk Score Indicators
The risk score uses color-coding for quick assessment:
| Score | Color | Meaning |
|---|---|---|
| Below 30% | Green | Low risk - instructions appear safe |
| 30-69% | Yellow | Moderate risk - review instructions carefully |
| 70% and above | Red | High risk - exercise caution, may warrant denial |
Making a Decision
Approving a Request
- Review all the information in the modal
- Optionally add review notes explaining your decision
- Click Approve
- The agent is created according to the proposed configuration
- If "Create Agents as Inactive by Default" is enabled in Settings, the new agent will need to be manually activated
Denying a Request
- Review all the information in the modal
- Add review notes explaining the reason for denial (required for denials)
- Click Deny
- The request is marked as denied and logged
Denial notes are recorded in the audit log and may be visible to the requesting agent in future executions, helping it understand why the request was rejected and adjust its approach.
Viewing Previous Decisions
For approved or denied requests, the review modal shows the decision details:
- Reviewed By - The administrator who made the decision
- Reviewed At - When the decision was made
- Notes - The reviewer's notes or reason for denial
Tips
- Check approvals regularly - Pending requests block agent workflows, so review them promptly
- Use the risk score as a guide - Low-risk requests from trusted agents can be approved quickly
- Read flagged instructions carefully - If the AI safety analysis raises flags, take extra time to review
- Add meaningful notes - Your notes create a valuable audit trail and help agents learn from rejections
- When in doubt, deny - It's safer to deny and investigate than to approve a questionable request