← Back to Learn
best-practicesdeploymentguardrails

Agent Onboarding Safety Checklist

Authensor

Adding a new AI agent to your infrastructure is similar to onboarding a new employee with system access. The agent needs credentials, permissions, policies, and monitoring. Skipping these steps creates security debt that compounds over time.

Identity and Access

  • [ ] The agent has a unique identifier in your system
  • [ ] API keys are generated specifically for this agent (not shared with other agents)
  • [ ] Keys are scoped to the minimum required role (not admin)
  • [ ] Credentials are stored in a secrets manager
  • [ ] A credential rotation schedule is established

Policy Definition

  • [ ] A YAML policy is written specifically for this agent's use case
  • [ ] The policy uses deny-by-default rules
  • [ ] Every tool the agent needs is explicitly permitted with parameter constraints
  • [ ] High-risk actions are gated behind approval workflows
  • [ ] The policy has been reviewed by someone other than the author

Content Safety

  • [ ] Aegis scanning is enabled for input and output
  • [ ] Detection rules are appropriate for the agent's domain
  • [ ] Scanning thresholds are tuned (not just defaults)
  • [ ] PII detection is enabled if the agent handles personal data

Monitoring

  • [ ] Sentinel behavioral monitoring is enabled
  • [ ] Baseline behavior is established during a shadow-mode period
  • [ ] Alert rules are configured for anomalous behavior
  • [ ] The agent is added to the monitoring dashboard

Testing

  • [ ] The policy is tested with legitimate use case inputs
  • [ ] The policy is tested with adversarial inputs
  • [ ] Approval workflows are tested end to end
  • [ ] The kill switch is tested and verified
  • [ ] Shadow mode evaluation matches expected allow/deny patterns

Documentation

  • [ ] The agent's purpose and scope are documented
  • [ ] The agent's tool access is documented
  • [ ] The agent's owner and responsible team are documented
  • [ ] Incident response contacts are identified

Shadow Mode Period

  • [ ] The agent runs in shadow mode for at least one week
  • [ ] Shadow mode results are reviewed and anomalies are investigated
  • [ ] Policy adjustments are made based on shadow mode findings
  • [ ] A go-live decision is made and documented

Do not skip the shadow mode period. Running the agent in evaluate-only mode before enabling execution catches policy gaps, unexpected tool usage patterns, and configuration errors without risk.

Keep learning

Explore more guides on AI agent safety, prompt injection, and building secure systems.

View All Guides