AgentNotification Klass

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

Parametrar

__new__(**kwargs)

Registrera en hanterare för meddelanden om agentens livscykelhändelser.

Den här dekoratören registrerar en hanteringsfunktion som ska anropas när livscykelhändelser inträffar, till exempel uppdateringar av registrering av användare, borttagning eller arbetsbelastning.

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

Parametrar

Returer

Exempel

   @notifications.on_agent_lifecycle_notification("agenticuseridentitycreated")
   async def handle_user_created(context, state, notification):
       print("New user created")

Registrera en hanterare för meddelanden från en specifik kanal och underkanal.

Den här dekoratören registrerar en hanteringsfunktion som ska anropas när ett meddelande tas emot från den angivna kanalen och valfri underkanal. Hanteraren får en typinskriven AgentNotificationActivity-omslutning.

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

Parametrar

Returer

Exempel

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

Registrera en hanterare för e-postaviseringar i Outlook.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för meddelanden från e-postunderkanalen.

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

Parametrar

Returer

Exempel

   @notifications.on_email()
   async def handle_email(context, state, notification):
       email = notification.email
       if email:
           print(f"Received email: {email.id}")
           response = EmailResponse.create_email_response_activity(
               "<p>Thank you for your email.</p>"
           )
           await context.send_activity(response)

Registrera en hanterare för Microsoft Excel-kommentarsaviseringar.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för meddelanden från Excel-underkanalen.

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

Parametrar

Returer

Exempel

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

Registrera en hanterare för alla meddelanden om agentens livscykelhändelser.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för alla livscykelhändelser med jokertecknet "*" matchare.

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

Parametrar

Returer

Exempel

   @notifications.on_lifecycle()
   async def handle_any_lifecycle_event(context, state, notification):
       print(f"Lifecycle event type: {notification.notification_type}")

Registrera en hanterare för Microsoft PowerPoint-kommentarsaviseringar.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för meddelanden från PowerPoint-underkanalen.

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

Parametrar

Returer

Exempel

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

Registrera en hanterare för livscykelhändelser för användarskapande.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare specifikt för händelser för att skapa agentiska användaridentiteter.

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

Parametrar

Returer

Exempel

   @notifications.on_user_created()
   async def handle_user_created(context, state, notification):
       print("New agentic user identity created")

Registrera en hanterare för livscykelhändelser för borttagning av användare.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare specifikt för borttagningshändelser för agentiska användaridentiteter.

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

Parametrar

Returer

Exempel

   @notifications.on_user_deleted()
   async def handle_user_deleted(context, state, notification):
       print("Agentic user identity deleted")

Registrera en hanterare för användararbetsbelastningsregistrering av uppdateringshändelser.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för händelser som inträffar när en användares registreringsstatus för arbetsbelastning uppdateras.

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

Parametrar

Returer

Exempel

   @notifications.on_user_workload_onboarding()
   async def handle_onboarding_update(context, state, notification):
       print("User workload onboarding status updated")

Registrera en hanterare för Microsoft Word-kommentarsaviseringar.

Det här är en bekvämlighetsdekoratör som registrerar en hanterare för meddelanden från Word-underkanalen.

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

Parametrar

Returer

Exempel

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