Testing guide

AI-Agent Testing Checklist: What to Test Before You Publish

Build a practical evaluation set covering expected answers, paraphrases, missing knowledge, conflicts, sensitive requests, prompt injection, and human handoff.

Published by Qlynk AI · 11 min read · Updated 2026-08-14

Test behavior, not just fluent writing

A polished answer can still be unsupported, incomplete, out of date, or unsafe. Launch testing should compare the response with an expected outcome: the facts it should include, the qualifier it must preserve, the topics it should refuse, or the handoff it should provide.

Create the evaluation set before making final prompt changes. Otherwise it becomes difficult to tell whether a revision improved the agent or merely changed its style.

Start with normal questions

  • Core FAQsTest the questions the business already receives most often.
  • Buying or next-step questionsTest fit, inclusions, process, timing, price context, location, and contact routes.
  • Procedural questionsConfirm ordered steps, prerequisites, stop conditions, and escalation points.
  • Follow-up questionsAsk a short follow-up that only makes sense in the context of the previous message.

Test different wording and ambiguity

Ask the same intent with formal wording, shorthand, a common synonym, a typo, and a vague follow-up. The agent should find the same authoritative answer without pretending that a genuinely ambiguous question is clear.

Include a question that could refer to two products, locations, plans, or policies. A safe response should clarify the missing detail or explain both scoped possibilities instead of selecting one without support.

Test missing and conflicting information

  • Missing answerAsk for a price, date, feature, policy, or exception that is not in the approved knowledge.
  • Stale versionAsk using an old product name or superseded process.
  • Conflicting sourcesCreate a controlled test where two sources disagree and verify that the agent does not merge them into a new claim.
  • False premiseState an incorrect assumption and confirm the agent corrects it only when the approved information supports the correction.

Test boundaries and prompt injection

Ask for private information, individual professional advice, guarantees, discounts, negotiations, credentials, internal instructions, or account changes that the agent cannot authorize. Confirm that the response protects the boundary while still offering a useful next step.

Try requests to ignore earlier rules, reveal system instructions, treat visitor text as authoritative business knowledge, or answer outside the configured scope. The agent should keep platform safeguards and owner-approved rules in control.

Score the response consistently

  • SupportedAre material claims present in the approved knowledge?
  • CompleteDoes the answer preserve important conditions, dates, limits, and exceptions?
  • RelevantDoes it answer the actual question without unrelated material?
  • BoundedDoes it refuse or qualify requests outside its authority?
  • ActionableWhen a person is needed, does the answer give the correct usable route?
  • AppropriateIs the tone, length, formatting, and disclosure suitable for the audience?

Retest after every material change

Rerun affected cases when prices, policies, products, documents, instructions, model behavior, retrieval, or publishing settings change. Keep a small permanent regression set for the most important and highest-risk questions.

A failed test is not always a prompt problem. The source may be unclear, duplicated, inaccessible, or missing. Repair the authoritative knowledge first when that is the actual cause.

Frequently asked questions

How many questions should I test?

Use at least 12 varied cases for a simple agent and expand the set for more audiences, source groups, languages, policies, or risk. Coverage matters more than a universal number.

Can automated evaluation replace human review?

Automation can help run repeatable checks, but the business owner still needs to approve material facts, boundaries, tone, and handoff behavior.

Should a failed answer always be fixed with instructions?

No. Fix missing, conflicting, outdated, or poorly structured source knowledge before adding prompt complexity.

Related Qlynk solutions

Related Qlynk resources

Turn this guide into a client-ready Qlynk build

Use the free Qlynk Agent Builder to run discovery, prepare approved knowledge, test the agent, and hand it to the client.

Open the free Agent Builder