AgentNotificationActivity 클래스

형식화된 알림 엔터티가 있는 활동 개체에 대한 래퍼입니다.

이 클래스는 활동의 엔터티 컬렉션에서 추출된 형식화된 알림 엔터티에 편리하게 액세스할 수 있도록 합니다. 생성 시 전자 메일 알림, Word/PowerPoint/Excel 메모 및 수명 주기 이벤트를 자동으로 구문 분석하고 유효성을 검사합니다.

생성자

AgentNotificationActivity()

매개 변수

Name Description
activity
필수

래핑할 활동 개체입니다. None이 아니어야 합니다.

예제


   async def email_handler(
       context: TurnContext,
       state: TurnState,
       notification: AgentNotificationActivity,
   ) -> None:
       email = notification.email
       if email:
           print(f"Received email: {email.id}")
           print(f"Body: {email.html_body}")

메서드

__init__
__new__
as_model

작업 값을 사용자 지정 모델 형식으로 구문 분석합니다.

이 메서드는 작업의 값 페이로드의 유효성을 검사하고 모든 Pydantic 모델 형식으로 구문 분석하는 일반적인 방법을 제공합니다. 형식화된 속성에서 직접 지원되지 않는 사용자 지정 알림 유형에 유용합니다.

__init__

__init__(activity: Activity)

매개 변수

Name Description
activity
필수

__new__

__new__(**kwargs)

as_model

작업 값을 사용자 지정 모델 형식으로 구문 분석합니다.

이 메서드는 작업의 값 페이로드의 유효성을 검사하고 모든 Pydantic 모델 형식으로 구문 분석하는 일반적인 방법을 제공합니다. 형식화된 속성에서 직접 지원되지 않는 사용자 지정 알림 유형에 유용합니다.

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

매개 변수

Name Description
model
필수
Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>]

활동 값의 유효성을 검사하고 구문 분석할 Pydantic 모델 클래스입니다.

반품

형식 Description
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | None

유효성 검사가 성공하면 지정된 모델 형식의 인스턴스입니다. 그렇지 않으면 None입니다.

예제


   from pydantic import BaseModel

   class CustomNotification(BaseModel):
       custom_field: str

   notification = AgentNotificationActivity(activity)
   custom = notification.as_model(CustomNotification)
   if custom:
       print(custom.custom_field)

특성

channel

활동의 channel_id 채널 식별자입니다.

반품

형식 Description

채널 이름(예: 'agents', 'msteams') 또는 None(사용할 수 없는 경우)입니다.

email

구문 분석된 전자 메일 참조 엔터티(있는 경우)입니다.

반품

형식 Description

전자 메일 알림 엔터티를 찾아 성공적으로 구문 분석한 경우 EmailReference 개체이고, 그렇지 않으면 None입니다.

notification_type

검색된 알림 유형입니다.

반품

형식 Description

알림 유형을 확인할 수 없는 경우 알림 유형(EMAIL_NOTIFICATION, WPX_COMMENT 또는 AGENT_LIFECYCLE)을 나타내는 NotificationTypes 열거형 값입니다.

sub_channel

활동의 channel_id 하위 채널 식별자입니다.

반품

형식 Description

하위 채널 이름(예: 'email', 'word') 또는 None(사용할 수 없는 경우)입니다.

type

활동 유형입니다.

반품

형식 Description

활동의 형식(예: 'message', 'event') 또는 None(설정되지 않은 경우)입니다.

value

활동의 값 페이로드입니다.

반품

형식 Description

추가 알림 데이터를 포함할 수 있는 활동의 값입니다.

wpx_comment

구문 분석된 Word/PowerPoint/Excel 주석 엔터티(있는 경우)입니다.

반품

형식 Description

주석 엔터티를 찾아 성공적으로 구문 분석한 경우 WpxComment 개체이고, 그렇지 않으면 None입니다.

activity

기본 활동 개체입니다.