AgentNotificationActivity คลาส

Wrapper รอบออบเจ็กต์กิจกรรมด้วยเอนทิตีการแจ้งเตือนที่พิมพ์

ระดับชั้นนี้ให้การเข้าถึงที่สะดวกในเอนทิตีการแจ้งเตือนที่พิมพ์ซึ่งแยกจากคอลเลกชันเอนทิตีของกิจกรรม ซึ่งจะแยกวิเคราะห์และตรวจสอบการแจ้งเตือนทางอีเมล คํา/PowerPoint/Excel และเหตุการณ์วงจรชีวิตในเวลาที่ก่อสร้างโดยอัตโนมัติ

คอนสตรักเตอร์

AgentNotificationActivity()

พารามิเตอร์

ชื่อ	คำอธิบาย
activity จำเป็น	วัตถุ Activity ที่จะตัดคํา ต้องไม่ใช่ไม่มี

ตัวอย่าง

   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)

พารามิเตอร์

ชื่อ	คำอธิบาย
activity จำเป็น	Activity

__new__

__new__(**kwargs)

as_model

แยกวิเคราะห์ค่ากิจกรรมเป็นชนิดแบบจําลองแบบกําหนดเอง

วิธีนี้เป็นวิธีที่ทั่วไปในการตรวจสอบและแยกวิเคราะห์ส่วนข้อมูลค่าของกิจกรรมลงในชนิดแบบจําลอง Pydantic ใด ๆ มีประโยชน์สําหรับประเภทการแจ้งเตือนแบบกําหนดเองที่ไม่ได้รับการสนับสนุนโดยคุณสมบัติประเภทโดยตรง

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

พารามิเตอร์

ชื่อ	คำอธิบาย
model จำเป็น	Type[<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel>] คลาสแบบจําลอง Pydantic เพื่อตรวจสอบความถูกต้องและแยกวิเคราะห์ค่ากิจกรรมลงใน

การส่งคืน

พิมพ์	คำอธิบาย
<xref:microsoft_agents_a365.notifications.models.agent_notification_activity.TModel> | 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 ของกิจกรรม

การส่งคืน

พิมพ์	คำอธิบาย
	ชื่อช่อง (เช่น 'ตัวแทน', 'msteams') หรือ ไม่มี ถ้าไม่พร้อมใช้งาน

email

เอนทิตีการอ้างอิงอีเมลที่แยกวิเคราะห์ถ้ามี

การส่งคืน

พิมพ์	คำอธิบาย
	วัตถุ EmailReference ถ้าพบเอนทิตีการแจ้งเตือนอีเมลและแยกวิเคราะห์ได้สําเร็จ มิฉะนั้นไม่มี

notification_type

ชนิดการแจ้งเตือนที่ตรวจพบ

การส่งคืน

พิมพ์	คำอธิบาย
	ค่า Enum NotificationTypes ที่ระบุชนิดของการแจ้งเตือน (EMAIL_NOTIFICATION, WPX_COMMENT หรือ AGENT_LIFECYCLE) หรือ ไม่มี ถ้าไม่สามารถกําหนดชนิดการแจ้งเตือนได้

sub_channel

ตัวระบุแชนเนลย่อยจาก channel_id ของกิจกรรม

การส่งคืน

พิมพ์	คำอธิบาย
	ชื่อแชนเนลย่อย (เช่น 'อีเมล', 'word') หรือ ไม่มีถ้าไม่พร้อมใช้งาน

type

ชนิดกิจกรรม

การส่งคืน

พิมพ์	คำอธิบาย
	ชนิดของกิจกรรม (เช่น 'ข้อความ', 'เหตุการณ์') หรือ ไม่มี ถ้าไม่ได้ตั้งค่าไว้

value

ส่วนข้อมูลค่าจากกิจกรรม

การส่งคืน

พิมพ์	คำอธิบาย
	ค่าของกิจกรรม ซึ่งอาจประกอบด้วยข้อมูลการแจ้งเตือนเพิ่มเติม

wpx_comment

เอนทิตีข้อคิดเห็นของ Word/PowerPoint/Excel ที่แยกวิเคราะห์ถ้ามี

การส่งคืน

พิมพ์	คำอธิบาย
	วัตถุ WpxComment ถ้าพบเอนทิตีข้อคิดเห็น และแยกวิเคราะห์ได้สําเร็จ มิฉะนั้น ไม่มี

activity

ออบเจ็กต์กิจกรรมพื้นฐาน