Cách kết nối Azure OpenAI

Vị trí: Cài đặt → Nội dung & xuất bản → Tài khoản AI của bạn

Mở trang này: admin.<your-site>/settings/ai/providers (thay <your-site> bằng địa chỉ trang web của bạn)

Trước khi bắt đầu

• Một tài khoản Azure có tài nguyên Azure OpenAI.
• Ít nhất một mô hình đã được triển khai (deployed) trong tài nguyên đó. Azure chỉ chạy mô hình sau khi bạn đã deploy.
• Bạn có quyền xem các key của tài nguyên trong Azure.
• Chỉ thành viên quản lý AI mới có thể kết nối, và bạn cần đăng nhập gần đây.

Các bước thực hiện

1. Mở Azure portal và mở tài nguyên Azure OpenAI của bạn.
2. Vào mục Resource Management, sau đó chọn Keys and Endpoint.
3. Sao chép Endpoint. Endpoint có dạng như https://my-resource.openai.azure.com. Phần đuôi phải kết thúc bằng .openai.azure.com hoặc .cognitiveservices.azure.com.
4. Sao chép KEY 1. Hãy giữ KEY 2 làm dự phòng. Trang quản trị chấp nhận key dài 32 ký tự (chữ cái a–f và chữ số) hoặc 84 ký tự.
5. Tìm tên bản deployment của bạn. Trong cổng Azure AI Foundry, mở mục Deployments của tài nguyên. Tên deployment là tên bạn đã đặt khi triển khai mô hình. Tên này có thể khác với tên gốc của mô hình, ví dụ gpt-4o-mini.
6. Trong trang quản trị trang web, mở Cài đặt → Nội dung & xuất bản → Tài khoản AI của bạn và tìm thẻ Azure OpenAI.
7. Dán Azure endpoint. Thêm từng bản deployment vào mục Tên bản triển khai, rồi bấm Thêm sau mỗi lần nhập. Hãy thêm ít nhất một bản.
8. Dán key và bấm Kiểm tra & kết nối. Bạn sẽ thấy thông báo "Đang kiểm tra key…" và sau đó là Đã kết nối ✓.

Thông tin hữu ích

• Bạn có thể kết nối tối đa hai tài nguyên Azure.
• Azure không cung cấp danh sách mô hình qua key, nên trang quản trị chỉ hiển thị các bản deployment bạn đã nhập. Bạn có thể thêm sau nếu triển khai thêm mô hình mới.
• Việc nhập giá là tùy chọn. Nếu có giá, trang quản trị có thể hiển thị chi phí. Nếu không có giá, AI sẽ không tự động chuyển sang tài khoản này khi tài khoản khác gặp lỗi.
• Azure sẽ tính phí bạn. Cổng Azure portal hiển thị chi phí và ngân sách của bạn. Ngân sách và hạn mức AI
• Key được lưu ngay trên máy chủ của bạn. Keynate không bao giờ nhìn thấy key này.

Lỗi thường gặp

Dùng endpoint Azure OpenAI của bạn

Endpoint phải kết thúc bằng .openai.azure.com hoặc .cognitiveservices.azure.com. Hãy sao chép từ mục Keys and Endpoint. Tên miền tùy chỉnh hoặc địa chỉ IP sẽ không hoạt động.

Mô hình hoặc bản deployment này không có trên tài khoản Azure OpenAI của bạn

Tên deployment không khớp. Tên phải khớp chính xác từng chữ, bao gồm cả chữ hoa chữ thường. Hãy kiểm tra mục Deployments trong Foundry, sửa lại tên trên thẻ rồi thử lại.

Azure OpenAI đã từ chối key này

Hãy sao chép lại toàn bộ key. Mỗi key thuộc về một tài nguyên riêng, vì vậy hãy dùng key từ đúng tài nguyên chứa endpoint đó.

Chúng tôi không thể kết nối tới địa chỉ này

Kiểm tra lại endpoint xem có gõ sai không. Nếu tài nguyên của bạn chỉ cho phép một số mạng nhất định truy cập, quá trình kiểm tra có thể thất bại. Hãy cho phép truy cập công khai vào tài nguyên, hoặc thêm địa chỉ máy chủ của bạn vào rồi thử lại.

Azure báo đã đạt hạn mức (quota) hoặc giới hạn tốc độ (rate limit)

Hãy chờ một phút, hoặc tăng hạn mức (quota) cho bản deployment đó trong Azure.

Câu hỏi thường gặp

Nội dung liên quan

• Dùng AI bằng key riêng
• Ngân sách và giới hạn AI
• AI không hoạt động