AgentNotificationActivity Sınıf

Yazılan bildirim varlıklarına sahip bir Activity nesnesinin çevresinde sarmalayıcı.

Bu sınıf, bir Etkinliğin varlık koleksiyonundan ayıklanan türemiş bildirim varlıklarına kolay erişim sağlar. E-posta bildirimlerini, Word/PowerPoint/Excel açıklamalarını ve çalışma zamanındaki yaşam döngüsü olaylarını otomatik olarak ayrıştırıp doğrular.

Oluşturucu

AgentNotificationActivity()

Parametreler

Name	Description
activity Gerekli	Kaydıracak Activity nesnesi. Hiçbiri olmamalıdır.

Örnekler

   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}")

Yöntemler

__init__
__new__
as_model	Etkinlik değerini özel model türü olarak ayrıştırın. Bu yöntem, etkinliğin değer yükünü doğrulamak ve herhangi bir Pydantic model türünde ayrıştırmak için genel bir yol sağlar. Türü belirtilen özellikler tarafından doğrudan desteklenmeyen özel bildirim türleri için kullanışlıdır.

__init__

__init__(activity: Activity)

Parametreler

Name	Description
activity Gerekli	Activity

__new__

__new__(**kwargs)

as_model

Etkinlik değerini özel model türü olarak ayrıştırın.

Bu yöntem, etkinliğin değer yükünü doğrulamak ve herhangi bir Pydantic model türünde ayrıştırmak için genel bir yol sağlar. Türü belirtilen özellikler tarafından doğrudan desteklenmeyen özel bildirim türleri için kullanışlıdır.

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

Parametreler

Name	Description
model Gerekli	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] Etkinlik değerini doğrulamak ve ayrıştırmak için pydantic model sınıfı.

Döndürülenler

Tür	Description
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None	Doğrulama başarılı olursa belirtilen model türünün örneği, aksi takdirde Hiçbiri.

Örnekler

   from pydantic import BaseModel

   class CustomNotification(BaseModel):
       custom_field: str

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

Öznitelikler

channel

Etkinliğin channel_id kanal tanımlayıcısı.

Döndürülenler

Tür	Description
	Kanal adı (örneğin, 'agents', 'msteams') veya kullanılamıyorsa Hiçbiri.

email

Varsa ayrıştırılmış e-posta başvuru varlığı.

Döndürülenler

Tür	Description
	Bir e-posta bildirimi varlığı bulunduysa ve başarıyla ayrıştırıldıysa emailReference nesnesi, aksi takdirde Yok.

notification_type

Algılanan bildirim türü.

Döndürülenler

Tür	Description
	Bildirim türünü belirten NotificationTypes sabit listesi değeri (EMAIL_NOTIFICATION, WPX_COMMENT veya AGENT_LIFECYCLE) veya bildirim türü belirlenemediyse Hiçbiri.

sub_channel

Etkinliğin channel_id alt kanal tanımlayıcısı.

Döndürülenler

Tür	Description
	Alt kanal adı (örneğin, 'e-posta', 'sözcük') veya yoksa Yok.

type

Etkinlik türü.

Döndürülenler

Tür	Description
	Etkinlik türü (örneğin, "ileti", "olay") veya ayarlanmadıysa Hiçbiri.

value

Etkinlikten gelen değer yükü.

Döndürülenler

Tür	Description
	Etkinliğin değeri; ek bildirim verileri içerebilir.

wpx_comment

Varsa ayrıştırılmış Word/PowerPoint/Excel açıklama varlığı.

Döndürülenler

Tür	Description
	Bir açıklama varlığı bulunduysa ve başarıyla ayrıştırıldıysa WpxComment nesnesi, aksi takdirde Hiçbiri.

activity

Temel alınan Activity nesnesi.