Skip to content
AIify It
← All articlesFIELD NOTES / AI delivery

AI delivery

Your AI Agent Demo Is Over. Can Anyone Start Testing?

The agent answered questions during the demo. People want to try it. Then someone asks where to log in, how to connect, and whether they can change the instructions. What does the pilot still need before useful testing can begin?

The next user starts cold

In an agent demonstration, a prospective tester asked for an interface to edit instructions and step-by-step help connecting to the system. A video already discussed in the meeting showed results, but did not cover the setup that person needed. The team proposed another walkthrough.

The conversation also raised a preference for using an existing chat application more familiar to the group. Those were requested or proposed changes. The discussion did not establish that the tutorial had been delivered, the preferred integration completed, or a tester group had accepted the product.

The practical lesson concerns the handoff after a demo. The builder knows which account to use, where the settings live, and what a successful connection looks like. Your next tester may have none of that context.

Separate setup problems from product feedback

An invitation to “try the agent and tell us what you think” leaves several questions unanswered. Is the person testing whether they can connect, whether the instructions fit their work, or whether the responses are useful? A problem with the first can prevent evidence about the others.

Give the pilot a short first-use path. It should identify the supported application, required account access, connection steps, a safe first task, and where to report a problem. Explain what the tester should see after each important step.

When feedback arrives, identify where the person stopped. “I could not find the connection” needs different work from “the answer ignored our policy.” Preserve that distinction in your feedback process so a setup problem does not disappear into a general request to improve the model.

Show how to start with the tester’s access

A useful setup guide begins from the screen a tester will actually have. Record or document the path with an ordinary test account rather than relying on an administrator’s already-connected session. Avoid showing credentials, private customer data, or unrelated account details.

Keep the walkthrough focused on the first successful use. A short video can make navigation easier to follow; written steps let someone resume after an interruption. Include the expected result and a recovery step for a missing option or failed connection.

Ask a colleague who was absent from the demo to follow the guide without coaching. Note where they pause or need information that the guide omitted. Revise those steps before inviting more people.

Treat this as a proposed readiness check, not a guarantee that onboarding will be effortless. The goal is to remove avoidable uncertainty and learn where real users still need help.

Replay the instruction before diagnosing the learner

Preserve the exact instruction, its version, the permitted task and the account role used for an attempt. Observe the first point where the available action or resulting behavior differs from the intended path. Ask what the participant understood the instruction to mean. Record their explanation as their account, rather than guessing at motivation or skill.

Consider a constructed walkthrough of a fictional, non-acting test interface. The guide says, “Check the draft, then click Approve to finish the test.” The ordinary tester’s screen offers only “Save feedback” and “Report a problem”; Approve exists only in the builder’s view. Searching for the missing button cannot establish poor training. The guide describes the wrong role. This example is synthetic, not an observed learner trial.

A corrected instruction for that mock screen is: “Compare the draft with the supplied source. Choose Save feedback to record your evaluation; this does not send the draft. If the sources conflict, choose Report a problem and identify the conflicting passages.” The real guide must use the actual supported labels, permissions and effects, verified with the tester’s account.

Separate the repair: missing permission goes to the access owner, an unsettled business rule to its decision-maker, a misleading control to the interface owner and an unclear explanation to the guide. Changing all four at once makes it harder to learn what prevented the attempt.

In chapter 11 of Planning for Human Systems, pages 152–156, Donald A. Schön describes how replaying misleading instructions changed an interpretation of a learner’s apparent difficulty. The application here is to inspect the instruction and context before judging the person. It is not a claim about a model’s inner understanding.

Check independent use, then change the case

After revising the guide, ask a different participant to try without having watched the repair. Then give them an unrehearsed permitted case, such as conflicting source passages instead of the earlier straightforward match. Look for the required decision and usable feedback, not merely the same sequence of clicks. A coached success on the original example does not show independent use or transfer.

Keep supported learning effort separate from routine capacity. Record help given, attempts, corrections and whether the participant could finish unaided; do not turn a first attempt or a best coached run into a staff quota. Taylor distinguishes first-time work from familiar performance in Shop Management, pages 78 and 174–176. That limited distinction supports budgeting practice time, without adopting his work-rate or pay prescriptions.

Make business instructions reviewable

The person best placed to judge an agent’s behavior may also need to correct its business guidance. Decide who can edit those instructions, which user group the changes affect, and who can approve them for broader use.

Give the editor enough context to understand the scope. A change intended for an internal team should not quietly become the instruction for every external user. Show the current version, affected group, and the point at which a saved change becomes active.

Keep a record of the instruction version used during each feedback session. Otherwise, two testers may be evaluating different behavior while appearing to disagree about the same agent. Retain a known baseline so you can compare a proposed change with the earlier instructions.

Use approved business guidance and synthetic examples when possible. The ability to edit a prompt should not become a reason to paste confidential information into a broadly shared configuration.

Test in the client people will use

An existing chat application can make a pilot easier to approach when it fits the task and the intended users already have appropriate access. Confirm that the planned connection actually works in that application before describing it as supported.

A request to support another client is still work to schedule and verify. Document any limitations affecting the pilot, including which features are available and which account or group can use them. Avoid assuming a successful demonstration in one client establishes the same behavior in another.

If the first pilot uses a different interface from the intended rollout, state that boundary. Collect feedback about the agent’s job separately from feedback about the temporary interface. That makes it easier to decide what must change before the next group participates.

Ask for evidence people can provide

Choose a bounded set of participants and give them realistic, permitted tasks. Explain any usage limits before they begin. Assign someone to respond to access problems so the whole testing period is not consumed by setup questions.

For each task, request the question asked, what the person expected, what the agent returned, and whether that answer helped them take the next step. Use an approved feedback channel and minimize sensitive content. Ask for a concise reproduction rather than an unrestricted conversation export.

Track where participation reaches: invited, connected, first task completed, and useful feedback received. These stages help you see whether the immediate obstacle is access, first use, or the quality of the agent’s answers.

Before calling the pilot ready, ask someone outside the build team to start from the invitation and submit one usable feedback report. That small handoff exercise gives the next testing round a clear starting point and an owner for anything still missing.

Keep exploring

← Back to all articles