AgentNotificationActivity Třída

Obálka kolem objektu Activity s entitami typu oznámení.

Tato třída poskytuje pohodlný přístup k entitě typových oznámení extrahovaných z kolekce entit aktivity. Automaticky analyzuje a ověřuje e-mailová oznámení, komentáře k Wordu, PowerPointu nebo Excelu a události životního cyklu v době výstavby.

Konstruktor

AgentNotificationActivity()

Parametry

Name	Description
activity Vyžadováno	Objekt Aktivity, který se má zalamovat. Nesmí být Žádná.

Příklady

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

Metody

__init__
__new__
as_model	Parsujte hodnotu aktivity jako vlastní typ modelu. Tato metoda poskytuje obecný způsob, jak ověřit a analyzovat datovou část hodnoty aktivity do libovolného typu modelu Pydantic. Užitečné pro vlastní typy oznámení, které nejsou přímo podporovány zadanými vlastnostmi.

__init__

__init__(activity: Activity)

Parametry

Name	Description
activity Vyžadováno	Activity

__new__

__new__(**kwargs)

as_model

Parsujte hodnotu aktivity jako vlastní typ modelu.

Tato metoda poskytuje obecný způsob, jak ověřit a analyzovat datovou část hodnoty aktivity do libovolného typu modelu Pydantic. Užitečné pro vlastní typy oznámení, které nejsou přímo podporovány zadanými vlastnostmi.

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

Parametry

Name	Description
model Vyžadováno	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] Pydantický model třída pro ověření a parsování hodnoty aktivity do.

Návraty

Typ	Description
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None	Instance zadaného typu modelu, pokud je ověření úspěšné, jinak None.

Příklady

   from pydantic import BaseModel

   class CustomNotification(BaseModel):
       custom_field: str

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

Atributy

channel

Identifikátor kanálu z channel_id aktivity.

Návraty

Typ	Description
	Název kanálu (např. agenti, msteams) nebo Žádný( pokud není k dispozici).

email

Analyzovaná entita odkazu na e-mail( pokud je k dispozici).

Návraty

Typ	Description
	Objekt EmailReference, pokud byla nalezena entita e-mailového oznámení a úspěšně analyzována, jinak None.

notification_type

Zjištěný typ oznámení.

Návraty

Typ	Description
	Hodnota výčtu NotificationTypes označující typ oznámení (EMAIL_NOTIFICATION, WPX_COMMENT nebo AGENT_LIFECYCLE) nebo Žádný, pokud nelze určit typ oznámení.

sub_channel

Identifikátor subchannel z channel_id aktivity.

Návraty

Typ	Description
	Název podkanálu (např. e-mail, slovo) nebo Žádný, pokud není k dispozici.

type

Typ aktivity.

Návraty

Typ	Description
	Typ aktivity (například message, event) nebo None (pokud není nastavená).

value

Datová část hodnoty z aktivity.

Návraty

Typ	Description
	Hodnota aktivity, která může obsahovat další data oznámení.

wpx_comment

Analyzovaná entita komentáře Wordu, PowerPointu nebo Excelu( pokud je k dispozici).

Návraty

Typ	Description
	WpxComment objekt, pokud byla nalezena entita komentáře a úspěšně parsována, jinak None.

activity

Objekt podkladové aktivity.