דלג לתוכן הראשי
אתה צופה בתיעוד למפתחים
תיעוד זה מיועד למפתחים העובדים עם פלטפורמת המפתחים של Base44. למידע על סוכני AI בעורך האפליקציות, ראה הגדרת סוכן AI.
סוכני AI הם עוזרי AI הניתנים להתאמה אישית שמבצעים פעולות ומתחברים לכלים כדי לעזור לחברי צוות ולמשתמשי קצה. הגדר התנהגות סוכן, הרשאות וכלים באמצעות קבצי תצורה מקומיים מסוג JSONC.

יצירת agents

צור קבצי תצורה JSONC בתיקיית base44/agents/ שלך (קובץ אחד לכל agent), ואז הרץ agents push כדי לסנכרן אותם ל-Base44.

דוגמה

{
  "name": "customer_support",
  "description": "Handles customer support inquiries and ticket management",
  "instructions": "You are a friendly customer support agent. Help users resolve their issues politely and efficiently. If you cannot help, escalate to a human agent.",
  "model": "anthropic/claude-sonnet-4-20250514",
  "tool_configs": [
    {
      "entity_name": "tickets",
      "allowed_operations": ["read", "create", "update"],
    },
    {
      "entity_name": "customers",
      "allowed_operations": ["read"],
    },
    {
      "function_name": "send_notification",
      "description": "Sends a push notification to the customer",
    },
    {
      "function_name": "escalate_to_human",
      "description": "Escalates the conversation to a human support agent",
    },
  ],
  "whatsapp_greeting": "Hi, I'm your support assistant. How can I help you today?",
}

סימוכין שדות

תצורות סוכן משתמשות ב-JSONC. כל סוכן מוגדר בקובץ נפרד בתיקיית base44/agents/.

שדות נדרשים

name
string
נדרש
מזהה ייחודי עבור הסוכן. השתמש באותיות קטנות וקו תחתון. השם צריך להתאים לשם הקובץ, כך שסוכן בשם customer_support יהיה ב-customer_support.jsonc.
description
string
נדרש
תיאור קצר של מה שהסוכן עושה.
instructions
string
נדרש
System prompt המגדיר את התנהגות הסוכן, האישיות שלו וההנחיות.
model
string
נדרש
מודל ה-AI לשימוש, בפורמט provider/model-name.מודלים נתמכים:
  • anthropic/claude-sonnet-4-20250514
  • anthropic/claude-3-5-sonnet-20241022
  • openai/gpt-4o
  • openai/gpt-4o-mini

שדות אופציונליים

tool_configs
array
כלים שהסוכן יכול להשתמש בהם כדי לתקשר עם האפליקציה שלך. ראה Tool configuration.
whatsapp_greeting
string
הודעת ברכה לשיחות WhatsApp עם סוכן זה.

תצורת כלים

המערך tool_configs מגדיר אילו יכולות יש לסוכן שלך. יש שני סוגים: entity tools ו-function tools.

Entity tools

Entity tools מאפשרים לסוכן לבצע פעולות CRUD על entities של האפליקציה שלך.
entity_name
string
נדרש
שם ה-entity. חייב להתאים ל-entity קיים באפליקציה שלך.
allowed_operations
array
נדרש
פעולות שהסוכן יכול לבצע על entity זה. ערכים תקפים הם "read", "create", "update", ו-"delete".

Function tools

Function tools מאפשרים לסוכן להפעיל פונקציות בקאנד של האפליקציה שלך.
function_name
string
נדרש
שם הפונקציה. חייב להתאים לפונקציה קיימת באפליקציה שלך.
description
string
נדרש
תיאור של מה שהפונקציה עושה. הסוכן משתמש בזה כדי להחליט מתי לקרוא לה.

TypeScript types

ייצר TypeScript types מתצורות הסוכנים שלך כדי לקבל בטיחות סוגים ו-autocomplete עבור שמות סוכנים בקוד ה-SDK שלך. למד עוד על dynamic types.

ראה גם

  • agents pull: סנכרן תצורות סוכן מ-Base44 לפרויקט המקומי שלך
  • agents push: פרוס את תצורות הסוכן המקומיות שלך ל-Base44
  • agents: סימוכין SDK לעבודה עם agents בקוד שלך
  • Setting up AI agents: מדריך ליצירה והגדרה של סוכני AI
דף זה תורגם באמצעות בינה מלאכותית. למידע המדויק והעדכני ביותר, עיין בגרסה האנגלית.