AgentNotificationActivity מחלקה

עטיפת אובייקט פעילות עם ישויות הודעה שהוקלדה.

מחלקה זו מספקת גישה נוחה לישויות הודעה שהוקלדה שחולצו מאוסף ישויות של פעילות. היא מנתחת ומאמתת באופן אוטומטי הודעות דואר אלקטרוני, הערות Word/PowerPoint/Excel ואירועי מחזור חיים בזמן הבנייה.

בנאי

AgentNotificationActivity()

פרמטרים

שם	תיאור
activity נדרש	אובייקט הפעילות לגלישה. לא יכול להיות ללא.

דוגמאות

   async def email_handler(
       context: TurnContext,
       state: TurnState,
       notification: AgentNotificationActivity,
   ) -> None:
       email = notification.email
       if email:
           print(f"Received email: {email.id}")
           print(f"Body: {email.html_body}")

שיטות

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

__init__

__init__(activity: Activity)

פרמטרים

שם	תיאור
activity נדרש	Activity

__new__

__new__(**kwargs)

as_model

ניתוח ערך הפעילות כסוג מודל מותאם אישית.

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

as_model(model: Type[TModel]) -> TModel | None

פרמטרים

שם	תיאור
model נדרש	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] מחלקה של מודלים פידאנטיים לאימות ולנתח את ערך הפעילות.

החזרות

סוג נתונים	תיאור
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None	מופע של סוג המודל שצוין אם האימות מצליח, אחרת ללא.

דוגמאות

   from pydantic import BaseModel

   class CustomNotification(BaseModel):
       custom_field: str

   notification = AgentNotificationActivity(activity)
   custom = notification.as_model(CustomNotification)
   if custom:
       print(custom.custom_field)

תכונות

channel

מזהה הערוץ מרשימת הערוצים של channel_id.

החזרות

סוג נתונים	תיאור
	שם הערוץ (לדוגמה, 'agents', 'msteams') או ללא אם הוא אינו זמין.

email

ישות הפניה לדואר אלקטרוני שנותחת, אם היא קיימת.

החזרות

סוג נתונים	תיאור
	אובייקט EmailReference אם ישות של הודעת דואר אלקטרוני נמצאה ונתחה בהצלחה, אחרת ללא.

notification_type

סוג ההודעה שזוהה.

החזרות

סוג נתונים	תיאור
	ערך Enum של NotificationTypes המציין את סוג ההודעה (EMAIL_NOTIFICATION, WPX_COMMENT או AGENT_LIFECYCLE) או ללא אם לא היתה אפשרות לקבוע את סוג ההודעה.

sub_channel

מזהה משפך המשנה ממזהה ה- channel_id.

החזרות

סוג נתונים	תיאור
	שם משפך המשנה (לדוגמה, 'דואר אלקטרוני', 'מילה') או 'ללא' אם אינו זמין.

type

סוג הפעילות.

החזרות

סוג נתונים	תיאור
	סוג הפעילות (לדוגמה, 'הודעה', 'אירוע') או 'ללא' אם לא הוגדר.

value

תוכן המנה של הערך מהפעילות.

החזרות

סוג נתונים	תיאור
	ערך הפעילות, שעשוי להכיל נתוני הודעות נוספים.

wpx_comment

ישות ההערה של Word/PowerPoint/Excel שנותתח, אם היא קיימת.

החזרות

סוג נתונים	תיאור
	אובייקט WpxComment אם ישות הערה נמצאה ונתחה בהצלחה, אחרת ללא.

activity

האובייקט פעילות המשמשת כפעילות.