用您熟悉的語言接上 AI 沙盒

// 流程示意：先依部署環境完成登入或取得有效 API 授權；CSRF Token 不能取代身分驗證。
const BASE_URL = 'https://<您的 AI 沙盒主機>/api';
const OWNER_ID = 'YOUR_OWNER_ID';
const visitorId = 'visitor-001';

// 1. 取得 CSRF Token：寫入 XSRF-TOKEN Cookie
const handshake = await fetch(`${BASE_URL}/v1/csrf-token`);
const xsrfToken = handshake.headers
  .getSetCookie()
  .map((cookie) => cookie.split(';')[0])
  .find((pair) => pair.startsWith('XSRF-TOKEN='))
  ?.slice('XSRF-TOKEN='.length);
if (!xsrfToken) throw new Error('XSRF-TOKEN cookie missing');

const headers = {
  Accept: 'application/json',
  'Content-Type': 'application/json',
  Authorization: 'Bearer <ACCESS_TOKEN>', // 改用部署環境提供的有效授權
  'X-XSRF-TOKEN': xsrfToken,
  Cookie: `XSRF-TOKEN=${xsrfToken}; vid=${visitorId}`,
};

async function post<T>(path: string, body: unknown): Promise<T> {
  const res = await fetch(`${BASE_URL}${path}`, {
    method: 'POST',
    headers,
    body: JSON.stringify(body),
  });
  if (!res.ok) throw new Error(`${res.status} ${path}`);
  return (await res.json()) as T;
}

// 2. 建立 AI 助理
const { agentId } = await post<{ agentId: number }>('/v1/agents', {
  agentDisplayName: 'Customer Support',
  agentToneStyle: 'PROFESSIONAL',
  agentAnswerStrategy: 'BALANCED',
  ownerId: OWNER_ID,
});

// 3. 建立對話 Channel
const { agentChannelId } = await post<{ agentChannelId: string }>(
  `/v1/agents/${agentId}/channels`,
  { title: 'Support Session', visitorId },
);

// 4. 發送訊息，逐段讀取 SSE
const stream = await fetch(`${BASE_URL}/v1/agents/${agentId}/chat`, {
  method: 'POST',
  headers: { ...headers, Accept: 'text/event-stream' },
  body: JSON.stringify({
    channelId: agentChannelId,
    message: '這張訂單的交期是哪天？',
    stream: true,
    parameters: { temperature: 0.2 },
  }),
});
if (!stream.ok || !stream.body) throw new Error(`${stream.status} chat`);

const decoder = new TextDecoder();
let buffer = '';
let done = false;
for await (const chunk of stream.body) {
  buffer += decoder.decode(chunk, { stream: true });
  const events = buffer.split(/\r?\n/);
  buffer = events.pop() ?? '';
  for (const line of events) {
    if (!line.startsWith('data: ')) continue;
    const data = line.slice('data: '.length);
    if (data === '[DONE]') {
      done = true;
      break;
    }
    const event = JSON.parse(data) as { type: string; content?: string };
    if (event.type === 'chunk') process.stdout.write(event.content ?? '');
  }
  if (done) break;
}

# 流程示意：先依部署環境完成登入或取得有效 API 授權；CSRF Token 不能取代身分驗證。
import json

import requests

BASE_URL = "https://<您的 AI 沙盒主機>/api"
OWNER_ID = "YOUR_OWNER_ID"
VISITOR_ID = "visitor-001"

session = requests.Session()
session.cookies.set("vid", VISITOR_ID)

# 1. 取得 CSRF Token：寫入 XSRF-TOKEN Cookie
session.get(f"{BASE_URL}/v1/csrf-token").raise_for_status()
session.headers.update({
    "Accept": "application/json",
    "Authorization": "Bearer <ACCESS_TOKEN>",  # 改用部署環境提供的有效授權
    "X-XSRF-TOKEN": session.cookies["XSRF-TOKEN"],
})

# 2. 建立 AI 助理
agent = session.post(f"{BASE_URL}/v1/agents", json={
    "agentDisplayName": "Customer Support",
    "agentToneStyle": "PROFESSIONAL",
    "agentAnswerStrategy": "BALANCED",
    "ownerId": OWNER_ID,
})
agent.raise_for_status()
agent_id = agent.json()["agentId"]

# 3. 建立對話 Channel
channel = session.post(
    f"{BASE_URL}/v1/agents/{agent_id}/channels",
    json={"title": "Support Session", "visitorId": VISITOR_ID},
)
channel.raise_for_status()
channel_id = channel.json()["agentChannelId"]

# 4. 發送訊息，逐段讀取 SSE
with session.post(
    f"{BASE_URL}/v1/agents/{agent_id}/chat",
    headers={"Accept": "text/event-stream"},
    json={
        "channelId": channel_id,
        "message": "這張訂單的交期是哪天？",
        "stream": True,
        "parameters": {"temperature": 0.2},
    },
    stream=True,
) as response:
    response.raise_for_status()
    response.encoding = "utf-8"
    for line in response.iter_lines(decode_unicode=True):
        if not line.startswith("data: "):
            continue
        data = line.removeprefix("data: ")
        if data == "[DONE]":
            break
        event = json.loads(data)
        if event.get("type") == "chunk":
            print(event["content"], end="", flush=True)

# 流程示意：先依部署環境完成登入或取得有效 API 授權；CSRF Token 不能取代身分驗證。
BASE_URL="https://<您的 AI 沙盒主機>/api"
VISITOR_ID="visitor-001"

# 1. 取得 CSRF Token：寫入 cookies.txt
curl -s -c cookies.txt -o /dev/null "$BASE_URL/v1/csrf-token"
XSRF_TOKEN=$(awk '$6 == "XSRF-TOKEN" { print $7 }' cookies.txt)
AUTH=(
  -H "Authorization: Bearer <ACCESS_TOKEN>" # 改用部署環境提供的有效授權
  -H "X-XSRF-TOKEN: $XSRF_TOKEN"
  -H "Cookie: XSRF-TOKEN=$XSRF_TOKEN; vid=$VISITOR_ID"
  -H "Content-Type: application/json"
)

# 2. 建立 AI 助理，回傳 agentId（範例 101）
curl -s "${AUTH[@]}" -H "Accept: application/json" "$BASE_URL/v1/agents" \
  -d '{"agentDisplayName":"Customer Support","agentToneStyle":"PROFESSIONAL","agentAnswerStrategy":"BALANCED","ownerId":"YOUR_OWNER_ID"}'

# 3. 建立對話 Channel，回傳 agentChannelId
curl -s "${AUTH[@]}" -H "Accept: application/json" "$BASE_URL/v1/agents/101/channels" \
  -d '{"title":"Support Session","visitorId":"visitor-001"}'

# 4. 發送訊息，逐段讀取 SSE
curl -sN "${AUTH[@]}" -H "Accept: text/event-stream" "$BASE_URL/v1/agents/101/chat" \
  -d '{"channelId":"7d1b8e4aa6af4a0194f4f3bf45f2f4c8","message":"這張訂單的交期是哪天？","stream":true}'