Add integration guide for Report Generation API, detailing endpoints for generating full, markdown, and JSON reports. Update agent executor and triage routes to track tool executions and guidelines count for report generation, enhancing logging for better traceability. Ensure all tool executions are logged for report generation success.
8a43827
Report Generation API - Integration Guide
Tổng quan
API tạo báo cáo tổng hợp đầy đủ từ conversation session, bao gồm tất cả thông tin từ tools (CV top 3, RAG guidelines, triage results, hospital suggestions) mà response message thường bỏ qua.
Endpoints
1. Generate/Get Full Report
GET /api/reports/:session_id?type=full|summary|tools_only
Response:
{
"session_id": "uuid",
"report_type": "full",
"generated_at": "2024-01-01T00:00:00Z",
"report": {
"report_content": { /* Full structured data */ },
"report_markdown": "# BÁO CÁO TỔNG HỢP..."
}
}
2. Get Markdown Only
GET /api/reports/:session_id/markdown
Trả về markdown report đã format sẵn, dễ hiển thị.
3. Get JSON Only
GET /api/reports/:session_id/json
Trả về structured data (conversation timeline, tool executions, summary).
Cách sử dụng
// Sau khi có session_id từ /api/health-check
const sessionId = "abc-123-def";
// Generate full report
const response = await fetch(`/api/reports/${sessionId}?type=full`);
const { report } = await response.json();
// Hiển thị markdown
console.log(report.report_markdown);
// Hoặc parse structured data
const { conversation_timeline, tool_executions, summary } = report.report_content;
Lưu ý
- Report được cache, gọi lại sẽ trả về cached version
type=full: Báo cáo đầy đủ (default)type=summary: Chỉ tóm tắttype=tools_only: Chỉ tool executions