MessageActivityInput Sınıf

Oluşturucu yöntemleriyle ileti etkinlikleri oluşturmak için giriş modeli.

Anahtar sözcük bağımsız değişkenlerinden giriş verilerini ayrıştırarak ve doğrulayarak yeni bir model oluşturun.

[ValidationError][pydantic_core yükseltir. ValidationError] giriş verileri geçerli bir model oluşturacak şekilde doğrulanamıyorsa.

self , alan adı olarak self'e izin vermek için açıkça yalnızca konumsaldır.

Oluşturucu

MessageActivityInput(*, serviceUrl: str | None = None, timestamp: datetime | None = None, locale: str | None = None, localTimestamp: datetime | None = None, channelId: Literal['webchat', 'msteams'] | str | None = None, from_: Account | None = None, conversation: ConversationAccount | None = None, replyToId: str | None = None, entities: List[ClientInfoEntity | MentionEntity | MessageEntity | AIMessageEntity | StreamInfoEntity | CitationEntity | SensitiveUsageEntity | ProductInfoEntity | QuotedReplyEntity | TargetedMessageInfoEntity | UnknownEntity] | None = None, channelData: ChannelData | None = None, type: Literal['message'] = 'message', id: str | None = None, recipient: Account | None = None, text: str | None = None, summary: str | None = None, textFormat: Literal['markdown', 'plain', 'xml'] | None = None, attachmentLayout: AttachmentLayout | None = None, attachments: List[Attachment] | None = None, suggestedActions: SuggestedActions | None = None, deliveryMode: Literal['normal', 'notification', 'expectReplies', 'ephemeral'] | None = None, value: Any | None = None, **extra_data: Any)

Yalnızca Anahtar Sözcük Parametreleri

Name Description
serviceUrl
Default value: None
timestamp
Default value: None
locale
Default value: None
localTimestamp
Default value: None
channelId
Default value: None
from_
Default value: None
conversation
Default value: None
replyToId
Default value: None
entities
Default value: None
channelData
Default value: None
type
Default value: message
id
Default value: None
recipient
Default value: None
text
Default value: None
summary
Default value: None
textFormat
Default value: None
attachmentLayout
Default value: None
attachments
Default value: None
suggestedActions
Default value: None
deliveryMode
Default value: None
value
Default value: None

Yöntemler

add_ai_generated

'Yapay zeka tarafından oluşturuldu' etiketini ekleyin.

add_attachments

İletiye ekler ekleyin.

add_card

İletiye bir kart eki ekleyin.

add_citation

Alıntılar ekleyin.

add_feedback

İleti geri bildirimini etkinleştirin.

add_mention

İletiye bir bahsetme (@mention) ekleyin.

add_quote

Tırnak içinde ileti başvurusu ekleyin ve metne yer tutucu ekleyin. Teams, alıntılanan iletiyi yanıt metninin üzerinde önizleme balonu olarak işler. Metin sağlanırsa, alıntılanan ileti yer tutucusunun sonuna eklenir.

Warning

Çok Yakında

Bu API yakında kullanıma sunulacaktır ve gelecekte değişebilir.

Tanılama: ExperimentalTeamsQuotedReplies

add_stream_final

Akış bilgileri ekleyerek bunu son akış iletisi haline getirebilirsiniz.

add_targeted_message_info

İstem önizlemesi için bir targetedMessageInfo varlığı ekleyin.

Türüne "targetedMessageInfo" sahip bir varlık zaten varsa, bu varlık yeniden eklenmez (ileti başına bir komut istemi önizlemesi).

Varlık eklenirken, istem önizlemesiyle çakışmayı önlemek için tüm quotedReply varlıklar ve eşleşen <quoted messageId="..."/> yer tutucu metinler kaldırılır.

add_text

İletiye metin ekleyin.

get_account_mention

Hesap kimliğine göre bir bahsetme varlığı alın.

is_recipient_mentioned

İletide alıcı hesabından bahsedilip bahsedilmediğini denetleyin.

