AgentNotificationActivity Klasse

Bryt rundt et aktivitetsobjekt med innskrevne varslingsenheter.

Denne klassen gir praktisk tilgang til innskrevne varslingsenheter som er hentet fra en aktivitets samling av enheter. Den analyserer og validerer automatisk e-postvarsler, Word/PowerPoint/Excel-kommentarer og livssyklushendelser på byggetidspunktet.

Konstruktør

AgentNotificationActivity()

Parametere

Navn	Beskrivelse
activity Obligatorisk	Aktivitetsobjektet som skal brytes. Kan ikke være Ingen.

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	Analyser aktivitetsverdien som en egendefinert modelltype. Denne metoden gir en generell metode for å validere og analysere aktivitetens nyttelast for verdi i en pydantisk modelltype. Nyttig for egendefinerte varslingstyper som ikke støttes direkte av de innskrevne egenskapene.

__init__

__init__(activity: Activity)

Parametere

Navn	Beskrivelse
activity Obligatorisk	Activity

__new__

__new__(**kwargs)

as_model

Analyser aktivitetsverdien som en egendefinert modelltype.

Denne metoden gir en generell metode for å validere og analysere aktivitetens nyttelast for verdi i en pydantisk modelltype. Nyttig for egendefinerte varslingstyper som ikke støttes direkte av de innskrevne egenskapene.

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

Parametere

Navn	Beskrivelse
model Obligatorisk	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] En pydantisk modellklasse som du kan validere og analysere aktivitetsverdien i.

Returnerer

Type	Beskrivelse
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None	En forekomst av den angitte modelltypen 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

Kanalidentifikatoren fra aktivitetens channel_id.

Returnerer

Type	Beskrivelse
	Kanalnavnet (for eksempel «agenter», «msteams») eller Ingen hvis det ikke er tilgjengelig.

email

Den analyserte e-postreferanseenheten, hvis den finnes.

Returnerer

Type	Beskrivelse
	Et EmailReference-objekt hvis en e-postvarslingsenhet ble funnet og analysert, ellers ingen.

notification_type

Den oppdagede varslingstypen.

Returnerer

Type	Beskrivelse
	NotificationTypes-opplistingsverdien som angir varslingstypen (EMAIL_NOTIFICATION, WPX_COMMENT eller AGENT_LIFECYCLE) eller Ingen hvis varslingstypen ikke kunne fastslås.

sub_channel

Underkanalidentifikatoren fra aktivitetens channel_id.

Returnerer

Type	Beskrivelse
	Underkanalnavnet (for eksempel e-post, ord) eller Ingen hvis det ikke er tilgjengelig.

type

Aktivitetstypen.

Returnerer

Type	Beskrivelse
	Aktivitetstypen (f.eks. melding, hendelse) eller ingen hvis den ikke er angitt.

value

Nyttelasten for verdien fra aktiviteten.

Returnerer

Type	Beskrivelse
	Aktivitetens verdi, som kan inneholde flere varslingsdata.

wpx_comment

Den analyserte kommentarenheten i Word/PowerPoint/Excel, hvis den finnes.

Returnerer

Type	Beskrivelse
	Et WpxComment-objekt hvis en kommentarenhet ble funnet og analysert, ellers ingen.

activity

Det underliggende aktivitetsobjektet.