Cài đặt bảo mật

Thông báo về quyền riêng tư và GDPR

Nfero sử dụng bộ nhớ thiết yếu cho tùy chọn ngôn ngữ và kiểm soát quyền truy cập demo. Khi bạn đồng ý, Google Analytics và các sự kiện sử dụng nhẹ giúp cải thiện demo mô hình và luồng đăng ký bên ngoài. Prompt demo trực tiếp có thể được gửi đến endpoint mô hình do Alibaba lưu trữ đã cấu hình.

Kết hợp công cụ + mô hình

Cline với Kế hoạch Mã hóa và Kế hoạch Tiền tệ của Alibaba (Token Plan)

Tiện ích mở rộng VS Code cho tạo mã, gỡ lỗi, chỉnh sửa tệp, hành động terminal và quy trình làm việc của trợ lý phát triển.

Cline cung cấp cấu hình OpenAI Compatible trực tiếp bên trong VS Code. Đây là giải pháp thực tiễn dành cho các nhà phát triển muốn sử dụng các mô hình do Alibaba lưu trữ mà không cần chuyển công việc quản lý kho mã ra khỏi trình soạn thảo hiện tại.

Chọn phương thức truy cập phù hợp

Chọn phương thức truy cập phù hợp

Cline là một trong những tích hợp dựa trên giao diện người dùng (UI) đơn giản nhất. Các rủi ro chính bao gồm việc nhầm lẫn thông tin xác thực giữa các gói và quên bật tùy chọn định dạng tin nhắn đặc thù cho từng mô hình trong Cline khi sử dụng các mô hình tư duy.

Được đề xuấtCoding Plan dành cho một người dùng VS Code; Token Plan dành cho quyền truy cập nhóm dựa trên Credits

Token Plan (Phiên bản Nhóm)

Phù hợp nhất cho các nhà phát triển hoặc nhóm được chỉ định thường xuyên sử dụng Cline và muốn truy cập vào tập hợp mô hình Token Plan hiện hành dựa trên Credits.

Coding Plan

Phù hợp nhất cho cá nhân sử dụng Cline tương tác với hạn mức gọi mô hình hàng tháng cố định.

Pay-as-you-go Model Studio API

Sử dụng cho tự động hóa do tiện ích mở rộng điều khiển — không phải phiên lập trình tương tác của người dùng được chỉ định — cũng như cho các lệnh gọi từ ứng dụng hoặc backend.

Mẫu cấu hình an toàn

Sử dụng nhà cung cấp OpenAI Compatible của Cline

Ví dụ được chủ ý ẩn đi. Chỉ thay thế các phần giữ chỗ trên thiết bị của bạn và tuyệt đối không dán khóa API thực tế vào Nfero.

Trước khi bắt đầu

  1. Cài đặt VS Code và tiện ích mở rộng Cline mới nhất.
  2. Lấy khóa API chuyên dụng cho gói đăng ký Alibaba bạn đã chọn.
  3. Chọn đúng ID mô hình từ danh sách được phép hiện tại của gói đó.
  4. Chỉ lưu khóa trong trường thông tin xác thực của Cline; không đặt khóa vào cài đặt workspace hoặc hệ thống kiểm soát nguồn (source control).

Mẫu cấu hình an toàn

Giao thức
OpenAI-compatible
  1. Mở Cline, chọn tùy chọn Bring my own API key và chọn OpenAI Compatible.
  2. Nhập endpoint Token Plan được hiển thị bên dưới, hoặc endpoint Coding Plan `https://coding-intl.dashscope.aliyuncs.com/v1`.
  3. Nhập khóa chuyên dụng tương ứng và ID mô hình được hỗ trợ chính xác.
  4. Đối với mô hình tư duy (thinking model) hoặc lỗi 400 liên quan, mở MODEL CONFIGURATION và bật tùy chọn định dạng tin nhắn R1 do Alibaba mô tả.
text
API Provider: OpenAI Compatible
Base URL: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1
API key: YOUR_TOKEN_PLAN_API_KEY
Model ID: qwen3.7-plus

Xác minh kết nối

  • Mở một không gian làm việc thử nghiệm nhỏ và yêu cầu Cline giải thích một tệp mà không chỉnh sửa nội dung tệp đó.
  • Xác nhận nhà cung cấp vẫn hiển thị là 'OpenAI Compatible' sau khi khởi động lại VS Code.
  • Kiểm tra kỹ ID mô hình đã chọn — từng ký tự phải khớp chính xác.
  • Xem lại mức sử dụng gói đăng ký sau tác vụ đầu tiên để đảm bảo gói đăng ký mong muốn đã được áp dụng.