prepend_quote

Var olan metnin önüne quotedReply varlığını ve yer tutucuyu ekleyin. reply()/quote() tarafından yanıt üstü tırnak için kullanılır.

Warning

Çok Yakında

Bu API yakında kullanıma sunulacaktır ve gelecekte değişebilir.

Tanılama: ExperimentalTeamsQuotedReplies

with_attachment_layout

Birden çok ek için düzen ipucunu ayarlayın.

with_delivery_mode

Etkinlik için teslim modunu ayarlayın.

with_recipient

Alıcıyı ayarlayın.

with_suggested_actions

Etkinlik için önerilen eylemleri ayarlayın.

with_summary

Kanal kartları işleyemezse görüntülenecek metni ayarlayın.

with_text

İletinin metin içeriğini ayarlayın.

with_text_format

Metin alanlarının biçimini ayarlayın.

add_ai_generated

'Yapay zeka tarafından oluşturuldu' etiketini ekleyin.

add_ai_generated() -> Self

add_attachments

İletiye ekler ekleyin.

add_attachments(*attachments: Attachment) -> Self

Parametreler

Name Description
*attachments
Gerekli

Eklenecek ekler

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_card

İletiye bir kart eki ekleyin.

add_card(card: AdaptiveCard) -> Self

Parametreler

Name Description
card
Gerekli

Eklenecek kart eki

content
Gerekli

Kart içeriği

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_citation

Alıntılar ekleyin.

add_citation(position: int, appearance: CitationAppearance) -> Self

Parametreler

Name Description
position
Gerekli
appearance
Gerekli

add_feedback

İleti geri bildirimini etkinleştirin.

add_feedback(mode: Literal['default', 'custom'] = 'default') -> Self

Parametreler

Name Description
mode

"default", Teams'in yerleşik başparmak yukarı/aşağı kullanıcı arabirimini gösterir. "custom" bir ileti/fetchTask çağrısı tetikler, böylece bot kendi görev modülü iletişim kutusunu döndürebilir.

Default value: default

add_mention

İletiye bir bahsetme (@mention) ekleyin.

add_mention(account: Account, text: str | None = None, add_text: bool = True) -> Self

Parametreler

Name Description
account
Gerekli

Bahsedecek hesap

text

Bahsetme için özel metin (varsayılan olarak account.name)

Default value: None
add_text

Bahsetme metninin iletiye eklenip eklenmeyeceği

Default value: True

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_quote

Tırnak içinde ileti başvurusu ekleyin ve metne yer tutucu ekleyin. Teams, alıntılanan iletiyi yanıt metninin üzerinde önizleme balonu olarak işler. Metin sağlanırsa, alıntılanan ileti yer tutucusunun sonuna eklenir.

Warning

Çok Yakında

Bu API yakında kullanıma sunulacaktır ve gelecekte değişebilir.

Tanılama: ExperimentalTeamsQuotedReplies

add_quote(message_id: str, text: str | None = None) -> Self

Parametreler

Name Description
message_id
Gerekli

Alıntıya alınacak iletinin kimliği

text

alıntılanan ileti yer tutucusunun sonuna eklenen isteğe bağlı metin

Default value: None

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_stream_final

Akış bilgileri ekleyerek bunu son akış iletisi haline getirebilirsiniz.

add_stream_final() -> Self

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_targeted_message_info

İstem önizlemesi için bir targetedMessageInfo varlığı ekleyin.

Türüne "targetedMessageInfo" sahip bir varlık zaten varsa, bu varlık yeniden eklenmez (ileti başına bir komut istemi önizlemesi).

Varlık eklenirken, istem önizlemesiyle çakışmayı önlemek için tüm quotedReply varlıklar ve eşleşen <quoted messageId="..."/> yer tutucu metinler kaldırılır.

add_targeted_message_info(message_id: str) -> Self

Parametreler

Name Description
message_id
Gerekli

Hedeflenen iletinin ileti kimliği.

Döndürülenler

Tür Description

Yöntem zincirleme için self

