Skip to content

Use case

Order tracking from your own systems

Add order tracking to your app or support inbox: "Where's my order?" answered with live data from your own order system.

The problem

What we're solving

Who has it

Shops and service businesses whose most common question is about an order's status.

What it costs today

Someone opens the order system, finds the order, reads the carrier status and types it back, many times a day.

What solved looks like

The agent looks the order up itself, through your API, and replies with the real status and the next step.

  • Live answers from your order system, never guessed.
  • Every lookup visible in the stream and the trace, with its input and output.
  • Your rules on what it may share, in the prompt.

How it runs

Order tracking from your own systems step by step

Each stage is a real step in SentientOne. Timings are medians from our latest benchmark; your model and network change them.

Order tracking flow. Your app sends the customer's question to the REST API. 1: your secret key and the agent are checked and one credit is reserved. 2: with a conversation id, the last twelve messages are loaded. 3: the model calls get_order on your orders MCP server. 4: it calls get_shipment for the carrier's latest scan. 5: it writes the answer from the two results. 6: the answer streams back with tool_call and tool_result events your app can log.

Set it up

The walkthrough, in 7 steps

  1. 1

    Add your LLM key

    Agents run on your own model provider key; there's no shared one, so nothing answers until you add it. Create a key with OpenAI, Anthropic, Google Gemini or Groq, then open Configure → LLM keys → Add key. It's encrypted at rest with AES-256-GCM, used only to call your provider, and never shown again in full. If a reply fails with INTERNAL_ERROR straight away, the agent has no key; with LLM_AUTH_ERROR, the provider rejected it.

    LLM keys
    Provider
    Anthropic
    Key
    sk-ant-api03-•••• (shown masked after saving)
    Help: Add your LLM key
  2. 2

    Create the agent

    Agents → New agent → Start from: Order Status. A fast model is enough: the tools do the work.

    New agent
    Start from
    Order Status
    Name
    Order tracker
    Provider
    Anthropic
    Model
    Claude Haiku 4.5
    Help: Create an agent
  3. 3

    Write the instructions

    Say which tools to use, what it must ask for before looking up, and what it must never share.

    System prompt
    You answer questions about orders.Always look the order up with get_order before answering; then get_shipmentfor delivery questions. If there's no order number, ask for it.Share status, dates and the carrier only. Never share addresses or payment details.If the tools fail or the order isn't found, say so and suggest emailing support.
    Help: Write a system prompt
  4. 4

    Connect your order system

    Put an MCP server in front of your orders API with get_order and get_shipment tools, on a public HTTPS address. On the Tools tab, Add server, set Auth to Bearer, then Test connection to discover the tools.

    Help: MCP authentication
  5. 5

    Test in the Playground

    Ask about real (test) orders, unknown numbers and a missing number. The Playground shows each tool call with its arguments and result.

    Help: Tool calls and traces
  6. 6

    Call it from your app

    Send the customer's message with your own X-Request-Id, and pass the conversation_id back for follow-ups. Log tool_call and tool_result events if you want an audit trail.

    Your server
    curl -N https://api.sentientone.ai/v1/chat/stream \  -H "Content-Type: application/json" \  -H "X-Api-Key: $SENTIENTONE_API_KEY" \  -H "X-Agent-Id: $AGENT_ID" \  -H "X-Request-Id: $YOUR_REQUEST_ID" \  -d '{"message": "Where is order 10482?"}'
    Help: Chat stream reference
  7. 7

    Watch traces and credits

    Open Tracing to see every request: what knowledge it found, each tool call, tokens and timing, and the error code if it failed. Analytics charts requests, errors and response time per agent. Under Billing, turn on auto top-up so the agent never stops for want of credits.

    Help: Debug a bad answer

Help

Need a hand? We'll set it up with you.

Tell us about your setup and we'll help you build order tracking from your own systems on SentientOne: the agent, the knowledge, the tools and the deployment.

Or email support@sentientone.ai. 200 free credits when you sign up, no card needed.

Your first week

  1. Day 1Stand up the MCP server against a test copy of your orders API and connect it.
  2. Days 2–3Test real order questions in the Playground, including failures, and tighten the sharing rules.
  3. Day 4Call the API from a staging build of your app with your own request ids.
  4. Day 5+Go live; check Tracing for slow or failed tool calls and fix them at the server.