Kết hợp mô hình

Các mô hình đề xuất để bắt đầu

Sử dụng công cụ này để thực hiện các nhiệm vụ lập trình tương tác, suy luận, kiểm tra và tài liệu với mỗi mô hình. Xác nhận khả năng sẵn có của mô hình cuối cùng và hỗ trợ kế hoạch chính xác trong Alibaba Cloud trước khi sử dụng trong sản xuất.

Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất

Mô hình mặc định mạnh nhất hiện nay cho lập trình, suy luận và hỗ trợ kho mã nguồn.

Tạo văn bảnLập luận
Góc kết hợp tốt nhất

Lựa chọn thay thế hỗ trợ ngữ cảnh dài hơn, phù hợp với các workspace lớn và tác vụ đa tệp.

Tạo văn bảnLập luậnHiểu biết trực quan
Góc kết hợp tốt nhất

Tùy chọn Token Plan hiệu quả để giải thích nhanh và chỉnh sửa nhỏ.

Các sự cố thường gặp

Các sự cố thường gặp

Hiện tượng bạn gặp phải

401 Khóa API không đúng

Nguyên nhân có khả năng xảy ra

Khóa không khớp với URL gốc, hoặc một khóa pay-as-you-go đã được nhập cho endpoint thuộc gói đăng ký.

Cần làm gì

Chọn một phương thức truy cập duy nhất và đồng thời cập nhật cả hai giá trị tương ứng. Đối với pay-as-you-go, hãy đảm bảo vùng (region) của khóa khớp với vùng của endpoint.

Hiện tượng bạn gặp phải

400 InternalError.Algo.InvalidParameter

Nguyên nhân có khả năng xảy ra

Mô hình suy luận đã chọn yêu cầu định dạng tin nhắn thay thế trong Cline.

Cần làm gì

Mở phần CẤU HÌNH MÔ HÌNH và bật định dạng tin nhắn R1 như mô tả trong hướng dẫn Cline của Alibaba.

Hiện tượng bạn gặp phải

Không tìm thấy mô hình hoặc mô hình không được hỗ trợ

Nguyên nhân có khả năng xảy ra

ID mô hình bị đánh sai chính tả hoặc không nằm trong danh sách được phép (exact-string allowlist) của gói đã chọn.

Cần làm gì

Sao chép ID mô hình từ trang chính thức hiện hành của gói thay vì suy luận phiên bản hoặc biệt danh.

Hiện tượng bạn gặp phải

Nhiệm vụ dài tiêu tốn nhiều lượt gọi hơn dự kiến

Nguyên nhân có khả năng xảy ra

Các chỉnh sửa theo hướng tác nhân (agentic edits) có thể bao gồm nhiều lần đọc tệp, gọi công cụ và lượt xử lý của mô hình lặp lại.

Cần làm gì

Bắt đầu với một thư mục hẹp, giao nhiệm vụ rõ ràng và chính xác, kiểm tra việc sử dụng gói, đồng thời chia các thay đổi lớn thành nhiều phiên nhỏ hơn.

Các hạn chế quan trọng

  • Sử dụng khóa API chuyên dụng và URL gốc (base URL) từ cùng một gói thanh toán Alibaba. Các thông tin xác thực dành riêng cho Coding Plan, Token Plan và chung cho Model Studio không thể hoán đổi cho nhau.
  • Khóa của gói chỉ dành cho người dùng được chỉ định khi sử dụng công cụ lập trình tương tác hoặc công cụ agent. Không chia sẻ khóa, không đưa khóa vào kho lưu trữ (repository), và không tiết lộ khóa trong ảnh chụp màn hình.
  • Không sử dụng khóa Coding Plan hoặc Token Plan cho các kịch bản tự động hóa (script), công việc xử lý hàng loạt (batch jobs), backend ứng dụng, dịch vụ công khai hoặc bất kỳ tải công việc API nào khác không mang tính tương tác. Hãy sử dụng quyền truy cập API của Model Studio pay-as-you-go cho các trường hợp sử dụng này.
  • Việc khả dụng mô hình tuân theo danh sách được phép dựa trên chuỗi ký tự chính xác và có thể thay đổi. Vui lòng xác minh lại ID mô hình trong tài liệu gói Alibaba hiện hành trước khi chỉnh sửa cấu hình đang hoạt động.