SentientOne AI Chat API

curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{ "message": "Hello!" }'

curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{
    "message": "Get the order details for OrderId: ORD-1234 and UserId: USR-5678"
  }'

{
  "conversation_id": "conv-uuid-...",
  "message": {
    "id": "msg-uuid-...",
    "conversation_id": "conv-uuid-...",
    "role": "assistant",
    "content": "The order ORD-1234 is currently shipped via FedEx (tracking FX-998877)...",
    "token_count": 156,
    "created_at": "2025-03-04T14:30:00Z"
  },
  "tool_calls": [
    {
      "name": "get_order",
      "input": { "order_id": "ORD-1234", "user_id": "USR-5678" },
      "output": "{\"status\":\"shipped\",\"carrier\":\"FedEx\",...}"
    }
  ]
}

curl -N -X POST https://your-domain.com/api/chat/public/stream \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: a1b2c3d4-e5f6-7890-abcd-ef1234567890" \
  -d '{ "message": "Get the order details for OrderId: ORD-1234" }'

data: {"type":"meta","conversation_id":"conv-uuid-..."}

data: {"type":"tool_call","id":"tc-1","name":"get_order","input":{"order_id":"ORD-1234"}}
data: {"type":"tool_result","id":"tc-1","name":"get_order","output":"{\"status\":\"shipped\"}"}

data: {"type":"delta","content":"The order ORD-1234 is"}
data: {"type":"delta","content":" currently shipped via FedEx"}
...
data: {"type":"done","message":{"id":"msg-uuid","role":"assistant","content":"...","token_count":156}}

const res = await fetch("https://your-domain.com/api/chat/public/stream", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "text/event-stream",
    "X-Api-Key": "sk-so-your_api_key_here",
    "X-Agent-Id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  },
  body: JSON.stringify({ message: "Get the order details for OrderId: ORD-1234" }),
});

const reader = res.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let fullContent = "";

while (true) {
  const { value, done } = await reader.read();
  if (done) break;
  buffer += decoder.decode(value, { stream: true });
  const lines = buffer.split("\n");
  buffer = lines.pop() ?? "";
  for (const line of lines) {
    if (!line.startsWith("data: ")) continue;
    const event = JSON.parse(line.slice(6));
    if (event.type === "meta") console.log("conversation:", event.conversation_id);
    if (event.type === "tool_call") console.log("Calling tool:", event.name, event.input);
    if (event.type === "tool_result") console.log("Tool result:", event.output);
    if (event.type === "delta") { fullContent += event.content; process.stdout.write(event.content); }
    if (event.type === "done") console.log("\nTokens used:", event.message.token_count);
  }
}

# First message — starts a new conversation
curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "Look up order ORD-1234 for user USR-5678" }'
# Response: { "conversation_id": "conv-abc-123", "message": { ... } }

# Follow-up — continues the same conversation with full context
curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "What is the delivery ETA for that order?", "conversation_id": "conv-abc-123" }'

{
  "error": "agent_id and message are required"
}

# From your e-commerce backend, customer portal, or mobile app
curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: ORDER_AGENT_UUID" \
  -d '{ "message": "Get full order details including delivery and products for OrderId: ORD-78923 and UserId: USR-4412" }'

{
  "conversation_id": "conv-...",
  "message": {
    "role": "assistant",
    "content": "{\n  \"order_id\": \"ORD-78923\",\n  \"status\": \"shipped\",\n  \"customer\": \"USR-4412\",\n  \"items\": [\n    { \"name\": \"Wireless Headphones\", \"qty\": 1, \"price\": 89.99 },\n    { \"name\": \"USB-C Cable\", \"qty\": 2, \"price\": 12.99 }\n  ],\n  \"total\": 115.97,\n  \"delivery\": {\n    \"carrier\": \"FedEx\",\n    \"tracking\": \"FX-998877\",\n    \"estimated_delivery\": \"2025-03-07\",\n    \"status\": \"in_transit\"\n  }\n}",
    "token_count": 198
  }
}

curl -X POST https://your-domain.com/api/chat/public \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: sk-so-your_api_key_here" \
  -H "X-Agent-Id: PRODUCT_AGENT_UUID" \
  -d '{ "message": "Show me the details for product PRD-2210 and suggest similar items" }'

import requests

BASE_URL = "https://your-domain.com"
API_KEY = "sk-so-your_api_key_here"
AGENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"  # from Agents page

headers = {
    "Content-Type": "application/json",
    "X-Api-Key": API_KEY,
    "X-Agent-Id": AGENT_ID,
}

# Single message
response = requests.post(f"{BASE_URL}/api/chat/public", headers=headers, json={
    "message": "Get order details for OrderId: ORD-1234, UserId: USR-5678"
})

data = response.json()
print(data["message"]["content"])

# Check if any MCP tools were called
if data.get("tool_calls"):
    for tc in data["tool_calls"]:
        print(f"Tool: {tc['name']}, Input: {tc['input']}")

# Follow-up in same conversation
response2 = requests.post(f"{BASE_URL}/api/chat/public", headers=headers, json={
    "message": "What is the delivery ETA?",
    "conversation_id": data["conversation_id"],
})
print(response2.json()["message"]["content"])

const API_KEY = "sk-so-your_api_key_here";
const AGENT_ID = "a1b2c3d4-e5f6-7890-abcd-ef1234567890"; // from Agents page
const BASE_URL = "https://your-domain.com";

const headers = {
  "Content-Type": "application/json",
  "X-Api-Key": API_KEY,
  "X-Agent-Id": AGENT_ID,
};

// Single request
const res = await fetch(`${BASE_URL}/api/chat/public`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    message: "Get order details for OrderId: ORD-1234, UserId: USR-5678",
  }),
});

const { conversation_id, message, tool_calls } = await res.json();
console.log(message.content);
if (tool_calls) console.log("Tools used:", tool_calls.map(t => t.name));

// Multi-turn follow-up
const res2 = await fetch(`${BASE_URL}/api/chat/public`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    message: "What is the delivery ETA?",
    conversation_id,
  }),
});
console.log((await res2.json()).message.content);

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("X-Api-Key", "sk-so-your_api_key_here");
client.DefaultRequestHeaders.Add("X-Agent-Id", "a1b2c3d4-e5f6-7890-abcd-ef1234567890");

// Single request
var response = await client.PostAsJsonAsync(
    "https://your-domain.com/api/chat/public",
    new { message = "Get order details for OrderId: ORD-1234, UserId: USR-5678" }
);
var result = await response.Content.ReadFromJsonAsync<ChatResponse>();
Console.WriteLine(result.Message.Content);

// Multi-turn follow-up
var response2 = await client.PostAsJsonAsync(
    "https://your-domain.com/api/chat/public",
    new {
        message = "What is the delivery ETA?",
        conversation_id = result.ConversationId
    }
);
Console.WriteLine((await response2.Content.ReadFromJsonAsync<ChatResponse>()).Message.Content);