Skip to main content

Agent Demos Need Interfaces

· 5 min read
Trevor Grant
Builder in Chief

The agent calls a search tool, reads a few documents, updates a record, and produces a plausible answer. The steps appear one after another in the terminal. The room gets quiet. For a moment, it feels like the hard part is over.

Then someone asks where their team would click.

That question can sound superficial next to the model, tools, and orchestration behind the demo. It is not. It is the beginning of the product conversation.

A demonstration proves that an agent can act under prepared conditions. A product has to give a person a reliable place to start the work, inspect what happened, correct a mistake, approve an action, reject an answer, and recover when the prepared conditions do not appear.

The interface is where those responsibilities become visible.

A Result Is Not Yet A Product

Agent demos tend to emphasize the interesting middle. A request enters, the model reasons, tools run, and a result appears. That is enough to demonstrate a capability. It is not enough to operate that capability repeatedly.

Real work has a before and an after. Before the run, someone needs to know what the system requires, which sources it will use, and what it is allowed to do. After the run, someone needs to know whether it finished, what changed, what needs review, and what happens next.

A prompt box can accept a request. It does not necessarily explain what makes a good request. A terminal can display activity. It does not necessarily show which activity matters to the person responsible for the outcome. A final answer can look polished while hiding missing inputs, uncertain claims, failed tool calls, or decisions that should never have been made automatically.

The interface does not need to expose every implementation detail. It needs to expose the details required to operate the work.

The Jobs The Interface Must Do

The first job is showing state. Is the request waiting, running, blocked, complete, or awaiting approval? If the system cannot answer that plainly, the operator has to reconstruct the workflow from logs or ask an engineer.

The second is preserving history. People need to see what entered the system, which sources and tools were used, what it produced, what a reviewer changed, and what action followed. History makes a result inspectable. It also makes the system improvable, because a bad outcome can become a case to learn from instead of a mystery everyone argues about.

The third is supporting review. The interface should put the evidence, draft, and decision next to the controls a reviewer actually needs. Approve, edit, reject, request more information, and escalate are not decorative buttons. They are part of the workflow's risk boundary.

The fourth is communicating uncertainty without turning the screen into a research paper. A generic confidence score is rarely enough. The useful signal may be that a required document was missing, two sources disagreed, a tool returned stale data, or the case fell outside the examples used to design the system. The person needs to know why attention is required.

The fifth is control. An operator should be able to stop a run, narrow its scope, retry a failed step, change an input, and prevent an external action. Automation without an accessible brake is difficult to deploy responsibly.

Finally, the interface needs a recovery path. Tools time out. Permissions change. APIs return partial records. Models misunderstand instructions. A usable product does not pretend these failures disappear. It tells the person what happened, preserves the work that is still valid, and offers a sensible next move.

From AgentLabUI To Gofannon

AgentLabUI / Gofannon came from this gap between an agent capability and a usable surface. AgentLabUI provided a web interface for configuring, deploying, testing, and monitoring agents. Gofannon carried the idea toward composing tools, data sources, and decision points, then wrapping the resulting workflow in a lightweight application.

The important lesson was not that every agent needs a large dashboard. Many do not. The lesson was that the people operating an agent should not have to think like the people building its orchestration.

The backend may contain multiple models, tools, retries, branches, and data sources. The operator may only need a structured intake form, a clear status, the evidence behind a draft, and three well-chosen actions. That apparent simplicity is not evidence that the system is simple. It is evidence that someone did the product work required to contain the complexity.

This is also why the workflow is the product. The model call matters, but the durable value lives in how requests enter, how work moves, where judgment remains, and how outcomes reach the next person. The interface is the operating surface for that workflow.

Buyers Need A Way To Operate It

A buyer evaluating an agent does not only need proof that it can perform a task. They need to know whether their team can operate it safely after the builder leaves the room.

Can a new user understand how to begin? Can a manager see what is waiting for review? Can the owner trace a questionable output to its inputs? Can someone stop a consequential action? Can the team recover from an ordinary failure without opening a support ticket or reading framework logs?

Those questions are not requests for polish. They determine adoption, accountability, and operating cost. A technically impressive agent that requires a developer to supervise every run has moved the labor; it has not necessarily reduced it.

The rule of thumb is simple: if the only interface is a prompt box or a terminal, assume there is more product work ahead. The demo may have proved the agent can act. The interface proves people can use, supervise, and trust it.