Agents quickstart

// stock-agent.mjs   run with: node stock-agent.mjs
const API = "https://app.syntic.ai/v1/chat/completions";
const KEY = process.env.SYNTIC_API_KEY;
 
// Stand-in for your inventory system.
const INVENTORY = { "blue mug": 52, "travel lid": 31 };
const tools = {
  check_stock: ({ product }) => ({
    product,
    on_hand: INVENTORY[String(product).toLowerCase()] ?? 0,
  }),
};
 
const toolSpecs = [{
  type: "function",
  function: {
    name: "check_stock",
    description: "Units on hand for one product, looked up by its SKU or a short product name.",
    parameters: {
      type: "object",
      properties: { product: { type: "string" } },
      required: ["product"],
    },
  },
}];
 
const messages = [
  { role: "system", content: "You help warehouse staff. Use check_stock for every product you are asked about. Answer in one short paragraph." },
  { role: "user", content: "Do we have enough blue mugs and travel lids to ship 40 gift sets?" },
];
 
const MAX_TURNS = 8; // a hard stop, so a confused model cannot loop forever
 
for (let turn = 1; turn <= MAX_TURNS; turn++) {
  const res = await fetch(API, {
    method: "POST",
    headers: { Authorization: `Bearer ${KEY}`, "Content-Type": "application/json" },
    body: JSON.stringify({ model: "Amara S1.2", stream: false, messages, tools: toolSpecs }),
  });
 
  if (!res.ok) {
    const err = await res.json().catch(() => ({}));
    throw new Error(`${res.status} ${err.error ?? ""}: ${err.message ?? err.detail ?? ""} ` +
      `(request ${res.headers.get("x-syntic-request-id")})`);
  }
 
  const data = await res.json();
  const choice = data.choices[0];
  messages.push(choice.message);
 
  if (choice.finish_reason !== "tool_calls") {
    console.log(choice.message.content);
    break;
  }
 
  for (const call of choice.message.tool_calls) {
    const fn = tools[call.function.name];
    let result;
    try {
      result = fn ? fn(JSON.parse(call.function.arguments || "{}"))
                  : { error: `unknown tool ${call.function.name}` };
    } catch (e) {
      result = { error: `bad arguments: ${e.message}` };
    }
    messages.push({ role: "tool", tool_call_id: call.id, content: JSON.stringify(result) });
  }
}

# stock_agent.py   pip install openai, then: python stock_agent.py
import json, os
from openai import OpenAI
 
client = OpenAI(base_url="https://app.syntic.ai/v1", api_key=os.environ["SYNTIC_API_KEY"])
 
INVENTORY = {"blue mug": 52, "travel lid": 31}
 
def check_stock(product: str) -> dict:
    return {"product": product, "on_hand": INVENTORY.get(product.lower(), 0)}
 
TOOLS = [{
    "type": "function",
    "function": {
        "name": "check_stock",
        "description": "Units on hand for one product, looked up by its SKU or a short product name.",
        "parameters": {
            "type": "object",
            "properties": {"product": {"type": "string"}},
            "required": ["product"],
        },
    },
}]
 
messages = [
    {"role": "system", "content": "You help warehouse staff. Use check_stock for every product you are asked about. Answer in one short paragraph."},
    {"role": "user", "content": "Do we have enough blue mugs and travel lids to ship 40 gift sets?"},
]
 
for _ in range(8):  # hard stop
    reply = client.chat.completions.create(
        model="Amara S1.2", messages=messages, tools=TOOLS, stream=False
    )
    choice = reply.choices[0]
    messages.append(choice.message.model_dump(exclude_none=True))
 
    if choice.finish_reason != "tool_calls":
        print(choice.message.content)
        break
 
    for call in choice.message.tool_calls:
        try:
            args = json.loads(call.function.arguments or "{}")
            result = check_stock(**args) if call.function.name == "check_stock" \
                else {"error": f"unknown tool {call.function.name}"}
        except (ValueError, TypeError) as exc:
            result = {"error": f"bad arguments: {exc}"}
        messages.append({"role": "tool", "tool_call_id": call.id, "content": json.dumps(result)})