Vietnam Medical AI

Thông tin service: tên, version, port, status, link docs.

Response:

Health check. Returns 503 nếu agent chưa ready.

Danh sách tất cả sub-services: id, name, description, tags, GPU.

Kiểm tra health status của tất cả sub-services (ASR, OCR, 3x LLM, TTS, CodeFinder, Face Recog, Patient Sim).

Endpoint chính của AI Agent. Tự động detect intent, chọn LLM, điều phối sub-services.

Request Body (JSON):

Streaming (SSE): Khi stream=true, response là SSE stream. Mỗi chunk là text fragment. Kết thúc với data: [DONE].

cURL:

curl -X POST https://pnt.badt.vn/ai-agent/run \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"tóm tắt bệnh án: sốt 39°C, ho khan 5 ngày","language":"vi"}'

Response:

Giống /run nhưng dùng multipart/form-data để upload audio/image.

Form fields: message, session_id, language, force_intent + file fields audio (WAV/MP3), image (JPG/PNG).

Direct LLM call với messages array. Dùng cho PHP agent loop tool-calling.

Request Body:

cURL:

curl -X POST https://pnt.badt.vn/ai-agent/chat/raw \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Xin chào"}],"force_llm":"gemma4_service"}'

Chat với force_intent="chat". Hỗ trợ SSE streaming.

Request Body: message, session_id, language, stream, max_tokens, temperature.

OpenAI-compatible chat completion. Drop-in cho bất kỳ app nào dùng openai SDK.

Request Body:

cURL:

curl -X POST https://pnt.badt.vn/ai-agent/v1/chat/completions \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":"gemma4_service","messages":[{"role":"user","content":"Hello"}],"temperature":0.7}'

Response:

List available LLM models (gemma4_service, qwen3_service, qwen_service).

Speech-to-text. Upload file audio, nhận transcription.

multipart/form-data:

curl -X POST https://pnt.badt.vn/ai-agent/transcribe \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -F "file=@recording.wav" -F "language=vi"

Image-to-text. Upload ảnh, nhận văn bản trích xuất.

Fields: file (image), analyze (bool), search (bool → tìm mã y tế).

Face recognition. Upload ảnh khuôn mặt, nhận kết quả nhận dạng.

Phân tích văn bản với LLM. Force intent "analyze".

Request: message, session_id, language.

Dịch thuật với LLM.

Request Body:

curl -X POST https://pnt.badt.vn/ai-agent/translate \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello doctor","source_lang":"en","target_lang":"vi"}'

Response:

Tóm tắt văn bản với LLM. Force intent "summarize".

Request: text, max_tokens, session_id.

Medical code search thông qua CodeFinder adapter.

Request Body:

curl -X POST https://pnt.badt.vn/ai-agent/search \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"tăng huyết áp","code_types":["ICD10"],"top_k":5}'

Text-to-speech. Chuyển văn bản thành giọng nói.

Request: text, language ("vi"/"en"), speed (1.0).

Tương tác với bệnh nhân ảo (Patient Simulator).

Request: message, patient_id, session_id.

Code generation. Tự động route sang Qwen3 14B cho code quality tốt nhất. Hỗ trợ SSE streaming.

Request: message, session_id, language, stream.

curl -X POST https://pnt.badt.vn/ai-agent/code \
  -H "Authorization: Bearer $AI_AGENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"message":"Viết Python Flask REST API cho CRUD bệnh nhân","stream":false}'

Code debugging. Paste code + error message → Qwen3 phân tích và sửa lỗi. Hỗ trợ SSE streaming.

Execute shell command trên server.

Request Body:

Note: Dangerous commands (rm -rf /, mkfs, fork-bomb) bị block. Feature có thể tắt qua config SHELL_EXEC_ENABLED.

GPU status real-time: temperature, utilization, memory usage cho tất cả GPU (RTX 3060, 3070, 5060 Ti).

List tất cả active sessions.

Get session detail: messages history với role + content + timestamp.

Xóa session. Returns 404 nếu không tìm thấy.

WebSocket streaming chat với auth tích hợp.

Auth:

• Query param: /ws/chat?token=AI_AGENT_TOKEN
• Hoặc JSON frame đầu tiên: {"type":"auth","token":"xxx"}

Flow:

1. Client gửi auth → server trả {"type":"auth_ok"}
2. Client gửi JSON: {"message":"...","session_id":"...","language":"vi","force_intent":"...","force_llm":"..."}
3. Server stream text fragments, chunk đầu là metadata {"intent":"...","model":"..."}
4. Kết thúc: [DONE]

JavaScript example:

const ws = new WebSocket("wss://pnt.badt.vn/ai-agent/ws/chat?token=" + token);
ws.onmessage = (e) => {
  if (e.data === "[DONE]") { ws.close(); return; }
  // Parse JSON or plain text
  try { const meta = JSON.parse(e.data); console.log("Meta:", meta); }
  catch { console.log("Chunk:", e.data); }
};
ws.send(JSON.stringify({message:"Xin chào",language:"vi"}));

Audio → Diagnosis: Nhận audio đầu vào → ASR transcription → LLM phân tích triệu chứng. multipart/form-data với file + language.

Audio → Consult + TTS: ASR → LLM tư vấn → TTS đọc lại kết quả. Trả về cả text + audio_base64.

Image → Medical Codes: OCR trích xuất text → LLM tìm mã ICD10/ICPC2.

Image → Full Analysis: OCR → LLM phân tích chi tiết nội dung ảnh.