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 model στην οποία θα επικυρωθεί και αναλυεί η τιμή δραστηριότητας.

Επιστροφές

Τύπος	Περιγραφή
<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 δραστηριότητας.

Επιστροφές

Τύπος	Περιγραφή
	Το όνομα του καναλιού (π.χ. "agents", "msteams") ή None, εάν δεν είναι διαθέσιμο.

email

Η οντότητα αναφοράς ηλεκτρονικού ταχυδρομείου που αναλύθηκε, εάν υπάρχει.

Επιστροφές

Τύπος	Περιγραφή
	Ένα αντικείμενο EmailReference εάν βρέθηκε μια οντότητα ειδοποίησης ηλεκτρονικού ταχυδρομείου και αναλύθηκε με επιτυχία, διαφορετικά Καμία.

notification_type

Ο τύπος ειδοποίησης που εντοπίστηκε.

Επιστροφές

Τύπος	Περιγραφή
	Η τιμή απαρίθμησης NotificationTypes που υποδεικνύει τον τύπο ειδοποίησης (EMAIL_NOTIFICATION, WPX_COMMENT ή AGENT_LIFECYCLE) ή Καμία, εάν δεν ήταν δυνατή η προσδιορισμός του τύπου ειδοποίησης.

sub_channel

Το αναγνωριστικό υποκαντράλης από το channel_id δραστηριότητας.

Επιστροφές

Τύπος	Περιγραφή
	Το όνομα του υποκαναλικού (π.χ. "email", "word") ή None, εάν δεν είναι διαθέσιμο.

type

Ο τύπος δραστηριότητας.

Επιστροφές

Τύπος	Περιγραφή
	Ο τύπος της δραστηριότητας (π.χ., "μήνυμα", "συμβάν") ή "Κανένα", εάν δεν έχει οριστεί.

value

Το ωφέλιμο φορτίο τιμής από τη δραστηριότητα.

Επιστροφές

Τύπος	Περιγραφή
	Η τιμή της δραστηριότητας, η οποία μπορεί να περιέχει πρόσθετα δεδομένα ειδοποίησης.

wpx_comment

Η οντότητα σχολίου Word/PowerPoint/Excel που έχει αναλυθεί, εάν υπάρχει.

Επιστροφές

Τύπος	Περιγραφή
	Ένα αντικείμενο WpxComment εάν βρέθηκε μια οντότητα σχολίου και αναλυθεί με επιτυχία, διαφορετικά Καμία.

activity

Το υποκείμενο αντικείμενο Activity.