Quickstart: rehearse your first AI agent in five minutes

// A toy agent that speaks sandtable's HTTP step protocol. Replace decide() with your agent.
import { createServer } from "node:http";

function decide(step) {
  if (step.message !== undefined) {
    // A new user turn. A real agent appends it to the history it keeps under step.session_id.
    const mc = /\bMC\s*#?\s*(\d{5,7})/i.exec(step.message)?.[1];
    if (!mc) return { reply: "Thanks for calling. What's your MC number?" };
    return { tool_calls: [{ id: "c1", name: "verify_carrier", arguments: { mc_number: mc } }] };
  }
  // Results of the tool calls this agent asked for in its previous response.
  const [result] = step.tool_results;
  if (!result.ok) return { reply: "I couldn't find that MC number." };
  return { reply: `Thanks, ${result.result.name}, you're verified. Let me get a rep to finish the booking.` };
}

createServer(async (req, res) => {
  let body = "";
  for await (const chunk of req) body += chunk;
  res.setHeader("content-type", "application/json");
  res.end(JSON.stringify(decide(JSON.parse(body))));
}).listen(8787, () => console.log("agent listening on http://localhost:8787/step"));

# A toy agent that speaks sandtable's HTTP step protocol. Replace decide() with your agent.
import json
import re
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer


def decide(step):
    if "message" in step:
        # A new user turn. A real agent appends it to the history it keeps under step["session_id"].
        m = re.search(r"\bMC\s*#?\s*(\d{5,7})", step["message"], re.I)
        if not m:
            return {"reply": "Thanks for calling. What's your MC number?"}
        return {"tool_calls": [{"id": "c1", "name": "verify_carrier", "arguments": {"mc_number": m.group(1)}}]}
    # Results of the tool calls this agent asked for in its previous response.
    result = step["tool_results"][0]
    if not result["ok"]:
        return {"reply": "I couldn't find that MC number."}
    return {"reply": f"Thanks, {result['result']['name']}, you're verified. Let me get a rep to finish the booking."}


class Handler(BaseHTTPRequestHandler):
    def do_POST(self):
        step = json.loads(self.rfile.read(int(self.headers["Content-Length"])))
        body = json.dumps(decide(step)).encode()
        self.send_response(200)
        self.send_header("Content-Type", "application/json")
        self.send_header("Content-Length", str(len(body)))
        self.end_headers()
        self.wfile.write(body)


ThreadingHTTPServer(("127.0.0.1", 8787), Handler).serve_forever()