Điều kiện tiên quyết#
Trước khi cấu hình các tính năng AI trong Apidog, hãy bảo đảm bạn có:Tài khoản Apidog với vai trò quản trị viên tổ chức hoặc nhóm (hoặc cao hơn)
Phiên bản Apidog client 2.7.18 trở lên
API key từ nhà cung cấp mô hình AI được hỗ trợ (OpenAI, Anthropic, Google AI Studio, Google Vertex hoặc nhà cung cấp tùy chỉnh)
Chỉ quản trị viên tổ chức hoặc nhóm (hoặc các vai trò cao hơn) mới có thể cấu hình các tính năng AI.
Tổng quan#
Các tính năng AI trong Apidog bị tắt theo mặc định. Để bật các tính năng này, hãy truy cập "Organizations/Team Settings – AI Features" và bật chúng. Sau khi được bật, tất cả dự án trong tổ chức hoặc nhóm của bạn có thể bắt đầu sử dụng AI để nâng cao năng suất.Cấu hình nhà cung cấp mô hình#
Sau khi AI features được bật, bạn sẽ thấy tùy chọn cấu hình nhà cung cấp mô hình. Nhấp vào + Add Provider để bắt đầu cấu hình.Hiện tại, Apidog hỗ trợ các nhà cung cấp mô hình sau:| Nhà cung cấp |
|---|
| OpenAI |
| Anthropic |
| Google AI Studio |
| Google Vertex |
| Azure OpenAI |
| Custom API Configuration |
Nếu các nhà cung cấp này không đáp ứng nhu cầu của bạn, bạn cũng có thể sử dụng Custom API Configuration để kết nối các mô hình của nhà cung cấp khác.Thiết lập cấu hình#
Khi thêm nhà cung cấp mô hình, bạn có thể tùy chỉnh các thiết lập sau:| Thiết lập | Mô tả |
|---|
| API Key | Nhập API Key do nhà cung cấp mô hình bạn chọn cung cấp. Sử dụng chức năng Test để kiểm tra xem key có hợp lệ hay không. |
| API Base URL | URL thực tế mà các yêu cầu được gửi đến khi sử dụng các tính năng AI trong Apidog. Đối với các nhà cung cấp tích hợp sẵn, chúng tôi điền sẵn base URL — bạn có thể chỉnh sửa nếu cần. |
| Model List | Danh sách các mô hình do nhà cung cấp AI cung cấp. Chỉ các mô hình đã được bật mới có thể được sử dụng cho các tính năng AI. Thêm mô hình theo cách thủ công nếu cần. |
| API Format | (Chỉ áp dụng cho Custom API Configuration) Xác định định dạng yêu cầu và phản hồi. Hầu hết mô hình tuân theo định dạng OpenAI. |
Mỗi yêu cầu đến mô hình AI được gửi từ máy chủ Apidog đến API base URL này.
Các tính năng AI của Apidog đi kèm với prompt và luồng gọi được thiết lập sẵn. Để đạt kết quả tốt nhất, hãy bảo đảm chọn các mô hình nâng cao, mạnh mẽ (ví dụ: hỗ trợ ngữ cảnh dài hơn, gọi hàm, v.v.; chẳng hạn như GPT-4.1-mini).
Đặt mô hình mặc định#
Nếu người dùng không chỉ định mô hình khi sử dụng các tính năng AI, Apidog sẽ sử dụng mô hình mặc định được đặt tại đây. Bạn sẽ thấy một menu thả xuống với tất cả mô hình hiện đang được bật — chỉ cần chọn mô hình bạn muốn sử dụng làm mặc định.Theo mặc định, mô hình mặc định được đặt là "Auto Select", tùy chọn này tự động chọn một mô hình khả dụng dựa trên thứ tự của các nhà cung cấp và mô hình đã bật.Nếu bạn đặt một mô hình cụ thể làm mặc định nhưng mô hình đó bị tắt hoặc bị xóa, Apidog sẽ tự động chuyển lại về "Auto Select".Chức năng & Prompt#
Bạn có thể quản lý tất cả tính năng AI của Apidog và tùy chỉnh prompt của chúng tại đây. Sau khi một tính năng được bật, bạn sẽ thấy tính năng đó xuất hiện trong phần liên quan của dự án. Apidog cung cấp prompt mặc định cho từng tính năng, và bạn có thể điều chỉnh để phù hợp hơn với nhu cầu của mình.Hiện chưa hỗ trợ chỉnh sửa prompt tùy chỉnh—hãy theo dõi các bản cập nhật trong tương lai!
Kế thừa cấu hình AI từ tổ chức xuống nhóm#
Khi sử dụng quản lý tổ chức, quản trị viên hoặc chủ sở hữu tổ chức có thể thiết lập các tính năng AI ở cấp tổ chức. Các thiết lập này có thể áp dụng cho tất cả nhóm thuộc tổ chức, giúp bạn duy trì tính nhất quán và đơn giản hóa việc quản lý giữa các dự án.Bạn sẽ tìm thấy cùng giao diện cấu hình AI Features trong Settings trên trang quản lý tổ chức giống như ở cấp nhóm.Sau khi các tính năng AI được thiết lập ở cấp tổ chức, tất cả nhóm trong tổ chức có thể kế thừa các nhà cung cấp mô hình, mô hình mặc định và chức năng đã cấu hình.Quy tắc kế thừa#
| Thiết lập | Hành vi |
|---|
| Feature Toggles | Nếu được bật ở cấp tổ chức, các nhóm có thể bật/tắt. Nếu bị tắt ở cấp tổ chức, các nhóm không thể bật. |
| Model Providers | Các nhóm có thể kế thừa từ tổ chức hoặc thiết lập độc lập |
| Default Model | Các nhóm có thể sử dụng mô hình mặc định của tổ chức hoặc cấu hình mô hình riêng |
Các điểm chính về kế thừa của nhóm trong tổ chức:1.
Tất cả nút bật/tắt — chẳng hạn như công tắc tính năng AI, thiết lập nhà cung cấp mô hình, lựa chọn mô hình mặc định và chức năng — đều tuân theo cấu hình của tổ chức. Điều này bảo đảm khả năng kiểm soát tập trung và tính nhất quán trên tất cả nhóm.
2.
Nhà cung cấp mô hình có thể được kế thừa từ tổ chức hoặc được từng nhóm thiết lập độc lập, tùy theo nhu cầu của bạn.
3.
Các nhóm cũng có thể chọn sử dụng mô hình mặc định được xác định ở cấp tổ chức hoặc cấu hình mô hình riêng.
