AI Agent Core Partner Portal

curl -X POST http://localhost:8080/api/v1/agent/process \
  -H "Authorization: Bearer ak_YOUR_APP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: text/event-stream" \
  -d '{
    "input": {
      "type": "text",
      "text": "Tìm giúp tôi 2 chiếc áo sơ mi nam trắng size L"
    },
    "user": {
      "ref": "kh001",
      "name": "Nguyễn Văn A"
    }
  }'

async function askAiAgent(prompt, userRef = 'kh001') {
  const res = await fetch('http://localhost:8080/api/v1/agent/process', {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ak_YOUR_APP_API_KEY',
      'Content-Type': 'application/json',
      'Accept': 'text/event-stream', // Nhận sự kiện streaming thời gian thực
    },
    body: JSON.stringify({
      input: { type: 'text', text: prompt },
      user: { ref: userRef }
    })
  });

  const reader = res.body.getReader();
  const decoder = new TextDecoder();

  while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    const chunk = decoder.decode(value);
    for (const line of chunk.split('\n')) {
      if (line.startsWith('data: ')) {
        const payload = JSON.parse(line.slice(6));
        console.log('Event payload:', payload);
        // payload.type = "delta" (từng từ văn bản) | "reply" (phản hồi đầy đủ + thẻ UI SDUI)
      }
    }
  }
}

import requests

url = "http://localhost:8080/api/v1/agent/process"
headers = {
    "Authorization": "Bearer ak_YOUR_APP_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json"
}
payload = {
    "input": {
        "type": "text",
        "text": "Kiểm tra mã giảm giá hôm nay"
    },
    "user": {
        "ref": "kh001",
        "name": "Nguyễn Văn A"
    }
}

res = requests.post(url, json=payload, headers=headers)
data = res.json()
print("Agent:", data["agent"])
print("Trả lời:", data["reply"]["text"])
if "ui" in data["reply"]:
    print("Thẻ giao diện SDUI:", data["reply"]["ui"])

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	body, _ := json.Marshal(map[string]any{
		"input": map[string]any{"type": "text", "text": "Tìm áo sơ mi trắng"},
		"user":  map[string]any{"ref": "kh001"},
	})
	req, _ := http.NewRequest("POST", "http://localhost:8080/api/v1/agent/process", bytes.NewReader(body))
	req.Header.Set("Authorization", "Bearer ak_YOUR_APP_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer res.Body.Close()

	var out map[string]any
	json.NewDecoder(res.Body).Decode(&out)
	fmt.Printf("Phản hồi: %+v\n", out)
}

{
  "session_id": "0194bc02-1234-7000-8000-000000000001",
  "agent": "sales_assistant",
  "status": "completed",
  "reply": {
    "text": "Dạ em tìm thấy 2 mẫu áo sơ mi nam phù hợp với bạn ạ:",
    "ui": [
      {
        "type": "product_card",
        "data": {
          "id": "SP001",
          "name": "Áo sơ mi Oxford Classic",
          "price": 350000,
          "image": "https://example.com/shirt.jpg"
        }
      }
    ]
  },
  "degraded": false
}

<!-- Dán vào cuối thẻ body -->
<script src="http://localhost:8081/widget/v1/voicebox.js" data-key="vb_tkvWkbyvNs2-yH7oMYbxECLD" async></script>

<script src="http://localhost:8081/widget/v1/voicebox.js" async></script>
<voicebox-chat key="vb_tkvWkbyvNs2-yH7oMYbxECLD" mode="inline" style="display:block;height:600px"></voicebox-chat>

const vb = Voicebox.init({
  key: 'vb_tkvWkbyvNs2-yH7oMYbxECLD',
  mode: 'floating',
  theme: 'auto', // 'light' | 'dark' | 'auto'
  user: {
    ref: 'kh001',
    name: 'Nguyễn Văn A',
    hash: '<64 ký tự hex HMAC_SHA256(identity_secret, ref) — tính ở SERVER của bạn>'
  }
});

// Lắng nghe sự kiện
vb.on('ready', () => console.log('Voicebox sẵn sàng'));
vb.on('reply', (r) => console.log('Agent vừa trả lời:', r.reply.text));
vb.on('handoff', () => alert('Đang chuyển hướng sang nhân viên CSKH'));

// Thao tác điều khiển
vb.open();
vb.send('Tư vấn sản phẩm khuyến mãi hôm nay');

user_hash = HMAC-SHA256(identity_secret, user.ref).hexdigest()

import { createHmac } from 'node:crypto';

function getUserHash(userId, identitySecret) {
  return createHmac('sha256', identitySecret).update(userId).digest('hex');
}

import hmac, hashlib

def get_user_hash(user_id: str, identity_secret: str) -> str:
    return hmac.new(identity_secret.encode(), user_id.encode(), hashlib.sha256).hexdigest()

<?php
function getUserHash($userId, $identitySecret) {
    return hash_hmac('sha256', $userId, $identitySecret);
}

package main

import (
	"crypto/hmac"
	"crypto/sha256"
	"encoding/hex"
)

func GetUserHash(userID, identitySecret string) string {
	m := hmac.New(sha256.New, []byte(identitySecret))
	m.Write([]byte(userID))
	return hex.EncodeToString(m.Sum(nil))
}

import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import java.util.HexFormat;
import static java.nio.charset.StandardCharsets.UTF_8;

public static String getUserHash(String userId, String identitySecret) throws Exception {
    Mac mac = Mac.getInstance("HmacSHA256");
    mac.init(new SecretKeySpec(identitySecret.getBytes(UTF_8), "HmacSHA256"));
    return HexFormat.of().formatHex(mac.doFinal(userId.getBytes(UTF_8)));
}