BotFrameworkAdapter الفصل

can_process_outgoing_activity(activity: Activity) -> bool

المعلمات

متابعة محادثة مع مستخدم.

ويتم العثور على و بشكل عام في المعلمة MicrosoftAppId في config.py. :اكتب bot_id: <xref:typing.str> :p aram claims_identity: يطالب الروبوت بهوية :اكتب claims_identity: <xref:botframework.connector.auth.ClaimsIdentity> :p جمهور: :اكتب الجمهور: <xref:typing.str>

async continue_conversation(reference: ConversationReference, callback: Callable, bot_id: str = None, claims_identity: ClaimsIdentity = None, audience: str = None)

المعلمات

المرتجعات

استثناءات

الملاحظات

غالبا ما يشار إلى هذا على أنه الروبوتات تدفق المراسلة الاستباقية لأنها تتيح للروبوت إرسال الرسائل بشكل استباقي إلى محادثة أو مستخدم موجود بالفعل في اتصال. يتم تمكين سيناريوهات مثل إرسال إعلامات أو قسائم إلى مستخدم بواسطة هذه الدالة.

تنفيذ ConnectorClientProvider.create_connector_client.

async create_connector_client(service_url: str, identity: ClaimsIdentity = None, audience: str = None) -> ConnectorClient

المعلمات

المرتجعات

بدء محادثة جديدة مع مستخدم. يستخدم لتوجيه رسالة إلى عضو في مجموعة.

async create_conversation(reference: ConversationReference, logic: Callable[[TurnContext], Awaitable] = None, conversation_parameters: ConversationParameters = None, channel_id: str = None, service_url: str = None, credentials: AppCredentials = None)

المعلمات

المرتجعات

استثناءات

الملاحظات

لبدء محادثة، يجب أن يعرف الروبوت معلومات حسابه ومعلومات حساب المستخدم على تلك القناة. تدعم معظم القنوات بدء محادثة مباشرة (بدون مجموعة) فقط. يحاول المحول إنشاء محادثة جديدة على القناة، ثم يرسل نشاط تحديث محادثة من خلال مسار البرنامج الوسيط الخاص به إلى أسلوب رد الاتصال. إذا تم تأسيس المحادثة مع المستخدمين المحددين، فسيحتوي معرف النشاط على معرف المحادثة الجديدة.

حذف نشاط تم إرساله مسبقا إلى قناة. تجدر الإشارة إلى أن جميع القنوات لا تدعم هذه الميزة.

async delete_activity(context: TurnContext, reference: ConversationReference)

المعلمات

المرتجعات

استثناءات

حذف عضو من المحادثة الحالية.

async delete_conversation_member(context: TurnContext, member_id: str) -> None

المعلمات

المرتجعات

استثناءات

async exchange_token(turn_context: TurnContext, connection_name: str, user_id: str, exchange_request: TokenExchangeRequest) -> TokenResponse

المعلمات

async exchange_token_from_credentials(turn_context: TurnContext, oauth_app_credentials: AppCredentials, connection_name: str, user_id: str, exchange_request: TokenExchangeRequest) -> TokenResponse

المعلمات

استرداد رموز Azure Active Directory المميزة لموارد معينة على اتصال تم تكوينه.

من النشاط في TurnContext. :اكتب user_id: str :p aram oauth_app_credentials: (اختياري) AppCredentials ل OAuth. :اكتب oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_aad_tokens(context: TurnContext, connection_name: str, resource_urls: List[str], user_id: str = None, oauth_app_credentials: AppCredentials = None) -> Dict[str, TokenResponse]

المعلمات

المرتجعات

يسرد أعضاء نشاط معين.

إذا لم يتم تحديد سيتم استخدام معرف الأنشطة الحالي.

async get_activity_members(context: TurnContext, activity_id: str)

المعلمات

المرتجعات

استثناءات

استرداد عضو في محادثة حالية.

async get_conversation_member(context: TurnContext, member_id: str) -> ChannelAccount

المعلمات

المرتجعات

استثناءات

سرد أعضاء محادثة حالية.

async get_conversation_members(context: TurnContext)

المعلمات

المرتجعات

استثناءات

يسرد المحادثات التي شارك فيها هذا الروبوت لخادم قناة معين.

context.activity.serviceUrl :اكتب service_url: str

async get_conversations(service_url: str, credentials: AppCredentials, continuation_token: str = None)

المعلمات

المرتجعات

استثناءات

الملاحظات

