AI Agents
שימוש ב-SeedRouter מסוכני AI
חבר סוכני תכנות ועוזרי AI ל-SeedRouter באמצעות שרת MCP, מיומנות לסוכן או HTTP API, והכר את המגבלות שסוכן צריך להביא בחשבון.
סוכן יכול להשתמש ב-SeedRouter בשלוש דרכים. כולן משתמשות באותו מפתח API, באותה יתרה, באותם מודלים ובאותן מגבלות, ומחויבות באותו אופן.
| דרך | מתאימה במיוחד ל- | הגדרה |
|---|---|---|
| שרת MCP | Claude Code, Cursor, Codex, VS Code ולקוחות MCP אחרים | הוסף את https://api.seedrouter.ai/v1/mcp עם מפתח ה-API שלך בכותרת Bearer |
| מיומנות לסוכן | סוכנים שטוענים Agent Skills | אינדקס המיומנויות נמצא ב-/.well-known/agent-skills/index.json |
| HTTP API | קוד משלך, או סוכן שכותב עבורך קוד | התחלה מהירה |
כדי להפעיל את הסוכן עצמו באמצעות מודלי הטקסט של SeedRouter במקום זאת, ראה סוכני תכנות ב-SeedRouter.
הגדר את המפתח פעם אחת
צור מפתח בעמוד מפתחות API וייצא אותו, כדי שהסוכן יוכל לקרוא אותו בלי שהמפתח יישמר בקובצי הפרויקט שלך:
export SEEDROUTER_API_KEY=YOUR_API_KEYבעמוד מפתחות API יש גם כפתור חיבור דרך MCP שמציג הגדרות מוכנות לכל לקוח MCP.
מה סוכן עושה ב-SeedRouter
- מציאת מודל: באמצעות
list_modelsדרך MCP, או רשימת המודלים ב-/llms.txt. לכל מודל עם עמוד נחיתה יש סיכום בטקסט פשוט ב-https://seedrouter.ai/models/<slug>/llms.txt, עם הפרמטרים, המחירים והדוגמאות שלו. - קריאת סכמת הקלט שלו: באמצעות
get_model_schemaדרך MCP, או עמוד התיעוד של המודל. - שימוש בכתובות מדיה ציבוריות: נקודות הקצה ליצירה מקבלות תמונות, סרטונים ואודיו לייחוס רק ככתובות
http(s)ציבוריות. קלט ב-Base64 נדחה, לכן אחסן תחילה קבצים מקומיים במקום שניתן לגשת אליו. - בדיקת המחיר: הקריאה ל-
get_pricingדרך MCP מחזירה את התעריפים הנוכחיים של המודל בדולר ארה״ב לפני שליחה כלשהי. - שליחה והמתנה: קרא ל-
submit_task, ואז ל-get_taskעםwait_seconds: 50עד שהמשימה מסתיימת. דרך HTTP, שלח לנקודת הקצה של המודל ותשאל אתGET /v1/tasks/{id}בערך כל שלוש שניות.
משימות שנכשלו אינן מחויבות. שליחה אינה אידמפוטנטית: חזרה על בקשה שלא קיבלת את תגובתה יוצרת משימה שנייה ומנכה גם את עלותה, לכן בדוק קודם את היסטוריית המשימות או את היתרה שלך.
מגבלות שיש להביא בחשבון
| מגבלה | ברירת מחדל | תגובה בחריגה |
|---|---|---|
| משימות תמונה ווידאו שרצות במקביל, לכל חשבון | 50 | HTTP 429, קוד 30002 |
בקשות עשויות להידחות גם עקב מגבלת קצב, וגם אז מוחזר HTTP 429. במקרה של HTTP 429, המתן למשך הזמן שמצוין ב-Retry-After, אם הוא קיים; אחרת הגדל את ההמתנה באופן מעריכי בין ניסיונות חוזרים, עם אקראיות מסוימת וזמן המתנה מרבי. בסס את ההחלטה על קוד הסטטוס במקום לנתח את גוף השגיאה, כי נקודות הקצה לטקסט משיבות בפורמט השגיאה של הפרוטוקול שלהן. תהליך אצווה צריך לנהל תור ולשלוח משימות חדשות ככל שמשימות רצות מסתיימות, במקום לשלוח הכול בבת אחת. פנה ל-[email protected] אם אתה זקוק למגבלה גבוהה יותר.
נקודות כניסה קריאות למכונה
| כתובת | מה היא מכילה |
|---|---|
/llms.txt | אינדקס מודלים, תיעוד ומדריכים עבור מודלי שפה |
/models/<slug>/llms.txt | הפרמטרים, המחירים והדוגמאות של מודל אחד |
/docs/<page>.md | כל עמוד תיעוד בפורמט Markdown, לדוגמה /docs/api/overview.md |
/.well-known/agent-skills/index.json | אינדקס מיומנויות לסוכנים |
/.well-known/api-catalog | קטלוג API (RFC 9727) |
https://api.seedrouter.ai/v1/mcp | שרת MCP |