Cài đặt Zoo Code API

Hướng dẫn chính thức dành cho nhà cung cấp đầu tiên của Zoo Code bao gồm luồng Màn hình chào mừng: mở Zoo Code từ Thanh hoạt động của VS Code, chọn nhà cung cấp, nhập khóa, chọn mô hình và hoàn tất quá trình khởi tạo. TokenHub không phải là cài đặt trước chính thức, vì vậy hướng dẫn này sử dụng các trường OpenAI Compatible hiện tại mà không yêu cầu tích hợp TokenHub của bên thứ nhất.

Bắt đầu từ Màn hình chào mừng trong lần khởi chạy đầu tiên

1. Nhấp vào biểu tượng Zoo Code trong Thanh hoạt động mã VS.
2. Chọn Nhà cung cấp LLM trên Màn hình chào mừng.
3. Chọn OpenAI Compatible, không phải tùy chọn yêu cầu tài khoản OpenAI chính thức.
4. Điền vào các trường bên dưới các giá trị TokenHub và hoàn tất quá trình khởi tạo.

Bắt đầu từ thiết bị sau khi thiết lập ban đầu

1. Mở thanh bên Zoo Code.
2. Nhấp vào bánh răng để mở Settings.
3. Chọn OpenAI Compatible từ API Provider.
4. Nhập:
   • Base URL: https://us-api.tokenhub.com/v1
   • API Key: khóa TokenHub API của bạn
   • Model ID: ID hoàn chỉnh từ danh mục mẫu TokenHub
   • Context Window Size: chỉ đặt cài đặt này sau khi xác nhận thông số kỹ thuật của mẫu
5. Lưu, sau đó xác nhận rằng chân trang tác vụ thực sự sử dụng hồ sơ nhà cung cấp này.

Nhà cung cấp Tương thích OpenAI hiện tại của Zoo Code gọi là Hoàn thành trò chuyện. Cơ sở URL sẽ dừng ở /v1; không nhập đường dẫn /chat/completions hoàn chỉnh.

Xác minh hành vi của tác nhân Zoo Code

1. Tạo một nhiệm vụ và hỏi, “Giải thích tệp hiện tại mà không sửa đổi nó.”
2. Xác nhận /v1/chat/completions và ID mẫu của cấu hình trong nhật ký TokenHub.
3. Yêu cầu chỉnh sửa một tệp nhỏ để xác minh rằng mô hình trả về lệnh gọi công cụ có cấu trúc.

Hướng dẫn lựa chọn mô hình của Zoo Code nhấn mạnh việc tuân theo hướng dẫn, tuân thủ định dạng và lưu giữ ngữ cảnh qua các bước công cụ. Nếu một mô hình trả lời các câu hỏi thông thường nhưng không thể chỉnh sửa tệp, hãy chuyển sang mô hình gọi công cụ mạnh hơn thay vì thay đổi liên tục Base URL.

Khắc phục sự cố các trường Nhà cung cấp thực tế

• 404: xác nhận Base URL kết thúc tại /v1 và chưa bao gồm /chat/completions.
• 401: dán lại khóa API và đảm bảo tác vụ hiện tại đã chọn cấu hình TokenHub.
• Lỗi mô hình: Model ID phải là ID hoàn chỉnh được TokenHub chấp nhận.
• Trò chuyện hoạt động nhưng các công cụ thì không: mô hình có thể không phù hợp với khai thác tác nhân của Zoo Code.
• Các thay đổi đã lưu sử dụng nhà cung cấp cũ: tạo tác vụ mới và kiểm tra lại nhà cung cấp/mô hình được hiển thị ở chân trang của nó.

Tài liệu tham khảo chính thức

• Zoo Code: kết nối nhà cung cấp đầu tiên của bạn
• Báo cáo trường tương thích OpenAI của Zoo Code
• Kho lưu trữ Zoo Code