Suede AI Agent StudioDocsStart buildingOpen workspace
Navigation menu

Agents & workflows4 min readUpdated

Build an AI lead qualification agent that scores every lead

Quick answer

Agent Studio's Lead Qualifier template scores every inbound lead from 1 to 10 on fit and intent, writes the reason in one sentence and recommends the next step. Open it in the builder, describe your ideal customer in the prompt, dry-run it free, then deliver each score to your CRM or start it from a form so your team calls the best leads first.

What you'll have

  • A lead qualification agent that returns a score, a reason and a next step for every lead
  • Your ideal customer profile written into the prompt, so scores match how you sell
  • Hot leads routed to a task or a pipeline stage the moment they come in
On this page
  1. What does an AI lead qualification agent do?
  2. How do I build a lead qualification agent?
  3. How do I send hot leads straight to my team?
  4. How do I make the scores match how I sell?
  5. Questions

What does an AI lead qualification agent do?#

It reads each new lead and tells you who to call first. The Lead Qualifier template runs three steps: the lead comes in, a Claude step scores it 1 to 10 on fit and intent, and the result goes out as JSON with score, reason and next. A CRM Webhook step sits after the scoring step so every qualification lands in your CRM.

What the Lead Qualifier returns for each lead
FieldWhat it holdsHow your team uses it
scoreA number from 1 to 10 for fit and intentSort the queue so the best leads get the first call
reasonOne sentence explaining the scoreSee the logic and override it when you know more
nextThe recommended actionBook a call, send a case study, or move the lead to nurture

Your numbers

What slow replies cost in closed deals

Enter your pipeline. Then set how many leads go cold at each reply speed, from what you see in your own inbox.

Your assumption: share of leads that go cold

These starting values are placeholders, not research. Set them to match your pipeline.

Deals lost each month

5

Revenue lost each month

$7,500

Each year

$90,000

Replying same day, 25 leads a month go cold before you answer. An AI employee replies in seconds, qualifies the lead and books the call.

How do I build a lead qualification agent?#

Start from the template, teach it your ideal customer, and test it with the sample lead that ships loaded. The first dry run works on the first click.

Launch your lead qualifier

0 of 5 done

  1. Step 1: Open the Lead Qualifier template

    The canvas opens with the sample lead, the scoring step and the CRM delivery step already wired.
    Open the template
  2. Step 2: Write your ideal customer into the prompt

    Click the LLM (Claude) step and add who buys from you: industry, size, budget signals, and the phrases that mean someone is ready. Keep the JSON output line so every score comes back in the same shape.
  3. Step 3: Dry-run it free

    Press Run test. Every step runs in order and you see each result. Swap the sample lead for three real ones from last month and check the scores against what actually closed.
  4. Step 4: Connect delivery

    Bind a webhook Connection on the CRM Webhook step so each qualification posts to your CRM or automation tool.
    Open Connections
  5. Step 5: Launch and watch the first runs

    Press Launch, send real leads, and open Runs to see every score with its reason and cost.
    Open Runs

How do I send hot leads straight to my team?#

Put the scoring inside a CRM workflow and act on the score. In Automations, start a workflow with the Form or survey submitted or Contact created trigger, score the lead with a Claude step, then route it.

  • Create Task gives a rep a call-back task due in an hour for any lead that scores high.
  • Opportunity opens a deal in the right pipeline stage, so the lead shows up on your board.
  • Add Note pins the reason to the contact's timeline, so whoever calls knows why the lead matters.
  • Send Email or Send Text replies to every lead within a minute, including the ones you nurture.

How do I make the scores match how I sell?#

Feed it the same facts your best rep uses. Put your ideal customer profile in the System prompt and the scoring rules in the Prompt, and ask for the same JSON shape every time.

Score higher when the lead names a service you offer, lives in your service area, and wants the job done this week. Score lower for quotes with no address or a job type you refer out.

Questions buyers ask#

Can an AI agent qualify leads without a human?

Yes. The Lead Qualifier scores, explains and recommends a next step for every lead with no one watching, and your CRM workflow acts on the score. You keep the final call on deals because every score carries its reason.

What does GoHighLevel call lead scoring, and where is it in Agent Studio?

GoHighLevel builds lead scoring from contact fields and workflow actions. In Agent Studio a Claude step reads the whole lead and writes a 1 to 10 score with its reason, and the same CRM workflow builder acts on it.

Do I need a CRM to use the lead qualifier?

No. Agent Studio ships its own CRM with contacts, pipelines and tasks, and the agent works with it directly. Already on another CRM? Point the CRM Webhook step at it.

How do I test the lead qualifier before it touches real leads?

Press Run test on the canvas. Dry runs are free and send nothing anywhere. Turn on Run for real when you want live model scores on your own sample leads.

Can I start the agent from my website form?

Yes. Build the form in CRM Forms, then start a workflow with the Form or survey submitted trigger. Every submission is scored the second it arrives.

Was this page helpful?

Good work starts with a clear flow.

Give an agent a job. Connect the steps. See how the work becomes a service someone else can call.

Input
Reason
Output

A workflow you can inspect

Make the steps visible.

Start with a template or describe the job. Connect inputs, reasoning, and output on the canvas.

Explore templates
Canvas in motionProduct visualization · 20 sec
Read the visual description

A stylized organization chart opens into a workflow canvas. Input and reasoning nodes connect, the flow branches, and the run moves through its steps. The film ends with Suede AI Agent Studio. Music only; no spoken narration.