add_text

İletiye metin ekleyin.

add_text(text: str) -> Self

Parametreler

Name Description
text
Gerekli

Eklenecek metin

Döndürülenler

Tür Description

Yöntem zincirleme için self

get_account_mention

Hesap kimliğine göre bir bahsetme varlığı alın.

get_account_mention(account_id: str) -> MentionEntity | None

Parametreler

Name Description
account_id
Gerekli

Aranacak hesap kimliği

Döndürülenler

Tür Description

Bulunursa bahsetme varlığı, aksi takdirde Hiçbiri

is_recipient_mentioned

İletide alıcı hesabından bahsedilip bahsedilmediğini denetleyin.

is_recipient_mentioned() -> bool

Döndürülenler

Tür Description

Alıcıdan bahsediliyorsa True

prepend_quote

Var olan metnin önüne quotedReply varlığını ve yer tutucuyu ekleyin. reply()/quote() tarafından yanıt üstü tırnak için kullanılır.

Warning

Çok Yakında

Bu API yakında kullanıma sunulacaktır ve gelecekte değişebilir.

Tanılama: ExperimentalTeamsQuotedReplies

prepend_quote(message_id: str) -> Self

Parametreler

Name Description
message_id
Gerekli

Alıntıya alınacak iletinin IC3 ileti kimliği

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_attachment_layout

Birden çok ek için düzen ipucunu ayarlayın.

with_attachment_layout(attachment_layout: AttachmentLayout) -> Self

Parametreler

Name Description
attachment_layout
Gerekli

Ek düzeni (liste, döngü)

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_delivery_mode

Etkinlik için teslim modunu ayarlayın.

with_delivery_mode(delivery_mode: Literal['normal', 'notification', 'expectReplies', 'ephemeral']) -> Self

Parametreler

Name Description
delivery_mode
Gerekli

Teslim modu (normal, bildirim)

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_recipient

Alıcıyı ayarlayın.

with_recipient(value: Account, is_targeted: bool | None = None) -> Self

Parametreler

Name Description
value
Gerekli

Alıcı hesabı

is_targeted

True ise, bunu yalnızca bu alıcı tarafından görünen hedeflenen bir ileti olarak işaretler. False ise, hedeflemeyi açıkça temizler. Hiçbiri (varsayılan) ise, mevcut is_targeted değeri değişmeden bırakılır.

Default value: None

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_suggested_actions

Etkinlik için önerilen eylemleri ayarlayın.

with_suggested_actions(suggested_actions: SuggestedActions) -> Self

Parametreler

Name Description
suggested_actions
Gerekli

Önerilen eylemler

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_summary

Kanal kartları işleyemezse görüntülenecek metni ayarlayın.

with_summary(summary: str) -> Self

Parametreler

Name Description
summary
Gerekli

Özet metin

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_text

İletinin metin içeriğini ayarlayın.

with_text(text: str) -> Self

Parametreler

Name Description
text
Gerekli

Ayarlanacağı metin

Döndürülenler

Tür Description

Yöntem zincirleme için self

with_text_format

Metin alanlarının biçimini ayarlayın.

with_text_format(text_format: Literal['markdown', 'plain', 'xml']) -> Self

Parametreler

Name Description
text_format
Gerekli

Metin biçimi (markdown, düz, xml)

Döndürülenler

Tür Description

Yöntem zincirleme için self

Öznitelikler

model_config

Modelin yapılandırması [ConfigDict][pydantic.configile uyumlu bir sözlük olmalıdır. ConfigDict].

model_config: ClassVar[ConfigDict] = {'alias_generator': AliasGenerator(alias=None, validation_alias=<staticmethod(<function CustomBaseModel.validation_alias_generator>)>, serialization_alias=<staticmethod(<function CustomBaseModel.serialization_alias_generator>)>), 'arbitrary_types_allowed': True, 'extra': 'allow', 'populate_by_name': True, 'serialize_by_alias': True, 'validate_by_alias': True, 'validate_by_name': True}