Amazon Bedrock وAgentCore وSageMaker وQ: الوكلاء في Microsoft Teams

هذا هو دليل قواعد اللعبة FDE (المهندس المنتشر للأمام) للتنفيذ Amazon Bedrock, Amazon Bedrock AgentCore, Amazon SageMaker، و ⟦أق⟧، ثم إطلاق وكلاء في الأعمال التجارية من خلال Microsoft Teams. ويغطي اختيارات الهندسة المعمارية، وإعداد الوكيل الأول الملموس، والأدوات، والتدريب، وتقديرات التقويم لتطبيقات LLM، وRAG، وMLOps.

1. بيان المشكلة للأعمال

لا تحتاج معظم الشركات إلى "شات بوت" آخر. انهم بحاجة الوكلاء الذين يعملون داخل سير العمل الحالي: الإجابة من المعرفة المعتمدة، وأدوات الاتصال ذات الهوية، والاحتفاظ بذاكرة الجلسة، والمكان الذي يتعاون فيه الموظفون بالفعل - عادةً Teams.

تتمثل مهمة FDE في تضييق الفجوة بين مرجع AWS العامل ومرجع طيار محكم: قسم واحد، مجموعة واحدة، أدوات للقراءة في الغالب أولاً، اعتماد قابل للقياس، ثم التوسع.

2. خريطة الخدمة - اختر سطح AWS المناسب

2.1 Amazon Bedrock

• نماذج التأسيس عبر API واحد (Anthropic Claude، وAmazon Nova، وMeta Llama، وCohere، وما إلى ذلك - التوفر حسب المنطقة).
• Guardrails لمرشحات المحتوى، ورفض الموضوع، وتنقيح معلومات تحديد الهوية الشخصية (PII)، وعمليات التحقق من التأريض.
• Knowledge Base لإدارة RAG (الاستقبال من S3 / الموصلات والتضمينات والاسترجاع).
• وكلاء الأساس / التدفقات لأنماط التنسيق عندما تبقى داخل نموذج وكيل Bedrock.

استخدم حجر الأساس عندما: تريد إدارة FM، RAG، والسلامة دون تشغيل وحدات معالجة الرسومات.

2.2 Amazon Bedrock AgentCore

AgentCore هي طبقة وقت تشغيل الإنتاج لـ وكلاء مخصصون (إطار حيادي — Strands، LangGraph، CrewAI، Python مخصص، وما إلى ذلك):

• وقت التشغيل — استدعاءات وكيل معزولة للجلسة وطويلة الأمد.
• بوابة - تحويل واجهات برمجة التطبيقات / MCP / OpenAPI إلى أدوات الوكيل؛ يشمل Microsoft Teams الرسم البياني الأهداف (رسائل القناة، الدردشات، الاجتماعات، التواجد، الاجتماعات عبر الإنترنت).
• الذاكرة — الذاكرة المحادثة/العرضية قصيرة وطويلة المدى.
• الهوية - التحقق من صحة JWT الوارد وOAuth الصادر إلى الأدوات (بما في ذلك Microsoft Entra ID).
• إمكانية الملاحظة - الآثار والمقاييس في مسارات متوافقة مع CloudWatch / OpenTelemetry.

استخدم AgentCore عندما: أنت تمتلك رمز وكيل، وتحتاج إلى أدوات + هوية + ذاكرة، وتريد وقت تشغيل مُدارًا بدلاً من غراء DIY ECS/Lambda لكل المخاوف.

2.3 Amazon SageMaker

• تدريب / تحسين / تقييم النماذج المخصصة.
• نقاط النهاية المضيفة (في الوقت الفعلي، بدون خادم، غير متزامنة).
• خطوط الأنابيب، سجل النماذج، متجر الميزات، التوضيح، مراقبة النموذج لـ MLOps.
• يمكن تغذية النماذج المخصصة في Bedrock Custom Model Import أو الجلوس بجانب Bedrock كنقاط نهاية متخصصة.

استخدم SageMaker عندما: إن أدوات الإدارة المالية الجاهزة ليست كافية (مصنفات النطاق، والتصنيف، والتضمين الدقيق، والحوكمة النموذجية المنظمة).

2.4 ⟦أق⟧

