AgentNotification Clase

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

Parámetros

__new__(**kwargs)

Registre un controlador para las notificaciones de eventos del ciclo de vida del agente.

Este decorador registra una función de controlador a la que se llamará cuando se produzcan eventos de ciclo de vida, como la creación de usuarios, la eliminación o las actualizaciones de incorporación de cargas de trabajo.

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

Parámetros

Devoluciones

Ejemplos

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

print("Nuevo usuario creado")

''<<>>'<<

Registre un controlador para recibir notificaciones desde un canal específico y un subcanal.

Este decorador registra una función de controlador a la que se llamará cuando se recibe una notificación desde el canal especificado y un subcanal opcional. El controlador recibirá un contenedor AgentNotificationActivity con tipo.

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

Parámetros

Devoluciones

Ejemplos

''python<<>><< de 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}")

''<<>>'<<

Registre un controlador para las notificaciones por correo electrónico de Outlook.

Este es un decorador de conveniencia que registra un controlador para las notificaciones desde el subcanal de correo electrónico.

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

Parámetros

Devoluciones

Ejemplos

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

email = notification.email si el correo electrónico:

  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)

''<<>>'<<

Registre un controlador para las notificaciones de comentarios de Microsoft Excel.

Este es un decorador de conveniencia que registra un controlador para las notificaciones desde el subcanal de Excel.

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

Parámetros

Devoluciones

Ejemplos

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

comment = notification.wpx_comment si comentario:

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

''<<>>'<<

Registre un controlador para todas las notificaciones de eventos del ciclo de vida del agente.

Este es un decorador de conveniencia que registra un controlador para todos los eventos de ciclo de vida mediante el buscador de coincidencias "*".

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

Parámetros

Devoluciones

Ejemplos

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

print(f"Lifecycle event type: {notification.notification_type}")

''<<>>'<<

Registre un controlador para las notificaciones de comentarios de Microsoft PowerPoint.

Este es un decorador de conveniencia que registra un controlador para las notificaciones desde el subcanal de PowerPoint.

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

Parámetros

Devoluciones

Ejemplos

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

comment = notification.wpx_comment si comentario:

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

''<<>>'<<

Registre un controlador para eventos de ciclo de vida de creación de usuarios.

Este es un decorador de conveniencia que registra un controlador específicamente para eventos de creación de identidades de usuario agente.

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

Parámetros

Devoluciones

Ejemplos

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

print("Nueva identidad de usuario agente creada")

''<<>>'<<

Registre un controlador para eventos de ciclo de vida de eliminación de usuarios.

Este es un decorador de conveniencia que registra un controlador específicamente para eventos de eliminación de identidades de usuario agente.

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

Parámetros

Devoluciones

Ejemplos

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

print("Agentic user identity deleted")

''<<>>'<<

Registre un controlador para eventos de actualización de incorporación de cargas de trabajo de usuario.

Este es un decorador de conveniencia que registra un controlador para eventos que se producen cuando se actualiza el estado de incorporación de carga de trabajo de un usuario.

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

Parámetros

Devoluciones

Ejemplos

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

print("Estado de incorporación de carga de trabajo de usuario actualizado")

''<<>>'<<

Registre un controlador para las notificaciones de comentarios de Microsoft Word.

Este es un decorador de conveniencia que registra un controlador para las notificaciones desde el subcanal de Word.

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

Parámetros

Devoluciones

Ejemplos

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

comment = notification.wpx_comment si comentario:

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

''<<>>'<<