PandaNpc מאחסנת חיבורי ספקים וערכי מודלים שאתה מגדיר. התחל עם מפתח ה-API, כתובת ה-URL הבסיסית, הפרוטוקול ומזהה המודל שסופקו על ידי השירות שלך. הוספת ערך אינה יוצרת חשבון אצל הספק או מעניקה גישה למודל.
להבחנה בין ספק למודל, קרא ניהול רשימת המודלים המותאמת אישית שלך.
לפני שמתחילים
אמת את הפרטים הבאים מול הספק או השירות המתארח אצלך:
- כתובת ה-API הבסיסית, לא כתובת האתר של הספק.
- שיטת האימות וכל פרטי הזדהות נדרשים.
- פרוטוקול ה-API שנתמך על ידי התכונה או המנוע שברצונך להשתמש בו.
- מזהה המודל המדויק שהחשבון שלך יכול לקרוא.
- מגבלות קונטקסט ופלט אם אתה מתכנן להזין אותן ידנית.
שמור פרטי הזדהות בטופס הספק, לא בהנחיות, בצילומי מסך או בהערות משותפות. שירות שמוצג כתואם OpenAI עדיין עשוי להיות שונה בזרימה, בקריאות לכלים או בתמיכה בתמונות.
1. הוסף או הגדר ספק
פתח את תצורת מודלים. הוסף ספק, הגדר קביעה מוגדרת מראש קיימת, או העתק קביעה כאשר אתה צריך חיבור שניתן לעריכה באופן עצמאי.
| שדה | מה להזין |
|---|---|
| שם תצוגה | שם מזוהה עבור חיבור זה |
| מזהה ספק | מזהה עבור תצורת הספק |
| מפתח API | פרטי ההזדהות הנדרשים על ידי השירות שלך |
| כתובת URL בסיסית | כתובת ה-API הבסיסית שצפויה על ידי האינטגרציה הנבחרת |
| פרוטוקול | הפורמט שה-API של הספק אכן מיישם |
| סוד, ארגון, פרויקט | רק ערכים הנדרשים במפורש על ידי השירות שלך |
| תמיכה במערך תוכן | האם השירות מקבל תוכן הודעות מובנה |
צורת ה-URL הבסיסית תלויה בפרוטוקול ובתכונה ששולחת בקשות. אל תוסיף נתיב פעולה מלא אם האינטגרציה כבר מוסיפה אותו. לדוגמה, אינטגרציה שמוסיפה /chat/completions זקוקה לכתובת הבסיסית המתאימה, לא לכתובת שכבר מסתיימת בנתיב זה. אל תיישם דוגמה זו על כל פרוטוקול.
בעת עריכת פרטי הזדהות שמורים, השארת שדה מפתח ה-API או הסוד ריק שומרת על הערך המוגדר. ערך מוסתר המוצג ברשימה אינו המפתח המקורי ואין להדביק אותו כתחליף.
2. הוסף את המודל
שמור את הספק, בחר אותו ובחר הוסף מודל.
| שדה | משמעות |
|---|---|
| שם תצוגה | התווית שלך ברשימת המודלים |
| ערך מודל | מזהה המודל המדויק של הספק |
| סוג מודל | הקטגוריה הרלוונטית בטופס התצורה |
| ספק | החיבור שערך זה משתמש בו |
| חלון קונטקסט | קיבולת הקונטקסט המתועדת, כאשר צוינה |
| מקסימום טוקנים | מגבלת הפלט, כאשר צוינה |
השתמש במזהה מתיעוד השירות או מרשימת המודלים. שם שיווקי אינו בהכרח מזהה API. השאר מגבלות אופציונליות לא מוגדרות אם אינך יכול לאמת אותן; אי-הגדרה אינה אומרת שהמגבלות האמיתיות זוהו. התכונה המשתמשת עשויה להחיל ברירות מחדל משלה.
3. אמת את התצורה
בתכונה או במנוע המשתמשים בהגדרות אלה:
- בחר את הערך החדש והתחל שיחת בדיקה.
- שלח בקשה קצרה כגון
השב עם: מחובר. - אשר תגובה רגילה ובמקום שבו זמין, בקשה תואמת ברשומות השימוש של הספק.
- שלח הודעת המשך כדי לבדוק שיחה רציפה.
- בדוק תמונות או כלים בנפרד אם העבודה שלך דורשת זאת.
שמירת הרשומה אינה בדיקת חיבור. תגובה טקסטואלית אינה מבססת תאימות עם כל יכולות. שינוי ערך מודל גם אינו מגדיר מחדש אוטומטית תהליך קיים של Claude Code או Codex; ראה PandaPaw.
פתרון בעיות
האימות נכשל
בדוק אם המפתח פעיל, אם החשבון יכול לגשת למודל, ואם השירות דורש שדות אימות נוספים. החלף פרטי הזדהות שפגו באמצעות טופס הספק.
נקודת הקצה או המודל לא נמצאו
בדוק גם את כתובת ה-URL הבסיסית וגם את ערך המודל. חפש נתיבי פעולה כפולים, קידומת API חסרה, או מזהה מודל שאינו זמין לחשבון שלך. אותה שגיאה יכולה להיות בעלת סיבות שונות בקרב ספקים.
מופיעה שגיאת רשת או דפדפן
בדוק קישוריות מהמכשיר ששולח בפועל את הבקשה. בקשות שמקורן בדפדפן כפופות למגבלות CORS ו-HTTPS; בקשה שעובדת ממחשב אחר אינה מוכיחה שנתיב הדפדפן עובד.
לא ניתן להגיע לשרת מודל מקומי
localhost מתייחס למחשב ששולח את הבקשה. הוא אינו מצביע אוטומטית על מחשב PandaPaw המרוחק שלך. ודא היכן פועלת התכונה המשתמשת לפני בחירת כתובת השרת המקומי שלך.
טקסט עובד אך תמונות, כלים או שיחות ארוכות נכשלים
בדוק את השילוב המדויק של מנוע, פרוטוקול API ויכולות מודל. השתמש במגבלות שנתמכות על ידי הספק ואמת כל סוג קלט נדרש. הגדלת חלון הקונטקסט או שינוי סוג המודל אינה מוסיפה יכולות אצל הספק.
להבחנה בין חברות בפלטפורמה לשימוש בספק, ראה חשבונות ועלויות מודל.