• Amazon Q الأعمال (تستمر تسمية المنتج في التطور نحو حزمة Quick Suite / مساعد المؤسسة) - موصلات إلى SaaS والمعرفة، والأسئلة والأجوبة للموظفين، والمكونات الإضافية.
• Amazon Q المطور - مساعد ترميز IDE / CLI لمنشئي AWS.

استخدم Amazon Q عندما: تريد أ منتج مساعد مع هندسة وكيل مخصص أقل. استخدم AgentCore + Bedrock عندما تحتاج إلى أدوات مخصصة عميقة، أو سير عمل متعدد الخطوات، أو تجربة مستخدم أصلية للفرق يمكنك التحكم فيها.

2.5 مصفوفة القرار

3. البنية المرجعية (وكلاء الأعمال في Teams)

Microsoft Teams (user)
        │  Bot Framework activity
        ▼
Azure Bot Service / Teams channel
        │  HTTPS messaging endpoint
        ▼
AWS Lambda / API Gateway  (Bot adapter + JWT mint)
        │  POST /runtimes/{agentRuntimeArn}/invocations
        │  Header: Authorization Bearer <JWT>
        │  Header: X-Amzn-Bedrock-AgentCore-Runtime-Session-Id: teams-{aad}-{conv}
        ▼
Bedrock AgentCore Runtime  (your agent container / code)
        ├── Bedrock InvokeModel (Claude / Nova / …)
        ├── Knowledge Base retrieve (RAG)
        ├── Guardrails
        ├── AgentCore Memory
        └── AgentCore Gateway tools
              ├── Microsoft Graph (Teams channels / chats)  [Entra OAuth]
              ├── Internal APIs (CRM, ITSM, HR)
              └── MCP / OpenAPI targets
        ▼
CloudWatch / X-Ray / OTel traces  +  audit logs (S3)

قاعدة معرف الجلسة: يجب تعيين سلسلة محادثات Teams واحدة إلى جلسة AgentCore واحدة، على سبيل المثال. teams-{aadObjectId}-{conversationId}، بحيث تظل الذاكرة وسياق الأداة متماسكين.

4. الوكيل الأول متوفر في Teams - خطوة بخطوة

الهدف: أ قراءة في الغالب وكيل المعرفة الداخلي في قناة Teams التجريبية في غضون 3 إلى 6 أسابيع تقريبًا.

المرحلة أ — تأسيس AWS (الأيام 1-5)

1. اختر المنطقة (تأكد من توفر طراز Bedrock + AgentCore + Knowledge Base).
2. تمكين الوصول إلى نموذج Bedrock؛ إنشاء أدوار IAM للاستدلال وKB وAgentCore.
3. إنشاء دلو S3 للمجموعة؛ مزامنة تصدير أو موصل SharePoint/Confluence التجريبي.
4. إنشاء حجر الأساس Knowledge Base + متجر المتجهات؛ تشغيل المزامنة؛ امتحان RetrieveAndGenerate.
5. أرفق Guardrails (رفض ما هو خارج الموضوع، وتنقيح معلومات تحديد الهوية الشخصية، وطلب التأريض حيثما يكون ذلك مدعومًا).

المرحلة ب — الوكيل في AgentCore (الأيام 5-15)

1. وكيل السقالة (Python/TypeScript) باستخدام إطار العمل المفضل لديك أو عينات AWS.
2. يستدعي نموذج السلك إلى Bedrock؛ استرجاع الأسلاك إلى Knowledge Base.
3. حدد 2-3 أدوات فقط (على سبيل المثال، البحث في قاعدة المعارف، والحصول على حالة التذكرة للقراءة فقط، والحصول على ملف تعريف المستخدم).
4. تكوين ذاكرة AgentCore للمحادثة قصيرة المدى.
5. تكوين هوية AgentCore: التحقق من صحة JWT الوارد؛ قم بتسجيل Entra ID كموفر هوية (IdP) لأدوات Microsoft.
6. النشر في وقت التشغيل AgentCore؛ اختبار الدخان /invocations مع حليقة واختبار JWT.
7. تمكين إمكانية الملاحظة؛ تحديد لوحة معلومات CloudWatch (زمن الوصول، الأخطاء، وكلاء الرمز المميز/التكلفة).

المرحلة ج - سطح الفرق (الأيام 10-20، بالتوازي)

