PandaNpc lưu trữ các kết nối nhà cung cấp và các mục mô hình mà bạn cấu hình. Bắt đầu với Khóa API, URL cơ sở, giao thức và ID mô hình được cung cấp bởi dịch vụ của bạn. Thêm một mục không tạo tài khoản ngược dòng hoặc cấp quyền truy cập mô hình.
Để biết sự khác biệt giữa nhà cung cấp và mô hình, hãy đọc Quản lý danh sách mô hình tùy chỉnh của bạn.
Trước khi bạn bắt đầu
Xác nhận những điều sau với nhà cung cấp hoặc dịch vụ tự lưu trữ của bạn:
- Địa chỉ API cơ sở, không phải địa chỉ trang web của nhà cung cấp.
- Phương thức xác thực và bất kỳ thông tin xác thực bắt buộc nào.
- Giao thức API được hỗ trợ bởi tính năng hoặc công cụ bạn định sử dụng.
- ID mô hình chính xác mà tài khoản của bạn có thể gọi.
- Giới hạn ngữ cảnh và đầu ra nếu bạn định nhập chúng theo cách thủ công.
Giữ thông tin xác thực trong biểu mẫu nhà cung cấp, không phải trong lời nhắc, ảnh chụp màn hình hoặc ghi chú chia sẻ. Một dịch vụ được quảng cáo là tương thích OpenAI vẫn có thể khác biệt trong luồng phản hồi, gọi công cụ hoặc hỗ trợ hình ảnh.
1. Thêm hoặc cấu hình một nhà cung cấp
Mở Cấu hình mô hình. Thêm một nhà cung cấp, cấu hình một cài đặt sẵn có hoặc sao chép một cài đặt sẵn khi bạn cần một kết nối có thể chỉnh sửa độc lập.
| Trường | Những gì cần nhập |
|---|---|
| Tên hiển thị | Tên dễ nhận biết cho kết nối này |
| ID nhà cung cấp | Một mã định danh cho cấu hình nhà cung cấp |
| Khóa API | Thông tin xác thực được yêu cầu bởi dịch vụ của bạn |
| URL cơ sở | Địa chỉ API cơ sở được mong đợi bởi tích hợp đã chọn |
| Giao thức | Định dạng mà API ngược dòng thực sự triển khai |
| Bí mật, Tổ chức, Dự án | Chỉ các giá trị được yêu cầu rõ ràng bởi dịch vụ của bạn |
| Hỗ trợ mảng nội dung | Liệu dịch vụ có chấp nhận nội dung tin nhắn có cấu trúc hay không |
Hình dạng của URL cơ sở phụ thuộc vào giao thức và tính năng thực hiện yêu cầu. Không thêm một đường dẫn thao tác hoàn chỉnh nếu tích hợp đã thêm nó. Ví dụ, một tích hợp thêm /chat/completions cần địa chỉ cơ sở tương ứng, không phải một địa chỉ đã kết thúc bằng đường dẫn đó. Không áp dụng ví dụ đó cho mọi giao thức.
Khi chỉnh sửa thông tin xác thực được lưu, việc để trống Khóa API hoặc Bí mật sẽ giữ nguyên giá trị đã cấu hình. Một giá trị bị che trong danh sách không phải là khóa gốc và không nên dán lại để thay thế.
2. Thêm mô hình
Lưu nhà cung cấp, chọn nó và chọn Thêm mô hình.
| Trường | Ý nghĩa |
|---|---|
| Tên hiển thị | Nhãn của bạn trong danh sách mô hình |
| Giá trị mô hình | ID mô hình ngược dòng chính xác |
| Loại mô hình | Danh mục áp dụng trong biểu mẫu cấu hình |
| Nhà cung cấp | Kết nối mà mục này sử dụng |
| Cửa sổ ngữ cảnh | Dung lượng ngữ cảnh được tài liệu hóa, khi được chỉ định |
| Tối đa token | Giới hạn đầu ra, khi được chỉ định |
Sử dụng một ID từ tài liệu của dịch vụ hoặc danh sách mô hình. Tên tiếp thị không nhất thiết là mã định danh API. Để trống các giới hạn tùy chọn nếu bạn không thể xác minh chúng; để trống không có nghĩa là giới hạn thực tế đã được phát hiện. Tính năng tiêu thụ có thể áp dụng các mặc định riêng của nó.
3. Xác minh cấu hình
Trong tính năng hoặc công cụ sử dụng các cài đặt này:
- Chọn mục mới và bắt đầu một cuộc trò chuyện kiểm tra.
- Gửi một yêu cầu ngắn như
Trả lời với: đã kết nối. - Xác nhận phản hồi bình thường và, nếu có, một yêu cầu phù hợp trong hồ sơ sử dụng của nhà cung cấp.
- Gửi một tin nhắn tiếp theo để kiểm tra cuộc trò chuyện liên tục.
- Kiểm tra hình ảnh hoặc gọi công cụ riêng nếu công việc của bạn yêu cầu.
Lưu bản ghi không phải là một bài kiểm tra kết nối. Phản hồi văn bản không thiết lập khả năng tương thích với mọi khả năng. Thay đổi một mục mô hình cũng không tự động cấu hình lại một quy trình Claude Code hoặc Codex hiện có; xem PandaPaw.
Khắc phục sự cố
Xác thực thất bại
Kiểm tra xem khóa có hoạt động, tài khoản có thể truy cập mô hình và dịch vụ có yêu cầu các trường xác thực bổ sung hay không. Thay thế thông tin xác thực hết hạn thông qua biểu mẫu nhà cung cấp.
Điểm cuối hoặc mô hình không được tìm thấy
Kiểm tra cả URL cơ sở và Giá trị mô hình. Tìm các đường dẫn thao tác trùng lặp, thiếu tiền tố API hoặc ID mô hình không khả dụng cho tài khoản của bạn. Cùng một lỗi có thể có các nguyên nhân khác nhau giữa các nhà cung cấp.
Một lỗi mạng hoặc trình duyệt xuất hiện
Kiểm tra kết nối từ thiết bị thực sự gửi yêu cầu. Các yêu cầu bắt nguồn từ trình duyệt chịu các hạn chế CORS và HTTPS; một yêu cầu hoạt động từ một máy tính khác không chứng minh đường dẫn trình duyệt hoạt động.
Không thể truy cập máy chủ mô hình cục bộ
localhost đề cập đến máy gửi yêu cầu. Nó không tự động trỏ đến máy tính PandaPaw từ xa của bạn. Xác nhận nơi tính năng tiêu thụ chạy trước khi chọn địa chỉ máy chủ cục bộ của bạn.
Văn bản hoạt động nhưng hình ảnh, công cụ hoặc phiên dài thất bại
Kiểm tra sự kết hợp chính xác của công cụ, giao thức API và khả năng mô hình. Sử dụng các giới hạn được hỗ trợ bởi nhà cung cấp và xác minh từng loại đầu vào được yêu cầu. Tăng Cửa sổ ngữ cảnh hoặc thay đổi Loại mô hình không thêm khả năng ngược dòng.
Để biết sự khác biệt giữa tư cách thành viên nền tảng và sử dụng nhà cung cấp, xem tài khoản và chi phí mô hình.