يقوم خادم القناة بإرجاع النتائج في الصفحات وستتضمن كل صفحة continuationToken التي يمكن استخدامها لإحضار الصفحة التالية من النتائج من الخادم. إذا اكتملت المهمة بنجاح، تحتوي النتيجة على صفحة لأعضاء المحادثة الحالية. قد يتم استدعاء هذا التحميل الزائد من خارج سياق المحادثة، حيث لا يلزم سوى عنوان URL لخدمة الروبوت وبيانات الاعتماد.

يحصل على ارتباط تسجيل الدخول الخام لإرساله إلى المستخدم لتسجيل الدخول لاسم اتصال.

async get_oauth_sign_in_link(context: TurnContext, connection_name: str, final_redirect: str = None, oauth_app_credentials: AppCredentials = None) -> str

المعلمات

المرتجعات

async get_sign_in_resource_from_user(turn_context: TurnContext, connection_name: str, user_id: str, final_redirect: str = None) -> SignInUrlResponse

المعلمات

async get_sign_in_resource_from_user_and_credentials(turn_context: TurnContext, oauth_app_credentials: AppCredentials, connection_name: str, user_id: str, final_redirect: str = None) -> SignInUrlResponse

المعلمات

استرداد حالة الرمز المميز لكل اتصال تم تكوينه للمستخدم المحدد.

سيرجع Blank حالة الرمز المميز لكافة الاتصالات المكونة. :اكتب include_filter: str :p aram oauth_app_credentials: (اختياري) AppCredentials ل OAuth. :اكتب oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_token_status(context: TurnContext, connection_name: str = None, user_id: str = None, include_filter: str = None, oauth_app_credentials: AppCredentials = None) -> List[TokenStatus]

المعلمات

المرتجعات

يحاول استرداد الرمز المميز لمستخدم في تدفق تسجيل الدخول.

:p aram magic_code" (اختياري) أدخل المستخدم التعليمات البرمجية للتحقق من صحة :str magic_code" str :p aram oauth_app_credentials: (اختياري) AppCredentials ل OAuth. :اكتب oauth_app_credentials: <xref:botframework.connector.auth.AppCredential>

async get_user_token(context: TurnContext, connection_name: str, magic_code: str = None, oauth_app_credentials: AppCredentials = None) -> TokenResponse

المعلمات

المرتجعات

استثناءات

static key_for_app_credentials(app_id: str, scope: str)

المعلمات

static key_for_connector_client(service_url: str, app_id: str, scope: str)

المعلمات

تحليل الطلب والتحقق من صحته :p aram req: :return:

async static parse_request(req)

المعلمات

إنشاء سياق منعطف وتشغيل البنية الأساسية لبرنامج ربط العمليات التجارية لبرنامج وسيط لنشاط وارد.

async process_activity(req, auth_header: str, logic: Callable)

المعلمات

المرتجعات

الملاحظات

تعالج هذه الفئة نشاطا يتلقاه خادم الويب للروبوتات. يتضمن ذلك أي رسائل يتم إرسالها من مستخدم وهو الطريقة التي تدفع ما يشار إليه غالبا باسم الروبوتات تدفق المراسلة التفاعلية. اتصل بهذه الطريقة لإرسال رسالة إلى محادثة بشكل تفاعلي. إذا اكتملت المهمة بنجاح، إرجاع InvokeResponse؛ خلاف ذلك. يتم إرجاع فارغة.

async process_activity_with_identity(activity: Activity, identity: ClaimsIdentity, logic: Callable)

المعلمات

async process_outgoing_activity(turn_context: TurnContext, activity: Activity) -> ResourceResponse

المعلمات

async send_activities(context: TurnContext, activities: List[Activity]) -> List[ResourceResponse]

المعلمات

تسجيل خروج المستخدم باستخدام خادم الرمز المميز.

async sign_out_user(context: TurnContext, connection_name: str = None, user_id: str = None, oauth_app_credentials: AppCredentials = None)

المعلمات

استبدال نشاط تم إرساله مسبقا إلى قناة. تجدر الإشارة إلى أن جميع القنوات لا تدعم هذه الميزة.

async update_activity(context: TurnContext, activity: Activity)

المعلمات

المرتجعات

استثناءات

الملاحظات

إذا تم إرسال النشاط بنجاح، تحتوي نتيجة المهمة على كائن ResourceResponse يحتوي على المعرف الذي عينته القناة المتلقية للنشاط. قبل استدعاء هذه الدالة، قم بتعيين معرف نشاط الاستبدال إلى معرف النشاط لاستبداله.