השתמש בתהליכי עבודה בקוד

הושלם

לאחר תכנון ובדיקת תהליך עבודה במעצב הוויזואלי של Microsoft Foundry, תוכל לשלב אותו באפליקציות שלך באמצעות Azure AI Projects SDK. זה מאפשר לך להטמיע אוטומציה מונעת זרימת עבודה באפליקציות ווב, APIs, שירותי backend ופתרונות תוכנה נוספים.

זרימות עבודה נוצרות בפורטל Foundry באמצעות המעצב הוויזואלי, שמייצר את הגדרת YAML הבסיסית. ברגע שזרימת עבודה נשמרת בפרויקט שלך, תוכל להפעיל אותה תכנותית על ידי התייחסות לשמו. אתה גם יכול להוריד את הגדרת ה-YAML של זרימת העבודה מהפורטל ולכלול אותה בקוד שלך.

הפעלת תהליך עבודה

לפני הפעלת תהליך עבודה, יצר חיבור לפרויקט Microsoft Foundry שלך באמצעות .AIProjectClient לקוח זה מטפל באימות ומספק גישה ל-API התואם ל-OpenAI לביצוע שיחות והפעלת תהליכי עבודה. כדי להריץ זרימת עבודה קיימת בפרויקט שלך, צור שיחה והפעל את זרימת העבודה בשמה.

# Reference a workflow created in the Foundry portal
workflow_name = "triage-workflow"

# Create a conversation context for the workflow
conversation = openai_client.conversations.create()

# Execute the workflow, passing input to drive the workflow logic
stream = openai_client.responses.create(
    conversation=conversation.id,
    extra_body={"agent": {"name": workflow_name, "type": "agent_reference"}},
    input="Users can't reset their password from the mobile app.",
    stream=True,
)

הפרמטר input מאפשר להעביר הודעה או הודעה לתהליך העבודה, שתהליך העבודה יכול להשתמש בו כדי להניע את הלוגיקה שלו — כמו עיבוד בקשת משתמש, מיון קריאת תמיכה או מענה לשאלה. בהתאם לאופן שבו זרימת העבודה שלך מעוצבת, הקלט הזה עשוי להיות:

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

תהליך אירועי זרימת עבודה

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

for event in stream:
    if event.type == "response.completed":
        print("Workflow completed:")
        for message in event.response.output:
            if message.content:
                for content_item in message.content:
                    if content_item.type == 'output_text':
                        print(content_item.text)
    if (event.type == "response.output_item.done") and event.item.type == ItemType.WORKFLOW_ACTION:
        print(f"Action '{event.item.action_id}' completed with status: {event.item.status}")

סוגי אירועים נפוצים כוללים:

סוג האירוע	תיאור
response.completed	זרימת העבודה סיימה את הביצוע והחזירה תגובה סופית
response.output_item.done	פריט פלט בודד (כגון פעולה בתהליך עבודה) הושלם

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

יתרונות אינטגרציית קוד

שילוב זרימות עבודה בקוד שלך מאפשר מספר תרחישים:

תרחיש	תועלת
יישומי אינטרנט	הטמיעו תהליכי עבודה מבוססי בינה מלאכותית ישירות באפליקציות הפונות למשתמשים
ממשקי API ומיקרו-שירותים	חשיפת יכולות זרימת עבודה דרך נקודות קצה REST
עיבוד אצווה	הפעלת תהליכי עבודה תכנותית לפעולות מרוכזות
בדיקות וולידציה	אוטומציה של בדיקות זרימת עבודה כחלק מצינורות CI/CD
ממשקים מותאמים אישית	בנה ממשקי משתמש ייעודיים המותאמים למקרי שימוש ספציפיים בזרימת עבודה

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