1. قم بتسجيل تطبيق Entra ID؛ إنشاء Azure Bot؛ تمكين قناة الفرق.
2. إنشاء حزمة تطبيق Teams (البيان والأيقونات)؛ التحميل الجانبي أو النشر المؤسسي لمجموعة الأمان التجريبية.
3. تنفيذ نقطة نهاية المراسلة (يوصى باستخدام Lambda): محول Bot Framework → تعيين النشاط إلى حمولة AgentCore.
4. نشر هوية المستخدم (معرف كائن AAD، UPN) في مطالبات JWT AgentCore تتوقع الهوية.
5. الرد بنص الوكيل (وAdaptive Cards لاحقًا)؛ التعامل مع مؤشرات الكتابة والأخطاء بأمان.
6. الإصدار التجريبي: قناة واحدة، من 10 إلى 30 مستخدمًا، نموذج التعليقات / تفاعلات الرموز التعبيرية، ساعات عمل FDE أسبوعيًا.

المرحلة د - هاردن (الأيام 15-30)

1. الامتياز الأقل IAM; مدير الأسرار لكلمة مرور / شهادات تطبيق الروبوت.
2. الشبكة: مسارات API خاصة عند الحاجة؛ WAF على نقاط النهاية العامة.
3. البيانات: تصنيف المجموعة؛ حظر أدوات الكتابة عالية الخطورة حتى يتم التحكم في التغيير.
4. مجموعة التقييم: 50-100 سؤال وجواب ذهبي؛ قياس جودة التأريض / الرفض.
5. Runbook: تدوير الأسرار، واستعادة إصدار وقت التشغيل، وتعطيل تطبيق Teams.

الحد الأدنى من الفرق → AgentCore استدعاء الشكل

POST /runtimes/{agentRuntimeArn}/invocations
Authorization: Bearer <jwt>
X-Amzn-Bedrock-AgentCore-Runtime-Session-Id: teams-{aadObjectId}-{conversationId}
Content-Type: application/json

{
  "input": {
    "prompt": "<user message text>",
    "user": { "aadObjectId": "...", "upn": "..." },
    "channel": { "teamId": "...", "channelId": "..." }
  }
}

يعتمد مخطط الحمولة الدقيق على عقد الوكيل الخاص بك - احتفظ بإصداره.

5. AgentCore + Microsoft Graph (الوكلاء الذين يعملون في Teams)

بعيدًا عن "الدردشة في Teams"، يمكن أن تكشف بوابة AgentCore الرسم البياني للفرق العمليات كأدوات (إرسال رسالة القناة، إدارة الدردشات، الاجتماعات، التواجد). تتضمن المتطلبات عادةً ما يلي:

• تطبيق Entra ID مع أذونات الرسم البياني (ابدأ بأقل امتياز؛ موافقة المسؤول).
• AgentCore هوية OAuth عميل Entra.
• هدف البوابة لـ Microsoft Teams / الرسم البياني.
• الإنسان في الحلقة لأي كتابة/إرسال حتى يتم تأسيس الثقة.

FDE التوجيه: السفينة وكيل الدردشة الواردة أولا؛ إضافة إجراءات الرسم البياني الصادرة في تذكرة التغيير الثانية مع قوائم السماح الصريحة (القنوات والفرق وقوالب الرسائل).

6. SageMaker في نفس البرنامج

لا تقم بحظر برنامج Teams التجريبي على SageMaker. قدم SageMaker عندما تحتاج إلى:

• المصنفات الخاصة بالمجال (النية، والإلحاح، واكتشاف معلومات تحديد الهوية الشخصية (PII) خارج نطاق Guardrails).
• عمليات التضمين أو إعادة الترتيب الدقيقة للحصول على جودة RAG.
• تدريب نموذجي منظم مع السجل النموذجي + بوابات الموافقة.
• وظائف الاستدلال الدفعي على مجموعات كبيرة.

هيكل عظمي MLOps نموذجي: SageMaker خطوط الأنابيب → سجل النماذج → نقطة النهاية المرحلية → الكناري → همز؛ المراقبة باستخدام Model Monitor؛ الترويج فقط عبر CI (CodePipeline / GitHub Actions) مع IaC (Terraform / CDK).

