AgentGuard Documentation

Learn how to install, configure policies, and integrate AgentGuard into your CI/CD pipeline.

1Quickstart CLI

Install the AgentGuard CLI via pip and run your first agent scan against local or production policies.

# Install CLI

$ pip install agentguard

# Scan an agent manifest against policy

$ agentguard scan --agent customer-support --manifest agent-manifest.json

2Deterministic Policy Definition

Policies define parameter thresholds, tool blacklists, and approval rules. Here is an example production policy:

{
  "version": "1.0",
  "scope": "production",
  "rules": [
    {
      "check": "max_tool_arg",
      "tool": "issue_refund",
      "arg": "amount",
      "limit": 100
    },
    {
      "check": "prohibit_tool",
      "tool": "delete_database"
    }
  ]
}

3GitHub Action Integration

Prevent unvalidated AI agent code from merging to main by adding agentguard-action to your workflow.

name: AI Security Gate

on: [pull_request]

jobs:
  agentguard-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Nagamiji/agentguard-action@v1
        with:
          agent: customer-support
          manifest: agent-manifest.json
          fail-on: unknown

← Try Interactive Demo GitHub Repo →