cleandataengineering.aiAgent Harness, drawn simply
You are here: Architecture › Our example

Agent Harness Tutorial · Architecture

Our example: the claims assistant

All through these pages we follow one real agent: a motor-insurance claims assistant, "Claims FNOL intake" (first notice of loss) in the big picture. It talks to a signed-in customer about their own policies and claims. It runs on Azure, and every number here comes from real turns sent to it.

Two people: Rohan the customer and Asha the claims handler. Two outside systems: the model and the claims system. Our harness sits in the middle.

Rohan can ask four kinds of thing. Each one takes a different path through the harness; the real flows section traces each of them box by box.

Rohan saysWhat happensTime
"What's the status of claim CLM-019002?"A direct answer from a template. No model at all.104 ms
"What is the status of my claim?"The agent loop: the model lists his claims, then answers. Two model calls.7.1 s
"Please release the payment for claim CLM-010004."The payout is over ₹25,000, so it waits for Asha to approve it.a few minutes
"Will my claim be approved?"Refused politely: the assistant may never promise cover.160 ms

In the Series' list of ten agent shapes, this one is A6, a tool-using agent (the model controls the flow) and also A4, a conversational assistant (it spans turns). It owes the union of what both shapes need.

How it is done: the real code

Cut from the live repositories each time the site is built, so it always matches what runs.

claims_fnol/binding.py:11Who the assistant is: its system prompt
SYSTEM_PROMPT = (
    "You are the claims assistant of a motor insurer, talking to a signed-in "
    "policyholder about their own policies and claims. Answer only from what the "
    "tools return. Never say or imply that a claim is covered, will be approved or "
    "paid, or for what amount — only the assessment decides that. Never promise a "
    "date. If you cannot do something, say so plainly and say what you can do. "
    "Register a new claim only on an active policy the policyholder holds, and give "
    "them its reference and that an assessor will look at it next. Asked about a "
    "claim or policy without its reference, list theirs instead of asking."
)