7. Amazon Q في نفس البرنامج

• س الأعمال للأسئلة والأجوبة واسعة النطاق للموظفين باستخدام الموصلات المُدارة - غالبًا ما تكون أسرع من RAG المخصص لـ "البحث في الإنترانت".
• مطور س لـ FDE/إنتاجية هندسة النظام الأساسي (IaC، Lambda، CDK).
• النمط: س للاتساع؛ AgentCore وكلاء العمق (سير العمل + الأدوات + Teams UX).

8. المنهج التدريبي FDE (تنفيذ وإطلاق)

إجمالي منحدر FDE: ~2-3 أسابيع من التدريب المركّز + التسليم المزدوج على الطيار الأول.

9. قائمة المتطلبات

الناس

• FDE (وكيل + تكامل)
• مهندس السحابة/المنصة (IAM، الشبكات، IaC)
• مسؤول Microsoft 365 / Entra (موافقة التطبيق، نشر Teams)
• مراجع الأمن / الامتثال
• صاحب العمل + المستخدمين التجريبيين

الحسابات والوصول

• حساب (حسابات) AWS مع Bedrock، AgentCore، S3، CloudWatch؛ اختياري SageMaker / س
• Entra ID المستأجر؛ اشتراك Azure في خدمة Bot
• حقوق مسؤول الفرق لتحميل/الموافقة على التطبيقات

البيانات

• مجموعة تجريبية ذات ملكية واحتفاظ واضحين
• تسميات التصنيف؛ سياسة التعامل مع معلومات تحديد الهوية الشخصية (PII).
• أسئلة التقييم الذهبية

10. قائمة مراجعة الأدوات

11. تقديرات الوقت (بقيادة FDE، إرشادية)

يفترض FDE واحد مركز + منصة بدوام جزئي + توفر مسؤول Entra. أيام التقويم، وليس ساعات العمل وحدها.

12. إطلاق القائمة المرجعية (الأعمال)

1. مالك النشاط التجاري المحدد ومقاييس النجاح (الانحراف، ووقت الإجابة، وCSAT).
2. المجموعة الأمنية التجريبية والقناة؛ ساعات الدعم لـ FDE.
3. اتفاقية مستوى الخدمة لنضارة المحتوى لمزامنة Knowledge Base.
4. مسار الحادث: تعطيل الروبوت، وتدوير الأسرار، والصفحة عند الطلب.
5. تنبيهات ميزانية التكلفة على رموز Bedrock ووقت تشغيل AgentCore.
6. بوابة القرار: التوسيع أو الإيقاف المؤقت أو الإنتاج بعد 4 إلى 6 أسابيع من بيانات الاستخدام.

13. أوضاع الفشل الشائعة

• غليان المحيط: وكيل متعدد + أدوات كتابة + شبكة داخلية كاملة قبل إصدار تجريبي واحد لـ Teams.
• الهوية الأخيرة: بناء الوكيل بدون تصميم Entra/JWT - إعادة العمل عند وصول Teams.
• لا توجد مجموعة ذهبية: لا أستطيع معرفة ما إذا كان RAG قد تحسن بعد تجزئة التغييرات.
• SageMaker مبكر جدًا: يعد تدريب النماذج المخصصة قبل استرجاعها أمرًا جيدًا.
• مفاجأة موافقة المشرف: تم حظر أذونات الفرق/الرسم البياني لأسابيع - ابدأ تشغيل تذاكر Entra في اليوم الأول.

14. الإغلاق

حجر الأساس يمنحك النماذج، RAG، والدرابزين. AgentCore يمنحك وقت تشغيل وكيل الإنتاج مع الذاكرة والهوية والأدوات (بما في ذلك Teams Graph). SageMaker يغطي ML وMLOps مخصص. ⟦أق⟧ يغطي مساعدي الموظفين/المطورين المنتجين. مسار FDE الذي يحقق القيمة بشكل أسرع هو: RAG + Guardrails → AgentCore agent → Teams bot Relay → قياس → توسيع الأدوات - مع SageMaker وQ Business كمسارات متوازية عندما تتطلب حالة الاستخدام ذلك.

نشرت من قبل Workstation - لبرامج التسليم التي تضع الوكلاء في الأماكن التي تعمل فيها الشركة بالفعل.