AgentNotificationActivity Classe

Wrapper intorno a un oggetto Activity con entità di notifica tipizzato.

Questa classe consente di accedere facilmente alle entità di notifica tipate estratte dalla raccolta di entità di un'attività. Analizza e convalida automaticamente le notifiche di posta elettronica, i commenti di Word/PowerPoint/Excel e gli eventi del ciclo di vita in fase di costruzione.

Costruttore

AgentNotificationActivity()

Parametri

Nome	Descrizione
activity Necessario	Oggetto Activity di cui eseguire il wrapping. Non deve essere Nessuno.

Esempio

''<<>>python<< async def email_handler(context: TurnContext, state: TurnState, notification: AgentNotificationActivity):

email = notification.email se e-mail:

  print(f"Received email: {email.id}")
  print(f"Body: {email.html_body}")

'''<<>><<

Metodi

__init__

__new__

as_model

Analizzare il valore dell'attività come tipo di modello personalizzato.

Questo metodo fornisce un modo generico per convalidare e analizzare il payload del valore dell'attività in qualsiasi tipo di modello Pydantic. Utile per i tipi di notifica personalizzati non supportati direttamente dalle proprietà tipizzate.

init

__init__(activity: Activity)

Parametri

Nome	Descrizione
activity Necessario	Activity

new

__new__(**kwargs)

as_model

Analizzare il valore dell'attività come tipo di modello personalizzato.

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

Parametri

Nome	Descrizione
model Necessario	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] Classe di modello Pydantic in cui convalidare e analizzare il valore dell'attività.

Valori restituiti

Tipo	Descrizione
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> \| None	Istanza del tipo di modello specificato se la convalida ha esito positivo; in caso contrario, Nessuna.

Esempio

''<<>><<python da pydantic import BaseModel

classe CustomNotification(BaseModel): custom_field: str

notification = AgentNotificationActivity(activity) custom = notification.as_model(CustomNotification) se personalizzato:

print(custom.custom_field)

'''<<>><<

Attributi

channel

Identificatore del canale del channel_id dell'attività.

Valori restituiti

Tipo	Descrizione
	Nome del canale ,ad esempio 'agents', 'msteams') o Nessuno, se non disponibile.

email

Entità di riferimento alla posta elettronica analizzata, se presente.

Valori restituiti

Tipo	Descrizione
	Oggetto EmailReference se è stata trovata e analizzata correttamente un'entità di notifica tramite posta elettronica; in caso contrario, Nessuna.

notification_type

Tipo di notifica rilevato.

Valori restituiti

Tipo	Descrizione
	Valore enumerazione NotificationTypes che indica il tipo di notifica (EMAIL_NOTIFICATION, WPX_COMMENT o AGENT_LIFECYCLE) o Nessuno se non è stato possibile determinare il tipo di notifica.

sub_channel

Identificatore del canale secondario del channel_id dell'attività.

Valori restituiti

Tipo	Descrizione
	Nome del canale secondario (ad esempio, 'email', 'word') o Nessuno, se non disponibile.

type

Tipo di attività.

Valori restituiti

Tipo	Descrizione
	Tipo dell'attività (ad esempio, 'message', 'event') o Nessuno se non impostato.

value

Payload del valore dell'attività.

Valori restituiti

Tipo	Descrizione
	Valore dell'attività, che può contenere dati di notifica aggiuntivi.

wpx_comment

Entità commento di Word/PowerPoint/Excel analizzata, se presente.

Valori restituiti

Tipo	Descrizione
	Oggetto WpxComment se un'entità commento è stata trovata e analizzata correttamente; in caso contrario, Nessuna.

activity

Oggetto Activity sottostante.