AgentNotification Luokka

Käsittelijä agenttiilmoituksille Microsoft 365 -sovelluksista.

Tämä luokka tarjoaa koristeita, joilla rekisteröidään käsittelijöitä, jotka vastaavat eri Microsoft 365 -kanavien ja alikanavien ilmoituksiin. Se tukee reititystä kanavan tunnuksen, alikanavan ja elinkaaritapahtumien perusteella.

Konstruktori

AgentNotification()

Parametrit

Nimi	Description
app Pakollinen	Sovellusesiintymä, joka käsittelee reitityt ilmoitukset.
known_subchannels	Tunnistettavien alikanavaen valinnainen iterable. Jos Ei mitään, käyttää oletuksena kaikkia AgentSubChannel-luetteloinnin arvoja. Default value: None
known_lifecycle_events	Valinnainen toistettavissa tunnistetetuille elinkaaritapahtumille. Jos Ei mitään, käyttää oletusarvoisesti kaikkia AgentLifecycleEvent-luetteloinnin arvoja. Default value: None

Esimerkit

   from microsoft_agents.hosting import Application
   from microsoft_agents_a365.notifications import AgentNotification

   app = Application()
   notifications = AgentNotification(app)

   @notifications.on_email()
   async def handle_email(context, state, notification):
       email = notification.email
       if email:
           await context.send_activity(f"Received email: {email.id}")

Menetelmät

__init__
__new__
on_agent_lifecycle_notification	Rekisteröi käsittelijä agentin elinkaaritapahtumailmoituksia varten. Tämä decorator rekisteröi käsittelijän funktion, jota kutsutaan elinkaaritapahtumien tapahtumisen yhteydessä. Tällaisia tapahtumia ovat esimerkiksi käyttäjien luominen, poistaminen tai kuormituksen käyttöönottopäivitykset.
on_agent_notification	Rekisteröi käsittelijä tietyn kanavan ja alikanavan ilmoituksia varten. Tämä decorator rekisteröi käsittelijän funktion, joka kutsutaan, kun ilmoitus vastaanotetaan määritetystä kanavasta ja valinnaisista alikanavaista. Käsittelijä saa kirjoitetun AgentNotificationActivity-kääreen.
on_email	Rekisteröi käsittelijä Outlookin sähköposti-ilmoituksille. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän sähköposti-alikanavan ilmoituksia varten.
on_excel	Rekisteröi käsittelijä Microsoft Excelin kommentti-ilmoituksille. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän Excel-alikanavan ilmoituksia varten.
on_lifecycle	Rekisteröi käsittelijä kaikille agentin elinkaaritapahtumailmoituksille. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän kaikille elinkaaritapahtumille yleismerkkiä *käyttämällä.
on_powerpoint	Rekisteröi käsittelijä Microsoft PowerPointin kommentti-ilmoituksille. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän PowerPoint-alikanavan ilmoituksia varten.
on_user_created	Rekisteröi käsittelijä käyttäjän luomisen elinkaaritapahtumia varten. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän erityisesti asiakaskohtaisten käyttäjätietojen luontitapahtumia varten.
on_user_deleted	Rekisteröi käsittelijä käyttäjän poiston elinkaaritapahtumia varten. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän erityisesti asiakaskohtaisten käyttäjätietojen poistotapahtumia varten.
on_user_workload_onboarding	Rekisteröi käsittelijä käyttäjän kuormituksen perehdytyspäivitystapahtumia varten. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän tapahtumista, jotka ilmenevät, kun käyttäjän kuormituksen perehdytystila päivitetään.
on_word	Rekisteröi käsittelijä Microsoft Wordin kommentti-ilmoituksille. Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän Word-alikanavan ilmoituksia varten.

__init__

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

Parametrit

Nimi	Description
app Pakollinen	Any
known_subchannels	Iterable[str | AgentSubChannel] | None Default value: None
known_lifecycle_events	Iterable[str | AgentLifecycleEvent] | None Default value: None

__new__

__new__(**kwargs)

on_agent_lifecycle_notification

Rekisteröi käsittelijä agentin elinkaaritapahtumailmoituksia varten.

Tämä decorator rekisteröi käsittelijän funktion, jota kutsutaan elinkaaritapahtumien tapahtumisen yhteydessä. Tällaisia tapahtumia ovat esimerkiksi käyttäjien luominen, poistaminen tai kuormituksen käyttöönottopäivitykset.

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

Parametrit

Nimi	Description
lifecycle_event Pakollinen	str Kuunneltava elinkaaritapahtuma. *-parametrin avulla voit yhdistää kaikki elinkaaritapahtumat tai määrittää agentlifecycleEvent-tapahtuman.
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_agent_notification

Rekisteröi käsittelijä tietyn kanavan ja alikanavan ilmoituksia varten.

Tämä decorator rekisteröi käsittelijän funktion, joka kutsutaan, kun ilmoitus vastaanotetaan määritetystä kanavasta ja valinnaisista alikanavaista. Käsittelijä saa kirjoitetun AgentNotificationActivity-kääreen.

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

Parametrit

Nimi	Description
channel_id Pakollinen	ChannelId Kanavan tunnus, joka määrittää kuunneltava kanavan ja valinnaisen alikanavan. Käytä "*"-alikanavaa kaikkien alikanavan kanssa vastaamiseksi.
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_email

Rekisteröi käsittelijä Outlookin sähköposti-ilmoituksille.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän sähköposti-alikanavan ilmoituksia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_excel

Rekisteröi käsittelijä Microsoft Excelin kommentti-ilmoituksille.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän Excel-alikanavan ilmoituksia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_lifecycle

Rekisteröi käsittelijä kaikille agentin elinkaaritapahtumailmoituksille.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän kaikille elinkaaritapahtumille yleismerkkiä *käyttämällä.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_powerpoint

Rekisteröi käsittelijä Microsoft PowerPointin kommentti-ilmoituksille.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän PowerPoint-alikanavan ilmoituksia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_user_created

Rekisteröi käsittelijä käyttäjän luomisen elinkaaritapahtumia varten.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän erityisesti asiakaskohtaisten käyttäjätietojen luontitapahtumia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_user_deleted

Rekisteröi käsittelijä käyttäjän poiston elinkaaritapahtumia varten.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän erityisesti asiakaskohtaisten käyttäjätietojen poistotapahtumia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_user_workload_onboarding

Rekisteröi käsittelijä käyttäjän kuormituksen perehdytyspäivitystapahtumia varten.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän tapahtumista, jotka ilmenevät, kun käyttäjän kuormituksen perehdytystila päivitetään.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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

on_word

Rekisteröi käsittelijä Microsoft Wordin kommentti-ilmoituksille.

Tämä on kätevyyden sisustaja, joka rekisteröi käsittelijän Word-alikanavan ilmoituksia varten.

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

Parametrit

Nimi	Description
**kwargs Pakollinen	Any Sovelluksen add_route -menetelmään välitettyjä muita avainsanaargumentteja.

Palautukset

Tyyppi	Description
Callable[[Callable[[<xref:microsoft_agents_a365.notifications.agent_notification.TContext>, <xref:microsoft_agents_a365.notifications.agent_notification.TState>, AgentNotificationActivity], Awaitable[None]]], Callable[[TurnContext, TurnState], Awaitable[None]]]	Decorator-funktio, joka rekisteröi käsittelijän sovelluksella.

Esimerkit

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