AgentNotificationActivity Klasse

Ombryd rundt om et aktivitetsobjekt med angivne meddelelsesenheder.

Denne klasse giver nem adgang til angivne meddelelsesobjekter, der er udtrukket fra en aktivitets objektsamling. Den fortolker og validerer automatisk mailmeddelelser, Word/PowerPoint/Excel-kommentarer og livscyklushændelser på byggetidspunktet.

Konstruktør

AgentNotificationActivity()

Parametre

Name	Beskrivelse
activity Påkrævet	Det aktivitetsobjekt, der skal ombrydes. Må ikke være None.

Eksempler

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

Metoder

__init__
__new__
as_model	Parse aktivitetsværdien som en brugerdefineret modeltype. Denne metode er en generisk metode til at validere og fortolke aktivitetens værdidata i en hvilken som helst pydantisk modeltype. Nyttig til brugerdefinerede meddelelsestyper, der ikke understøttes direkte af de angivne egenskaber.

__init__

__init__(activity: Activity)

Parametre

Name	Beskrivelse
activity Påkrævet	Activity

__new__

__new__(**kwargs)

as_model

Parse aktivitetsværdien som en brugerdefineret modeltype.

Denne metode er en generisk metode til at validere og fortolke aktivitetens værdidata i en hvilken som helst pydantisk modeltype. Nyttig til brugerdefinerede meddelelsestyper, der ikke understøttes direkte af de angivne egenskaber.

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

Parametre

Name	Beskrivelse
model Påkrævet	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] En Pydantisk modelklasse, som aktivitetsværdien skal valideres og fortolkes i.

Returnerer

Type	Beskrivelse
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None	En forekomst af den angivne modeltype, hvis valideringen lykkes, ellers Ingen.

Eksempler

   from pydantic import BaseModel

   class CustomNotification(BaseModel):
       custom_field: str

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

Attributter

channel

Kanal-id'et fra aktivitetens channel_id.

Returnerer

Type	Beskrivelse
	Kanalnavnet (f.eks. 'agenter', 'msteams') eller Ingen, hvis det ikke er tilgængeligt.

email

Den fortolkede mailreferenceenhed, hvis den findes.

Returnerer

Type	Beskrivelse
	Et EmailReference-objekt, hvis der blev fundet en mailmeddelelsesenhed, og den blev fortolket, ellers Ingen.

notification_type

Den registrerede meddelelsestype.

Returnerer

Type	Beskrivelse
	Optællingsværdien NotificationTypes, der angiver meddelelsestypen (EMAIL_NOTIFICATION, WPX_COMMENT eller AGENT_LIFECYCLE) eller Ingen, hvis meddelelsestypen ikke kunne bestemmes.

sub_channel

Underkanal-id'et fra aktivitetens channel_id.

Returnerer

Type	Beskrivelse
	Underkanalnavnet (f.eks. 'mail', 'ord') eller Ingen, hvis det ikke er tilgængeligt.

type

Aktivitetstypen.

Returnerer

Type	Beskrivelse
	Aktivitetens type (f.eks. 'meddelelse', 'hændelse') eller Ingen, hvis den ikke er angivet.

value

Værdiens nyttedata fra aktiviteten.

Returnerer

Type	Beskrivelse
	Aktivitetens værdi, som kan indeholde yderligere meddelelsesdata.

wpx_comment

Det parsede Word/PowerPoint/Excel-kommentarobjekt, hvis det findes.

Returnerer

Type	Beskrivelse
	Et WpxComment-objekt, hvis en kommentarenhed blev fundet og fortolket korrekt, ellers Ingen.

activity

Det underliggende aktivitetsobjekt.