Installation & Activation

Prerequisites

• ChargePanda v1.3.0 or later
• PHP 8.2+
• A queue worker running (required for async agent execution)
• An API key from at least one supported LLM provider

---

1. Upload the module

1. Go to Admin → Modules and click Upload & Install.
2. Select the AiAgentsCore.zip file you downloaded from CodeCanyon.
3. Click Upload. ChargePanda extracts the ZIP, validates the manifest, and copies the files.
4. The module appears in the list with status Inactive.

If you also purchased a module that depends on AiAgentsCore (e.g. SeoAgents), include both ZIPs in a single bundle ZIP. The installer handles dependency order automatically.

---

2. Activate the module

Click Activate next to AiAgentsCore. This runs the module's database migrations and fires the setup event.

Migrations created:

• agent_runs — one row per agent execution
• agent_tool_calls — tool invocations within a run

---

3. Start the queue worker

Agent runs are processed asynchronously. You must have a queue worker running on the agents queue, otherwise jobs will sit pending and never execute.

For development:

php artisan queue:work --queue=agents

For production (recommended — Supervisor):

[program:chargepanda-agents]
command=php /path/to/artisan queue:work --queue=agents --sleep=3 --tries=1 --timeout=310
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/path/to/logs/agents.log

The --timeout on the worker should be slightly higher than the job timeout configured in Admin → AI Agents → Settings to give the job time to mark itself as failed before the worker kills it.

---

4. Configure the provider

Go to Admin → AI Agents → Settings and complete the setup:

1. Choose a provider (OpenAI, Anthropic, etc.)
2. Enter the API key for that provider
3. Select the model
4. Click Save Settings
5. Use the Playground → Connection Test to verify the key and model are working

---

5. Set up products and plans

Agent access is controlled through ChargePanda's plan entitlements system. Each agent module ships with a default product and three plans (Starter, Pro, Agency/Unlimited). These are created automatically when the module is activated.

To verify:

1. Go to Admin → Products and find the product created by the module (e.g. "SEO Agents").
2. Open the product and review the plans — each should have an entitlement row with the module's agent key.

To adjust run limits:

1. Edit a plan → open the Features tab.
2. Find the entitlement for the agent key (e.g. seo_agents).
3. Change the Value to the number of monthly runs (e.g. 100), or leave blank for unlimited.

---

6. Verify

Visit the customer-facing agent page to confirm agents appear and are gated correctly:

/account/agents

Users without an active subscription see all agents locked with an upgrade prompt. Users with an active plan see agents unlocked according to their plan entitlements.