How to Test Your Agents (step-by-step)

You created your agents — now let’s test them the same way your users will experience them.

Quick Start — Test Your Agents in 5 Steps

  1. Enable your agents for your Product (turn them ON, especially your Exclusive agents).
  1. Click Open Product to enter your live platform (Preview).
  1. Go to Chat → Agents.
  1. Use the Exclusive filter to see your private agents.
  1. Click ▶ Play on the agent you want to test and run a real conversation.

Step 1 — Enable your agents for your Product

  • In your admin, open Product.
  • Go to Agents inside the product.
  • Toggle ON the agents you want available in this product (especially your Custom agents).
    • If an agent isn’t enabled here, it won’t show up for testing inside the product.
Tip: Check each agent’s Visibility. For this guide we’ll toggle so you can test exactly what your customers will see.
Notion image

Step 2 — Open your platform (Preview)

  • In the Product header, click Open Product.
  • This opens your platform as a user would see it.
    • Notion image

Step 3 — Find your agents inside the app

  • In the left menu, go to Chat → Chat Agents.
  • At the top, open the filter and choose Featured to see only your Featured agents.
  • You should now see all the agents you enabled for this product.
Don’t see your agent?
Notion image
Notion image

Step 4 — Run a realistic test

  1. Pick an agent and click ▶ Play.
  1. Send a real input your users would send:
      • Text-only message (simple scenario)
      • Attach a document (PDF/TXT) if your agent is meant to read docs
      • Upload an image/screenshot if your agent should interpret visuals
  1. Check the response matches what you promised (tone, structure, output format).
  1. Iterate quickly: if something feels off, update the agent’s Description (context) and test again.
Best-practice test script

Troubleshooting checklist

  • Agent not visible
    • Enabled in Product → Agents?
    • Visibility set correctly and filter matches?
    • Refresh after changes.
  • Weak or generic answers
    • Add 1–2 input → output examples to guide the agent.
    • Be explicit about audience, domain terms, and constraints in the Description.
  • Docs or images not considered
    • Confirm you actually attached the file/screenshot in the chat.
    • In the Description, tell the agent how to use those files (e.g., “summarize the PDF first, then write a response”).

You’re done

Once your agents are enabled, visible under Chat → Agents, and pass a realistic ▶ Play test (text, docs, and/or images), you’re ready to invite users to try them. If anything looks off during testing, a quick edit to the Description and a re-test usually fixes it fast.

Did this answer your question?
😞
😐
🤩