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	تحليل قيمة النشاط كنوع نموذج مخصص. يوفر هذا الأسلوب طريقة عامة للتحقق من صحة حمولة قيمة النشاط وتحليلها في أي نوع نموذج Pydantic. مفيدة بالنسبة إلى أنواع الإعلامات المخصصة غير المعتمدة مباشرة من قبل الخصائص التي تمت كتابتها.

__init__

__init__(activity: Activity)

المعلمات

الاسم	الوصف
activity مطلوب	Activity

__new__

__new__(**kwargs)

as_model

تحليل قيمة النشاط كنوع نموذج مخصص.

يوفر هذا الأسلوب طريقة عامة للتحقق من صحة حمولة قيمة النشاط وتحليلها في أي نوع نموذج Pydantic. مفيدة بالنسبة إلى أنواع الإعلامات المخصصة غير المعتمدة مباشرة من قبل الخصائص التي تمت كتابتها.

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

المعلمات

الاسم	الوصف
model مطلوب	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] فئة نموذج Pydantic للتحقق من صحة قيمة النشاط وتحليلها.

المرتجعات

النوع	الوصف
<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 النشاط.

المرتجعات

النوع	الوصف
	اسم القناة (على سبيل المثال، "الوكلاء" أو "msteams") أو بلا إذا لم يكن متوفرا.

email

الكيان المرجعي للبريد الإلكتروني الذي تم تحليله، إذا كان موجودا.

المرتجعات

النوع	الوصف
	كائن EmailReference إذا تم العثور على كيان إعلام بالبريد الإلكتروني وتم تحليله بنجاح، وإلا فلا شيء.

notification_type

نوع الإعلام المكتشف.

المرتجعات

النوع	الوصف
	قيمة قائمة تعداد NotificationTypes التي تشير إلى نوع الإعلام (EMAIL_NOTIFICATION أو WPX_COMMENT أو AGENT_LIFECYCLE)، أو بلا إذا تعذر تحديد نوع الإعلام.

sub_channel

معرف القناة الفرعية من channel_id النشاط.

المرتجعات

النوع	الوصف
	اسم القناة الفرعية (على سبيل المثال، "البريد الإلكتروني" أو "كلمة") أو بلا إذا لم يكن متوفرا.

type

نوع النشاط.

المرتجعات

النوع	الوصف
	نوع النشاط (على سبيل المثال، 'رسالة' أو 'حدث') أو بلا إذا لم يتم تعيينه.

value

حمولة القيمة من النشاط.

المرتجعات

النوع	الوصف
	قيمة النشاط، والتي قد تحتوي على بيانات إعلام إضافية.

wpx_comment

كيان التعليق Word/PowerPoint/Excel الذي تم تحليله، إذا كان موجودا.

المرتجعات

النوع	الوصف
	كائن WpxComment إذا تم العثور على كيان تعليق وتم تحليله بنجاح، وإلا فلا شيء.

activity

كائن النشاط الأساسي.