Manual Worker Setup

Prerequisites

• A Cloudflare account with an active domain (zone) using Cloudflare DNS.
• A free Cloudflare Workers plan is sufficient.
• An AgentFi account with at least one site added and crawled.
• For the Wrangler CLI method: Node.js (v18+) installed on your machine.

Step 1: Download the Worker Script

1. Go to Dashboard → AIO → [Your Site] → Integration.
2. Select the "Manual Deployment" tab.
3. Click "Download Worker Script."
4. Save the file as agentfi-aio-worker.js. The script is pre-configured with your account ID and base path.

Step 2a: Deploy via Wrangler CLI

Install Wrangler if you haven't already:

npm install -g wrangler
wrangler login

Create a wrangler.toml in the same directory as your downloaded script:

name = "agentfi-aio-worker"
main = "agentfi-aio-worker.js"
compatibility_date = "2024-01-01"

routes = [
  { pattern = "yourdomain.com/*", zone_name = "yourdomain.com" }
]

Replace yourdomain.com with your actual domain. Then deploy:

wrangler deploy

Step 2b: Deploy via Cloudflare Dashboard

Alternatively, you can deploy through the Cloudflare web dashboard:

1. Log in to dash.cloudflare.com.
2. Go to Workers & Pages → Create.
3. Name the Worker agentfi-aio-worker.
4. Click "Deploy" to create an empty Worker.
5. Click "Edit Code" and paste the contents of the downloaded script.
6. Click "Save and Deploy."
7. Go to Settings → Triggers → Routes and add a route:yourdomain.com/*

Step 3: Configure and Verify in AgentFi

1. Go back to the AgentFi Integration page and set the Client Domain to your site URL (e.g., https://yourdomain.com).
2. Set the Base Path if you changed it (default is /agentfi).
3. Click "Save Configuration".
4. Click "Verify" to confirm the Worker is responding correctly.
5. Click "Enable" to activate the integration and start health monitoring.

Once verified and enabled, AgentFi will monitor the integration every 10 minutes. If the Worker becomes unreachable, the dashboard will show a warning.