Tổng quan

Công nghệ

Base URL

External: https://dv.badt.vn/ai/virtualpatient/ | Internal: http://localhost:8025

Xác thực

Cách dùng

Authorization: Bearer YOUR_API_TOKEN

API Endpoints

{
  "message": "Medical Patient Simulator RAG System",
  "status": "running",
  "version": "1.0.0"
}

{
  "status": "healthy",
  "llm_provider": "gemma4",
  "llm_client_initialized": true,
  "rag_system_initialized": true,
  "llm_api_status": "healthy",
  "model": "google/gemma-2-9b-it"
}

{
  "status": "healthy",
  "request_id": "a87a88de",
  "llm_latency_ms": 2.13,
  "model": "google/gemma-2-9b-it",
  "patient_files_count": 0,
  "patient_data_disk_usage_mb": 2.6,
  "uptime_human": "0h 27m 28s"
}

{
  "message": "Bệnh nhân có triệu chứng gì?",
  "patient_id": "benhnhan001",
  "session_id": "session-uuid-v4",
  "language": "vi"
}

{
  "response": "Tôi bị đau đầu nhiều, kèm sốt nhẹ và mệt mỏi...",
  "patient_id": "benhnhan001",
  "session_id": "session-uuid-v4",
  "patient_info": {
    "name": "Nguyễn Văn A",
    "age": 45,
    "diagnosis": "Tăng huyết áp"
  }
}

{
  "message": "Xin chào bác sĩ!",
  "patient_id": "benhnhan001",
  "session_id": "session-uuid-v4",
  "language": "vi"
}

curl https://pnt.badt.vn/virtualpatient/clinical-data/benhnhan001 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

{
  "system_prompt": "Bạn là bệnh nhân ảo...",
  "temperature": 0.7,
  "max_tokens": 500
}

{
  "patients": [
    {
      "id": "benhnhan001",
      "name": "Nguyễn Văn A",
      "age": 45,
      "diagnosis": "Tăng huyết áp"
    }
  ],
  "total": 1
}

curl -X POST https://pnt.badt.vn/virtualpatient/voice-interaction \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "audio=@/path/to/question.wav" \
  -F "patient_id=benhnhan001"

{
  "file_path": "...",
  "content": "Nội dung file..."
}

{
  "file_path": "..."
}

Chat với bệnh nhân ảo

Tương tác với bệnh nhân ảo qua text. Hệ thống sử dụng RAG để lấy thông tin từ hồ sơ bệnh nhân, sau đó LLM tạo ra câu trả lời phù hợp với vai trò và bệnh cảnh.

Cơ chế hoạt động

1. Nhận message + patient_id
2. RAG truy xuất thông tin bệnh nhân từ file JSON
3. LLM sinh câu trả lời dựa trên context (bệnh sử, triệu chứng, tuổi, giới...)
4. Trả về response kèm patient_info

Ví dụ Python

import requests
import os

url = "https://pnt.badt.vn/virtualpatient/chat"
headers = {
    "Authorization": f"Bearer {os.getenv('API_AI_TOKEN')}",
    "Content-Type": "application/json"
}
data = {
    "message": "Chào bác sĩ, tôi bị đau bụng từ sáng",
    "patient_id": "benhnhan001",
    "language": "vi"
}

response = requests.post(url, json=data, headers=headers)
result = response.json()
print(result["response"])

Ví dụ cURL

curl -X POST https://pnt.badt.vn/virtualpatient/chat \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Bệnh nhân có tiền sử bệnh gì?",
    "patient_id": "benhnhan001",
    "language": "vi"
  }'

Clinical Data & Patient Summary

Truy xuất thông tin chi tiết của bệnh nhân từ hệ thống RAG.

1. Lấy dữ liệu lâm sàng đầy đủ

curl https://pnt.badt.vn/virtualpatient/clinical-data/benhnhan001 \
  -H "Authorization: Bearer YOUR_API_TOKEN"

