# Agent Management

The Capsule Security platform helps you discover, monitor, and secure AI agents across your organization.

## Supported Platforms

Connect with leading AI platforms:

- **Microsoft**: Copilot Studio, Power Automate
- **Salesforce**: Agentforce
- **OpenAI**: ChatGPT Enterprise
- **ServiceNow**: ServiceNow AI Agents
- **IDEs**: Cursor, Claude Code
- **AWS**: Bedrock
- **Azure**: Azure AI Foundry
- **Google Cloud**: Vertex AI
- **Automation**: Zapier, UiPath, n8n
- **Databricks**: Agent Bricks
- **Enterprise**: SAP Joule Agents, Box AI Studio, Workato Genies


## Discovering Agents

Once you integrate a platform, Capsule automatically finds:

- All AI agents in your environment
- What tools and data sources each agent can access
- Who owns each agent
- Where agents are deployed
- How agents are being used


## Viewing Your Agents

Browse all discovered agents with:

- Visual severity indicators showing risk levels
- Platform icons for quick identification
- Owner information
- Last activity timestamps
- Quick access to detailed information


Use filters to find specific agents by platform, owner, severity, or other attributes.

## Agent Details

### Basic Information

- Agent name and description
- Platform and environment
- Owner name and contact information
- Creation date
- Unique identifiers


### Accessibility

Agents can have three accessibility levels:

- **PUBLIC**: Available to anyone
- **TENANT**: Available to users in your organization
- **LIMITED**: Available to specific users only


### Security Status

- Issue severity (CRITICAL, HIGH, MEDIUM, LOW)
- Number of open issues
- Issue categories affecting the agent


### Tools and Connections

View what the agent can access:

- Database connections
- API integrations
- File systems
- Email services
- External systems


### Data Flow

See how data moves through your agent:

- Connected data sources
- Tools the agent uses
- Flow direction between components
- Related security issues


### Activity

Track agent usage:

- Total sessions
- Recent activity
- Usage patterns over time
- Session details and audit logs


## Managing Security Issues

### Issue Categories

Issues are organized by risk type:

- **SUPPLY_CHAIN**: Risks from third-party dependencies
- **DATA**: Data exposure or leakage
- **COMPLIANCE**: Policy violations
- **INTEGRITY**: Data quality concerns
- **ACCESS**: Unauthorized access risks
- **MISC**: Other security concerns


### Severity Levels

- **CRITICAL**: Fix immediately
- **HIGH**: Fix within 24 hours
- **MEDIUM**: Fix within 1 week
- **LOW**: Fix in next maintenance window


### Issue Status

- **OPEN**: Needs attention
- **RESOLVED**: Fixed and verified
- **IGNORED**: Accepted risk


### Working with Issues

1. View all issues or filter by severity, category, or status
2. Assign issues to team members
3. Follow remediation steps
4. Mark steps as completed
5. Update issue status when resolved


## Audit Logs

Track all agent activity:

- **Session Started**: When someone starts using the agent
- **Tool Call**: When the agent uses a tool or service
- **Message**: User interactions with the agent
- **Error**: Problems that occurred


Filter audit logs by date range and review issues detected during sessions.

## Best Practices

### Agent Ownership

- Assign an owner to every agent
- Owners are responsible for security and compliance
- Review ownership regularly


### Access Control

- Use LIMITED accessibility when possible
- Grant only necessary permissions
- Review agent access regularly


### Tool Management

- Only enable tools the agent needs
- Remove unused connections
- Review tool access regularly


### Issue Management

- Address CRITICAL and HIGH severity issues first
- Document how you resolved issues
- Look for patterns to prevent future issues


### Monitoring

- Review agent activity regularly
- Set up alerts for unusual behavior
- Track usage trends


## Getting Help

### Agents Not Showing Up?

- Check that your platform integration is enabled
- Verify platform permissions
- Wait a few minutes for the next sync


### Missing Information?

- Ensure platform API permissions are correct
- Check your network connection
- Review error messages in the integration settings


### Questions About Severity?

- Review the issue details and reasoning
- Check the category and remediation steps
- Contact support if ratings seem incorrect