AgentNotification Klasse

__init__(app: Any, known_subchannels: Iterable[str | AgentSubChannel] | None = None, known_lifecycle_events: Iterable[str | AgentLifecycleEvent] | None = None)

Parameter

__new__(**kwargs)

Registrieren Sie einen Handler für Agent-Lebenszyklusereignisbenachrichtigungen.

Dieser Dekorateur registriert eine Handlerfunktion, die aufgerufen wird, wenn Lebenszyklusereignisse auftreten, z. B. Benutzererstellungs-, Lösch- oder Workload-Onboarding-Updates.

on_agent_lifecycle_notification(lifecycle_event: str, **kwargs: Any)

Parameter

Gibt zurück

Beispiele

''<<>><<python @notifications.on_agent_lifecycle_notification("agenticuseridentitycreated") async def handle_user_created(context, state, notification):

print("Neuer Benutzer erstellt")

'''<<>><<

Registrieren Sie einen Handler für Benachrichtigungen aus einem bestimmten Kanal und Unterkanal.

Dieser Dekorateur registriert eine Handlerfunktion, die aufgerufen werden soll, wenn eine Benachrichtigung vom angegebenen Kanal und optionalen Unterkanal empfangen wird. Der Handler erhält einen typierten AgentNotificationActivity-Wrapper.

on_agent_notification(channel_id: ChannelId, **kwargs: Any)

Parameter

Gibt zurück

Beispiele

''<<>><<python aus microsoft_agents.activity import ChannelId

@notifications.on_agent_notification( ChannelId(channel="agents", sub_channel="email")

) async def handle_custom_channel(context, state, notification):

print(f"Received notification on {notification.channel}/{notification.sub_channel}")

'''<<>><<

Registrieren Sie einen Handler für Outlook-E-Mail-Benachrichtigungen.

Dies ist ein Komfortdekoror, der einen Handler für Benachrichtigungen aus dem E-Mail-Unterkanal registriert.

on_email(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>>'<<python @notifications.on_email() async def handle_email(context, state, notification):

email = notification.email wenn E-Mail:

  print(f"Received email: {email.id}")
  # Send a response
  response = EmailResponse.create_email_response_activity(

     "<p>Thank you for your email.</p>"

  )
  await context.send_activity(response)

'''<<>><<

Registrieren Sie einen Handler für Microsoft Excel-Kommentarbenachrichtigungen.

Dies ist ein Komfortdekoror, der einen Handler für Benachrichtigungen aus dem Excel-Unterkanal registriert.

on_excel(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>><<python @notifications.on_excel() async def handle_excel_comment(context, state, notification):

comment = notification.wpx_comment if comment:

  print(f"Received Excel comment: {comment.comment_id}")

'''<<>><<

Registrieren Sie einen Handler für alle Agent-Lebenszyklusereignisbenachrichtigungen.

Dies ist ein Benutzerfreundlichkeitsdekoror, der einen Handler für alle Lebenszyklusereignisse mithilfe des Wildcard-Matchers "*" registriert.

on_lifecycle(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

'''<<>><<python @notifications.on_lifecycle() async def handle_any_lifecycle_event(context, state, notification):

print(f"Lifecycle-Ereignistyp: {notification.notification_type}")

'''<<>><<

Registrieren Sie einen Handler für Microsoft PowerPoint-Kommentarbenachrichtigungen.

Dies ist ein Komfortdekoror, der einen Handler für Benachrichtigungen aus dem PowerPoint-Unterkanal registriert.

on_powerpoint(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>>python<<@notifications.on_powerpoint() async def handle_powerpoint_comment(context, state, notification):

comment = notification.wpx_comment if comment:

  print(f"Received PowerPoint comment: {comment.comment_id}")

'''<<>><<

Registrieren Sie einen Handler für Benutzererstellungslebenszyklusereignisse.

Dies ist ein Benutzerfreundlichkeitsdekoror, der einen Handler speziell für agentische Benutzeridentitätserstellungsereignisse registriert.

on_user_created(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>><<python @notifications.on_user_created() async def handle_user_created(context, state, notification):

print("Neue agentische Benutzeridentität erstellt")

'''<<>><<

Registrieren Sie einen Handler für Benutzerlöschlebenszyklusereignisse.

Dies ist ein Benutzerfreundlichkeitsdekoror, der einen Handler speziell für agentische Benutzeridentitätslöschereignisse registriert.

on_user_deleted(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>>'<<python @notifications.on_user_deleted() async def handle_user_deleted(context, state, notification):

print("Agentic user identity deleted")

'''<<>><<

Registrieren Sie einen Handler für Onboarding-Updateereignisse für die Benutzerarbeitsauslastung.

Dies ist ein Benutzerfreundlichkeitsdekoror, der einen Handler für Ereignisse registriert, die auftreten, wenn der Workload-Onboarding-Status eines Benutzers aktualisiert wird.

on_user_workload_onboarding(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>>'<<python @notifications.on_user_workload_onboarding() async def handle_onboarding_update(context, state, notification):

print("Onboardingstatus der Benutzerarbeitsauslastung aktualisiert")

'''<<>><<

Registrieren sie einen Handler für Microsoft Word-Kommentarbenachrichtigungen.

Dies ist ein Benutzerfreundlichkeitsdekoror, der einen Handler für Benachrichtigungen aus dem Word-Unterkanal registriert.

on_word(**kwargs: Any) -> Callable[[Callable[[TContext, TState, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]

Parameter

Gibt zurück

Beispiele

''<<>>'<<python @notifications.on_word() async def handle_word_comment(context, state, notification):

comment = notification.wpx_comment if comment:

  print(f"Received Word comment: {comment.comment_id}")

'''<<>><<