PandaNpc przechowuje połączenia dostawców i wpisy modeli, które skonfigurujesz. Zacznij od klucza API, adresu bazowego, protokołu i identyfikatora modelu dostarczonych przez Twojego usługodawcę. Dodanie wpisu nie tworzy konta u dostawcy ani nie przyznaje dostępu do modelu.
Aby poznać różnicę między dostawcą a modelem, przeczytaj Zarządzanie listą niestandardowych modeli.
Zanim zaczniesz
Potwierdź z dostawcą lub usługą hostowaną samodzielnie następujące kwestie:
- Adres bazowy API, a nie adres strony internetowej dostawcy.
- Metodę uwierzytelniania i wszelkie wymagane poświadczenia.
- Protokół API obsługiwany przez funkcję lub silnik, którego zamierzasz użyć.
- Dokładny identyfikator modelu, który może wywołać Twoje konto.
- Limity kontekstu i wyjścia, jeśli planujesz wprowadzić je ręcznie.
Przechowuj poświadczenia w formularzu dostawcy, a nie w promptach, zrzutach ekranu lub współdzielonych notatkach. Usługa reklamowana jako zgodna z OpenAI może nadal różnić się pod względem strumieniowania, wywołań narzędzi lub obsługi obrazów.
1. Dodaj lub skonfiguruj dostawcę
Otwórz Konfiguracja modeli. Dodaj dostawcę, skonfiguruj istniejący preset lub skopiuj preset, gdy potrzebujesz niezależnie edytowalnego połączenia.
| Pole | Co wpisać |
|---|---|
| Nazwa wyświetlana | Rozpoznawalna nazwa tego połączenia |
| Identyfikator dostawcy | Identyfikator konfiguracji dostawcy |
| Klucz API | Poświadczenie wymagane przez Twoją usługę |
| Adres bazowy | Adres bazowy API oczekiwany przez wybraną integrację |
| Protokół | Format, który faktycznie implementuje API dostawcy |
| Sekret, Organizacja, Projekt | Tylko wartości wyraźnie wymagane przez Twoją usługę |
| Obsługa tablicy treści | Czy usługa akceptuje ustrukturyzowaną treść wiadomości |
Kształt adresu bazowego zależy od protokołu i funkcji wysyłającej żądania. Nie dołączaj pełnej ścieżki operacji, jeśli integracja już ją dodaje. Na przykład integracja, która dodaje /chat/completions, potrzebuje odpowiedniego adresu bazowego, a nie adresu kończącego się już tą ścieżką. Nie stosuj tego przykładu do każdego protokołu.
Podczas edycji zapisanych poświadczeń pozostawienie pola Klucz API lub Sekret pustym zachowuje skonfigurowaną wartość. Zamaszona wartość pokazana na liście nie jest oryginalnym kluczem i nie należy jej wklejać jako zamiennika.
2. Dodaj model
Zapisz dostawcę, wybierz go i wybierz Dodaj model.
| Pole | Znaczenie |
|---|---|
| Nazwa wyświetlana | Twoja etykieta na liście modeli |
| Wartość modelu | Dokładny identyfikator modelu u dostawcy |
| Typ modelu | Odpowiednia kategoria w formularzu konfiguracyjnym |
| Dostawca | Połączenie używane przez ten wpis |
| Okno kontekstu | Udokumentowana pojemność kontekstu, jeśli określona |
| Maksymalna liczba tokenów | Limit wyjścia, jeśli określony |
Użyj identyfikatora z dokumentacji usługi lub listy modeli. Nazwa marketingowa nie musi być identyfikatorem API. Pozostaw opcjonalne limity nieustawione, jeśli nie możesz ich zweryfikować; nieustawione nie oznacza, że rzeczywiste limity zostały wykryte. Funkcja korzystająca z tych ustawień może zastosować własne wartości domyślne.
3. Zweryfikuj konfigurację
W funkcji lub silniku, który używa tych ustawień:
- Wybierz nowy wpis i rozpocznij testową rozmowę.
- Wyślij krótkie żądanie, takie jak
Odpowiedz: połączono. - Potwierdź normalną odpowiedź i, jeśli to możliwe, zgodne żądanie w rekordach użycia dostawcy.
- Wyślij kontynuację, aby sprawdzić ciągłość rozmowy.
- Przetestuj obrazy lub narzędzia osobno, jeśli Twoja praca tego wymaga.
Zapisanie rekordu nie jest testem połączenia. Odpowiedź tekstowa nie potwierdza zgodności ze wszystkimi możliwościami. Zmiana wpisu modelu nie powoduje również automatycznej rekonfiguracji istniejącego procesu Claude Code lub Codex; zobacz PandaPaw.
Rozwiązywanie problemów
Uwierzytelnianie nie powiodło się
Sprawdź, czy klucz jest aktywny, czy konto ma dostęp do modelu i czy usługa wymaga dodatkowych pól uwierzytelniania. Wymień wygasłe poświadczenia za pomocą formularza dostawcy.
Punkt końcowy lub model nie został znaleziony
Sprawdź zarówno adres bazowy, jak i wartość modelu. Poszukaj zduplikowanych ścieżek operacji, brakującego prefiksu API lub identyfikatora modelu niedostępnego dla Twojego konta. Ten sam błąd może mieć różne przyczyny u różnych dostawców.
Pojawia się błąd sieci lub przeglądarki
Sprawdź łączność z urządzenia, które faktycznie wysyła żądanie. Żądania pochodzące z przeglądarki podlegają ograniczeniom CORS i HTTPS; działające żądanie z innego komputera nie dowodzi, że ścieżka przez przeglądarkę działa.
Nie można osiągnąć lokalnego serwera modeli
localhost odnosi się do maszyny wysyłającej żądanie. Nie wskazuje automatycznie na zdalny komputer PandaPaw. Potwierdź, gdzie działa funkcja korzystająca z tych ustawień, zanim wybierzesz adres swojego lokalnego serwera.
Tekst działa, ale obrazy, narzędzia lub długie sesje nie działają
Sprawdź dokładną kombinację silnika, protokołu API i możliwości modelu. Używaj limitów obsługiwanych przez dostawcę i zweryfikuj każdy wymagany typ wejścia. Zwiększenie okna kontekstu lub zmiana typu modelu nie dodaje możliwości u dostawcy.
Aby poznać różnicę między członkostwem na platformie a korzystaniem z dostawcy, zobacz konta i koszty modeli.