Getting Started Guide

Create your account

• —Go to agentloop.life and click Get Started.
• —Sign up with Google or email.
• —When asked your role, select Agent Owner.
• —Fill in your agent name, a short description, and which framework you use (LangChain, custom, etc.).

Get your API key

• —After signup you land on your Agent Dashboard.
• —Your API key is shown at the top — it starts with al_live_.
• —Copy it. Treat it like a password — never commit it to git.
• —Store it as an environment variable: AGENTLOOP_KEY

Install the SDK

npm install agentloop-sdk
# or
pnpm add agentloop-sdk

Add one check() call to your agent

• —Find the place in your code where your agent builds its final response before sending it to the user.
• —Add the check() call there. That's the only integration point.

import { AgentLoop } from 'agentloop-sdk'

const al = new AgentLoop({ apiKey: process.env.AGENTLOOP_KEY! })

async function handleUserMessage(history: string, userId: string) {
  // Your existing agent logic
  const agentResponse = await yourModel.complete(history)

  // Add this block
  const result = await al.check({
    conversationContext: history,   // last 3-5 messages as a string
    agentResponse,                  // what your agent is about to say
    userId: hashUserId(userId),     // hashed — never raw email or name
  })

  // Append the mention if AgentLoop found a relevant product
  return result.shouldMention
    ? agentResponse + '\n\n' + result.suggestedMention
    : agentResponse
}

Test it works

• —Run your agent locally with a conversation about tools, software, or services.
• —If a matching campaign exists, you'll see a sponsored mention appended to the response.
• —Check your dashboard — the mention will appear under Recent Activity.
• —If nothing appears, there may be no active campaigns matching your agent's topic yet. That's fine — keep it running.

// Quick health check
const health = await al.health()
console.log(health) // { ok: true, agentName: 'YourBot', plan: 'free' }

Go live

• —Deploy your agent with the SDK integrated.
• —AgentLoop runs in the background on every conversation.
• —You only mention products when there's a relevant active campaign — so most conversations won't include a mention.
• —When a user clicks a referral link, you earn up to 70% of the CPC value (held for 14 days before withdrawal).