Entry points, build-time interfaces, delivery routes

3 tầng, 3 quyết định tách biệt

3 tầng này không phải là các phương án thay thế lẫn nhau. Mọi dự án triển khai (deployment) đều bao gồm cả 3 tầng, và việc nhầm lẫn giữa chúng là nguyên nhân phổ biến nhất dẫn đến những cuộc thảo luận kiến trúc mơ hồ, rối rắm.

• Entry Points (Điểm truy cập)

  Nơi một người hoặc một hệ thống tương tác trực tiếp. Entry Points là những lớp bọc (wrappers) quyết định ai có thể giao tiếp với Claude và giao tiếp như thế nào.

  Ví dụ: Claude.ai (web, mobile, desktop), Claude Code, ứng dụng tùy chỉnh xây dựng trên API.

• Build-time interfaces (Giao diện lập trình)

  Cách một engineer lập trình để tương tác với Claude, chính là tầng mà code của đối tác được viết dựa trên đó.

  Ví dụ: Direct API, các bộ SDKs, MCP, Agent SDK.

• Delivery routes (Lộ trình phân phối/truyền tải)

  Nơi API traffic kết thúc (điểm cuối). Delivery routes xác định request sẽ chạy trên hạ tầng (infrastructure) của nhà cung cấp nào.

  Ví dụ: Trực tiếp từ Anthropic, AWS Bedrock, GCP Vertex AI, Microsoft Foundry.

Vì sao việc phân biệt rõ 3 tầng lại quan trọng?

Một entry point được chọn dựa trên đối tượng người dùng và bản chất công việc. Một build-time interface được chọn cho team engineering và bài toán tích hợp (integration). Một delivery route được chọn dựa trên các cam kết đám mây (cloud commitments) và quy chuẩn tuân thủ (compliance posture) của đối tác. Đây là 3 cuộc thảo luận riêng biệt với 3 nhóm bên liên quan (stakeholders) khác nhau, và quyết định ở tầng này hiếm khi áp đặt lên các tầng còn lại.

Hiện tại, hãy tập trung ghi nhớ tên gọi và sự khác biệt giữa chúng. Việc lựa chọn giữa các phương án dưới các rào cản thực tế sẽ được giảng dạy ở phần sau, khi bạn đã có model, pattern và một kiến trúc cụ thể để ghép chúng lại với nhau.

Kịch bản thực tế: Thất bại do gộp chung các tầng

Một đề xuất giải pháp workflow cho ngân hàng bán lẻ đã đưa Claude Code – vốn là một entry point dành cho dân kỹ thuật – tới đối tượng người dùng không thuộc mảng kỹ thuật, chỉ vì lý do của người viết: "tất cả đều là Claude mà."

Đúng là tất cả đều dựa trên Claude theo nghĩa cùng một model nằm bên dưới mọi entry point. Nhưng entry point là lớp bọc (wrapper), và Claude Code được tạo ra cho các developer thao tác trên terminal, chứ không phải cho nhân viên chi nhánh ngân hàng làm việc theo workflow. Việc coi 3 tầng này là một đã xóa bỏ sự phân biệt – thứ lẽ ra phải loại bỏ phương án này ngay từ đầu.

Chi phí · Độ phức tạp · Rủi ro

• Chi phí (Cost): Mỗi entry point đều đi kèm chi phí tích hợp riêng. Lựa chọn sai tầng do thuật ngữ không rõ ràng có thể dẫn đến việc trả tiền cho sai giải pháp, sau đó lại phải tốn tiền một lần nữa để thay thế nó.

• Độ phức tạp (Complexity): Khi cả 3 tầng được gọi tên và thảo luận chuẩn xác, một buổi design review có thể cô lập chính xác quyết định nào đang gây tranh cãi. Khi chúng bị nhập nhập làm một, cuộc họp review sẽ rơi vào vòng lặp tranh cãi vô hồi kết.

• Rủi ro (Risk): Việc chọn entry point trước khi xác định rõ người dùng là ai là một lỗi kiến trúc phổ biến nhưng hoàn toàn tránh được, vốn bắt nguồn từ việc gộp chung 3 tầng riêng biệt này thành một khái niệm duy nhất.