2. Lấy tóm tắt bệnh nhân

curl https://pnt.badt.vn/virtualpatient/clinical-data/benhnhan001/summary \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Ví dụ Python

import requests
import os

token = os.getenv("API_AI_TOKEN")
headers = {"Authorization": f"Bearer {token}"}

# Full clinical data
resp = requests.get(
    "https://pnt.badt.vn/virtualpatient/clinical-data/benhnhan001",
    headers=headers
)
print(resp.json())

# Summary
resp = requests.get(
    "https://pnt.badt.vn/virtualpatient/clinical-data/benhnhan001/summary",
    headers=headers
)
print(resp.json())

Quản lý bệnh nhân

Liệt kê và quản lý danh sách bệnh nhân trong hệ thống.

Danh sách tất cả bệnh nhân

curl https://pnt.badt.vn/virtualpatient/patients \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Lưu ý

• Mỗi bệnh nhân có một file JSON riêng trong thư mục patient_data/
• File JSON chứa: thông tin nhân khẩu, bệnh sử, tiền sử, thuốc, xét nghiệm...
• Khi thêm bệnh nhân mới, cần tạo file JSON tương ứng
• Hệ thống RAG tự động index dữ liệu bệnh nhân

Voice Interaction

Cơ chế

1. Upload file audio (câu hỏi của bác sĩ/sinh viên)
2. Medical Transcribe service chuyển audio → text
3. RAG truy xuất thông tin bệnh nhân
4. LLM sinh câu trả lời
5. Text-to-Speech chuyển response → audio
6. Trả về cả text và audio

Ví dụ Python

import requests
import os

files = {
    "audio": ("question.wav", open("question.wav", "rb"), "audio/wav")
}
data = {"patient_id": "benhnhan001"}

response = requests.post(
    "https://pnt.badt.vn/virtualpatient/voice-interaction",
    headers={"Authorization": f"Bearer {os.getenv('API_AI_TOKEN')}"},
    files=files,
    data=data
)

result = response.json()
print("Response text:", result["response"])

# If audio returned, save it
if "audio" in result:
    with open("doctor_response.wav", "wb") as f:
        f.write(result["audio"])

Định dạng audio hỗ trợ

Cấu trúc Patient Data (JSON)

Mỗi bệnh nhân là một file JSON trong patient_data/. Cấu trúc mẫu:

{
  "patient_id": "benhnhan001",
  "name": "Nguyễn Văn A",
  "age": 45,
  "gender": "nam",
  "diagnosis": "Tăng huyết áp giai đoạn 2",
  "medical_history": "Tăng huyết áp 5 năm, đái tháo đường type 2",
  "symptoms": "Đau đầu, chóng mặt, mệt mỏi",
  "medications": ["Amlodipine 5mg", "Metformin 500mg"],
  "allergies": ["Penicillin"],
  "test_results": {
    "blood_pressure": "160/95 mmHg",
    "blood_sugar": "7.2 mmol/L",
    "cholesterol": "6.8 mmol/L"
  },
  "lifestyle": {
    "smoking": false,
    "alcohol": "social",
    "exercise": "ít vận động"
  }
}

Admin File Management

List files

curl https://pnt.badt.vn/virtualpatient/admin/files \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

Read file

curl "https://pnt.badt.vn/virtualpatient/admin/read-file?file_path=/path/to/file" \
  -H "Authorization: Bearer ADMIN_API_TOKEN"

Save file

curl -X POST https://pnt.badt.vn/virtualpatient/admin/save-file \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/file.json",
    "content": "{\"key\": \"value\"}"
  }'

Delete file

curl -X DELETE https://pnt.badt.vn/virtualpatient/admin/delete-file \
  -H "Authorization: Bearer ADMIN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "file_path": "/path/to/delete.json"
  }'

Error Codes

Tài liệu bổ sung