Bỏ qua tới nội dung

AI

Trợ lý AI: chat, gợi ý trả lời, thống kê sử dụng. · 9 endpoint

Trợ lý AI (không trả API key)

GET/api/v1/ai/assistantsScope: ai:manage

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/assistants" \
  -H "Authorization: Bearer dpk_xxx"

Một trợ lý

GET/api/v1/ai/assistants/{id}Scope: ai:manage

Tham số

id
path · bắt buộc
string
max 200

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/assistants/{id}" \
  -H "Authorization: Bearer dpk_xxx"

Trợ lý để chọn khi gọi /ai/chat (chỉ tên, nền tảng, model, không prompt, không key)

GET/api/v1/ai/assistants/optionsScope: ai:use

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/assistants/options" \
  -H "Authorization: Bearer dpk_xxx"

Trợ lý mặc định

GET/api/v1/ai/defaultScope: ai:use

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/default" \
  -H "Authorization: Bearer dpk_xxx"

Hỏi trợ lý AI (dùng cấu hình, tri thức và hạn mức của trợ lý)

POST/api/v1/ai/chatScope: ai:use

Body (JSON)

assistant_id
tuỳ chọn
string
max 200
Bỏ trống = trợ lý mặc định
messages
bắt buộc
object[]
max 100 items
└role
bắt buộc
"user" | "assistant" | "system"
└content
bắt buộc
string
max_tokens
tuỳ chọn
integer
≥ 1 · ≤ 8000
temperature
tuỳ chọn
number
≥ 0 · ≤ 2
raw_system
tuỳ chọn
booleantrue = chỉ gửi đúng messages (kể cả system) tới model, không ghép system prompt / tri thức của trợ lý: cho ứng dụng tự lo prompt

Lệnh mẫu

bash
curl -X POST "http://127.0.0.1:9900/api/v1/ai/chat" \
  -H "Authorization: Bearer dpk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Tóm tắt chính sách đổi trả"}]}'

Gợi ý câu trả lời cho hội thoại (như nút gợi ý trong chat)

POST/api/v1/ai/suggestScope: ai:use

Body (JSON)

account_id
bắt buộc
string
max 200
thread_id
bắt buộc
string
max 200
assistant_id
tuỳ chọn
string
max 200
Bỏ trống = trợ lý gán cho tài khoản (vai trò gợi ý) hoặc mặc định
history_limit
tuỳ chọn
integer
≥ 1 · ≤ 100 · default 30

Lệnh mẫu

bash
curl -X POST "http://127.0.0.1:9900/api/v1/ai/suggest" \
  -H "Authorization: Bearer dpk_xxx" \
  -H "Content-Type: application/json" \
  -d '{"account_id":"string","thread_id":"string","assistant_id":"string"}'

Thống kê token theo ngày

GET/api/v1/ai/usage/statsScope: ai:manage

Tham số

assistant_id
query · tuỳ chọn
string
max 200
days
query · tuỳ chọn
integer
≥ 1 · ≤ 365 · default 30

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/usage/stats" \
  -H "Authorization: Bearer dpk_xxx"

Nhật ký gọi AI

GET/api/v1/ai/usage/logsScope: ai:manage

Tham số

assistant_id
query · tuỳ chọn
string
max 200
from
query · tuỳ chọn
integer
≥ 0
to
query · tuỳ chọn
integer
≥ 0
limit
query · tuỳ chọn
integer
≥ 1 · ≤ 1000 · default 100

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/ai/usage/logs" \
  -H "Authorization: Bearer dpk_xxx"

Trợ lý gán cho tài khoản (gợi ý / panel)

GET/api/v1/accounts/{accountId}/ai-assistantScope: ai:use

Tham số

accountId
path · bắt buộc
string
max 200
ID tài khoản (accounts.zalo_id). Facebook dùng Facebook ID, Telegram dùng ID tài khoản Telegram.
role
query · tuỳ chọn
"suggestion" | "panel"
default "suggestion"

Lệnh mẫu

bash
curl "http://127.0.0.1:9900/api/v1/accounts/{accountId}/ai-assistant" \
  -H "Authorization: Bearer dpk_xxx"