Giáo trình tự học miễn phí · Dịch vụ hỗ trợ theo nhu cầu.
Bài 0835phút ước tínhCơ bản đến Nâng cao
8. Đồ Án Tốt Nghiệp: Xây Dựng Hệ Thống Agent Đa Kênh Tích Hợp o3-mini, Realtime Voice & PostgreSQL
Đồ án tích hợp toàn diện: Xây dựng hệ thống Agent kết hợp o3-mini Reasoning, Realtime Voice, lưu trữ lịch sử trên PostgreSQL và tự động tạo Lead trên CRM.
🏆 Sơ Đồ Kiến Trúc Đồ Án Tốt Nghiệp
graph TD
User["Khách Hàng (Website / Voice Realtime)"] --> Agent["OpenAI Orchestrator (GPT-4o / o3-mini)"]
Agent --> Extractor["Strict Structured Output Parser (Pydantic)"]
Extractor --> DB["PostgreSQL Database (Lưu trữ Lead)"]
Extractor --> Notify["Telegram Alert Bot (Báo cho Ban Giám Đốc)"]#### Tiêu Chí Đánh Giá Hoàn Thành:
- Đón nhận yêu cầu từ khách hàng qua giao diện Web hoặc Voice Realtime.
- Trích xuất chuẩn xác 100% dữ liệu có cấu trúc qua Pydantic.
- Ghi trực tiếp vào bảng CSDL PostgreSQL bằng SQLAlchemy.
- Bắn thông báo biến động khách hàng mới về nhóm Telegram Ban Điều Hành trong vòng 3 giây.
# SCRIPT ĐỒ ÁN MẪU HOÀN CHỈNH (app_agent_pipeline.py)
from openai import OpenAI
from pydantic import BaseModel
import psycopg2
class LeadRecord(BaseModel):
name: str
phone: str
interest_course: str
notes: str
def process_and_save_lead(user_chat_text: str):
client = OpenAI()
completion = client.beta.chat.completions.parse(
model="gpt-4o-2024-08-06",
messages=[
{"role": "system", "content": "Bạn là Chuyên viên Tiếp nhận Học viên của AI Tinh Gọn."},
{"role": "user", "content": user_chat_text}
],
response_format=LeadRecord
)
lead = completion.choices[0].message.parsed
conn = psycopg2.connect("postgresql://postgres:password@localhost:5432/aitg_leads")
cur = conn.cursor()
cur.execute(
"INSERT INTO leads (name, phone, course, notes) VALUES (%s, %s, %s, %s)",
(lead.name, lead.phone, lead.interest_course, lead.notes)
)
conn.commit()
conn.close()
print(f"✅ Đã ghi nhận Lead thành công: {lead.name} - {lead.interest_course}")
process_and_save_lead("Chào bạn, mình là Tuấn ở HN, số 0912345678, muốn đăng ký học khóa OpenAI Frontier o3-mini.")
Thực hành
Thực hành và tự đánh giá
Chạy hoàn thiện đồ án trên máy tính hoặc VPS của bạn, kết nối CSDL và kiểm tra dữ liệu được thêm mới thành công.
Cảnh báo & Bắt bệnh
⚠️ Cạm bẫy & Bắt bệnh khi thực hành OpenAI API:
- Lỗi sai lệch JSON Schema trong Structured Outputs: Schema Pydantic khai báo kiểu dữ liệu không được hỗ trợ bởi Strict Mode (như
Optional[Union[...]]phức tạp).
- Cách khắc phục: Tuân thủ strict JSON Schema do OpenAI quy định, chỉ dùng các kiểu dữ liệu nguyên thủy (str, int, float, bool, List, BaseModel con).
- Lỗi tăng đột biến chi phí Token khi gọi mô hình Reasoning (o1/o3-mini):
- Cách khắc phục: Luôn giới hạn
reasoning_effortở mứclowhoặcmediumcho các bài toán thông thường và theo dõi Usage Dashboard thường xuyên.
Checklist nghiệm thu
📋 Checklist nghiệm thu OpenAI Enterprise Solution:
- [ ] Đã thiết lập thành công Assistants API kết hợp Vector Store tự động bóc tách tài liệu.
- [ ] Đã triển khai Strict Structured Outputs bảo đảm 100% dữ liệu JSON khớp chuẩn Pydantic.
- [ ] Đã xây dựng ít nhất 1 Custom GPT phân quyền nội bộ kết nối API CRM doanh nghiệp.
🏢 BẠN MUỐN TRIỂN KHAI CHO CẢ PHÒNG BAN / DOANH NGHIỆP?
Đề Xuất Công Ty Tài Trợ & Đào Tạo In-House Trọn Gói
AI Tinh Gọn hỗ trợ khảo sát hiện trạng, kèm 1-1 on-premise bảo mật dữ liệu, setup hạ tầng riêng và xuất hóa đơn VAT hợp pháp cho doanh nghiệp.
⚖️ Bản quyền sở hữu trí tuệ: © 2026 AI Tinh Gọn (aitinhgon.vn) · Giấy phép Creative Commons CC BY-NC-ND 4.0. Cho phép tự học cá nhân, nghiêm cấm thương mại hóa hoặc bán lại.
Giáo trình mở →
Tiến độ tự học lưu trên trình duyệt này. Chỉ đánh dấu khi đã kiểm tra sản phẩm thực hành.