A PandaNpc tárolja a szolgáltatói kapcsolatokat és modellbejegyzéseket, amelyeket konfigurál. Kezdje a szolgáltatása által megadott API-kulccsal, alap URL-lel, protokollal és modellazonosítóval. Egy bejegyzés hozzáadása nem hoz létre felső szintű fiókot, és nem biztosít hozzáférést a modellhez.
A szolgáltató és a modell közötti különbségről olvassa el a Egyéni modelllista kezelése című részt.
Kezdés előtt
Erősítse meg a következőket a szolgáltatójával vagy a saját üzemeltetésű szolgáltatással:
- Az API alapcíme, nem a szolgáltató weboldalának címe.
- A hitelesítési módszer és minden szükséges hitelesítő adat.
- Az API protokoll, amelyet a használni kívánt funkció vagy motor támogat.
- A pontos modellazonosító, amelyet a fiókja hívhat.
- A kontextus- és kimeneti korlátok, ha manuálisan kívánja megadni azokat.
A hitelesítő adatokat a szolgáltatói űrlapon tartsa, ne a promptokban, képernyőképeken vagy megosztott jegyzetekben. Egy OpenAI-kompatibilisként hirdetett szolgáltatás eltérhet a streaming, az eszközhívások vagy a kép támogatása terén.
1. Szolgáltató hozzáadása vagy konfigurálása
Nyissa meg a Modellkonfigurációt. Adjon hozzá szolgáltatót, konfiguráljon egy meglévő előbeállítást, vagy másoljon egy előbeállítást, ha függetlenül szerkeszthető kapcsolatra van szüksége.
| Mező | Mit adjon meg |
|---|---|
| Megjelenített név | Felismerhető név ehhez a kapcsolathoz |
| Szolgáltató azonosító | A szolgáltatói konfiguráció azonosítója |
| API-kulcs | A szolgáltatás által megkövetelt hitelesítő adat |
| Alap URL | A kiválasztott integráció által várt API alapcím |
| Protokoll | A formátum, amelyet a felső szintű API ténylegesen implementál |
| Titkos kulcs, Szervezet, Projekt | Csak azok az értékek, amelyeket a szolgáltatás kifejezetten megkövetel |
| Tartalomtömb támogatása | Hogy a szolgáltatás elfogadja-e a strukturált üzenettartalmat |
Az alap URL alakja a protokolltól és a kéréseket küldő funkciótól függ. Ne fűzzön hozzá teljes műveleti útvonalat, ha az integráció már hozzáfűzi. Például egy olyan integráció, amely hozzáadja a /chat/completions részt, a megfelelő alapcímet igényli, nem pedig egy olyan címet, amely már ezzel az útvonallal végződik. Ne alkalmazza ezt a példát minden protokollra.
Amikor tárolt hitelesítő adatokat szerkeszt, az API-kulcs vagy a titkos kulcs üresen hagyása megőrzi a beállított értéket. A listában látható maszkolt érték nem az eredeti kulcs, és nem szabad visszailleszteni csereként.
2. A modell hozzáadása
Mentse a szolgáltatót, válassza ki, majd válassza a Modell hozzáadása lehetőséget.
| Mező | Jelentés |
|---|---|
| Megjelenített név | Az Ön címkéje a modelllistában |
| Modellérték | A pontos felső szintű modellazonosító |
| Modelltípus | Az alkalmazandó kategória a konfigurációs űrlapon |
| Szolgáltató | A kapcsolat, amelyet ez a bejegyzés használ |
| Kontextusablak | A dokumentált kontextuskapacitás, ha meg van adva |
| Maximális tokenek | A kimeneti korlát, ha meg van adva |
Használjon azonosítót a szolgáltatás dokumentációjából vagy modelllistájából. A marketingnév nem feltétlenül API-azonosító. A nem kötelező korlátokat hagyja beállítatlanul, ha nem tudja ellenőrizni azokat; a beállítatlan nem azt jelenti, hogy a valós korlátokat észlelték. A felhasználó funkció saját alapértelmezéseket alkalmazhat.
3. A konfiguráció ellenőrzése
A beállításokat használó funkcióban vagy motorban:
- Válassza ki az új bejegyzést, és indítson tesztbeszélgetést.
- Küldjön egy rövid kérést, például:
Válaszolj: csatlakoztatva. - Erősítse meg a normál választ, és ha elérhető, a szolgáltató használati rekordjaiban egyező kérést.
- Küldjön egy követő üzenetet a folyamatos beszélgetés ellenőrzéséhez.
- Tesztelje a képeket vagy eszközhívásokat külön, ha a munkája megköveteli azokat.
A rekord mentése nem kapcsolódási teszt. A szöveges válasz nem bizonyítja a kompatibilitást minden képességgel. Egy modellbejegyzés módosítása szintén nem konfigurálja automatikusan újra a meglévő Claude Code vagy Codex folyamatot; lásd: PandaPaw.
Hibaelhárítás
Hitelesítési hiba
Ellenőrizze, hogy a kulcs aktív-e, a fiók hozzáfér-e a modellhez, és hogy a szolgáltatás további hitelesítési mezőket igényel-e. A lejárt hitelesítő adatokat cserélje ki a szolgáltatói űrlapon keresztül.
A végpont vagy a modell nem található
Ellenőrizze az alap URL-t és a modellértéket is. Keressen ismétlődő műveleti útvonalakat, hiányzó API-előtagot vagy olyan modellazonosítót, amely nem érhető el a fiókja számára. Ugyanaz a hiba különböző okokból adódhat a szolgáltatók között.
Hálózati vagy böngészőhiba jelenik meg
Ellenőrizze a kapcsolatot arról az eszközről, amely ténylegesen küldi a kérést. A böngészőből indított kérésekre a CORS és a HTTPS-korlátozások vonatkoznak; egy másik számítógépről működő kérés nem bizonyítja, hogy a böngésző útvonala működik.
A helyi modellkiszolgáló nem érhető el
A localhost a kérést küldő gépre vonatkozik. Nem automatikusan mutat a távoli PandaPaw számítógépére. Erősítse meg, hol fut a felhasználó funkció, mielőtt kiválasztja a helyi kiszolgáló címét.
A szöveg működik, de a képek, eszközök vagy hosszú munkamenetek meghiúsulnak
Ellenőrizze a motor, az API protokoll és a modell képességeinek pontos kombinációját. Használja a szolgáltató által támogatott korlátokat, és ellenőrizze minden szükséges bemeneti típust. A Kontextusablak növelése vagy a Modelltípus módosítása nem ad hozzá felső szintű képességeket.
A platformtagság és a szolgáltatói használat közötti különbségről lásd: fiókok és modellköltségek.