Installation & Setup

1. Install the plugin

composer require klick/agents:^0.10.2
php craft plugin/install agents

2. Run migrations (if needed)

php craft up

This creates plugin tables for:

• managed agents
• internal control policies
• approvals
• execution ledger
• audit log

3. Open the Control Panel

Primary route:

• admin/agents/dashboard/overview

Navigation entry points:

• Sidebar: Agents
• Plugin settings page (admin/settings/plugins) redirects to Dashboard overview

4. Validate key endpoints

Public discovery (if enabled):

• GET /llms.txt
• GET /llms-full.txt
• GET /commerce.txt

API:

• GET /agents/v1/health
• GET /agents/v1/schema
• GET /agents/v1/capabilities
• GET /agents/v1/auth/whoami (requires token + auth:read)
• GET /capabilities (alias to /agents/v1/capabilities)
• GET /openapi.json (alias to /agents/v1/openapi.json)

5. Configure auth before production

By default, API token auth is required.

Set at least one credential source:

• PLUGIN_AGENTS_API_TOKEN
• PLUGIN_AGENTS_API_CREDENTIALS
• Managed key from CP Agents -> Agents