قم بتوصيل Amazon Bedrock بـ Microsoft Agent 365

استخدم هذا الدليل لربط Amazon Bedrock Agents Classic أو Amazon Bedrock AgentCore ب Microsoft Agent 365.

قَبلَ البدء

• تأكد من أن مسؤول الذكاء الاصطناعي في Agent 365 يمكنه إنشاء الاتصالات في مركز مسؤولي Microsoft 365.
• اطلب من مسؤول المنصة معرف مفتاح الوصول AWS ومفتاح وصول سري.
• حدد مناطق AWS التي تحتوي على العوامل التي تريد مزامنتها.
• امنح فقط الأذونات المطلوبة للبيئات التي تستخدمها.

الأذونات المطلوبة للمزامنة

بالنسبة للعبة Agents Classic، امنح:

bedrock:ListAgents
bedrock:GetAgent
ec2:DescribeRegions

بالنسبة ل AgentCore، امنح:

bedrock-agentcore:ListHarnesses
bedrock-agentcore:GetHarness
bedrock-agentcore:ListAgentRuntimes
bedrock-agentcore:GetAgentRuntime
ec2:DescribeRegions

bedrock:ListAgents وتكتشف عمليات قائمة AgentCore الوكلاء في المناطق المختارة. اقرأ عمليات التأمين على تفاصيل الوكيل. يتم تخطي أوقات تشغيل AgentCore الْتي تنتمي إلى الْحزام بحيث لا يتم إدراج الْوكيل مرتين.

تكوين نشاط أمازون بيدروك كلاسيك

لجمع الأنشطة من Agents Classic:

1. مكّن التقاط التتبع لكل وكيل في وحدة تحكم Amazon Bedrock.
2. اختر سلك نشاط S3.
3. تخزين النشاط ضمن observability-store/<agent-id>/، حيث إن <agent-id> هو معرّف وكيل Bedrock.
4. غرانت s3:ListBucket في دلو الْنشاط.
5. منح s3:GetObject على الْأشياء في دلو الْنشاط.

Agent 365 يقرأ الْنشاط. لا يستدعي وكلاء، ولا يكتب سجلات النشاط، ولا يحذف سجلات النشاط.

إذا كان الدلو يستخدم مفتاحًا يديره العميل، فامنح kms:Decrypt أيضًا إذن الوصول إلى ذلك المفتاح.

تكوين نشاط Amazon Bedrock AgentCore

يتم تخزين نشاط AgentCore في سجلات أمازون كلاودووتش. منحة:

logs:StartQuery
logs:GetQueryResults

امنح logs:DescribeLogGroups للسماح لـ Agent 365 بالعثور على نقاط النهاية المخصصة للوكيل. بدونه، يقرأ فقط نقطة النهاية الافتراضية.

قم بتمكين بحث المعاملات في وحدة تحكم Amazon CloudWatch. يمكن الاستعلام عن نشاط AgentCore فقط بعد تفعيل بحث المعاملات لحساب AWS.

الأذونات الاختيارية

امنح هذه الأذونات فقط عندما يحتاج الاتصال إلى التفاصيل المقابلة:

القدرة	الأذونات
اعرض أدوات كلاسيك، والمتعاونين، ومصادر المعرفة	bedrock:ListAgentActionGroups، bedrock:GetAgentActionGroup، bedrock:ListAgentCollaborators، bedrock:ListAgentKnowledgeBases، ، bedrock:ListDataSourcesbedrock:GetDataSource
أدوات Show AgentCore، خوادم MCP، والوكلاء المتصلين	bedrock-agentcore:GetGateway، bedrock-agentcore:ListGatewayTargets، bedrock-agentcore:GetGatewayTarget
ربط كل حساب في مؤسسة AWS	organizations:ListAccounts، sts:AssumeRole

لا تمنح أذونات الحذف لاتصال للقراءة فقط. إذا منحت bedrock:DeleteAgent، bedrock-agentcore:DeleteHarnessأو bedrock-agentcore:DeleteAgentRuntime، يمكن للوكيل 365 إزالة الوكيل المقابل عندما يقوم المسؤول بذلك الإجراء بشكل صريح.

إنشاء الاتصال

1. افتح مركز إدارة Microsoft 365.
2. حدد الوكلاء>جميع الوكلاء.
3. في المنصات المتصلة، اختر الإدارة.
4. اختر + ربط منصة واختر Amazon Bedrock.
5. أدخل اسم الاتصال، معرف مفتاح الوصول في AWS، مفتاح الوصول السري، والمناطق المختارة.
6. تحقق من بيانات الاعتماد.
7. حفظ اتصال.
8. اختر وكلاء التزامن.

التحقق من الاتصال

افتح الاتصال وتحقق من حالة المزامنة وعدد الوكلاء. افتح وكيلا مستوردا للتحقق من بياناته الوصفية. لإمكانية الملاحظة، افتح الوكيل واختر النشاط بعد تكوين منصة المصدر وتوفر النشاط.

Troubleshoot

عَرَض	السبب المحتمل	القرار
فشل التحقق من صحة الاتصال	بيانات الاعتماد المفقودة ec2:DescribeRegionsأو غير صالحة أو معطلة	أكّد بيانات الاعتماد وامنح ec2:DescribeRegions.
الوكلاء لديهم بيانات وصفية محدودة	bedrock:GetAgent مفقود أو عملية get الخاصة بـ AgentCore مفقودة	امنح الْإذن الْمناسب.
الوكلاء الكلاسيكيون ليس لديهم أي نشاط	التقاط التتبّع بشكل غير صحيح، أو موقع الحاوية، أو مسار الحاوية، أو أذونات S3	تفعيل الْتقاط الْتتبع وتحقق مِنْ صلاحيات الْدلو والْكائن.
وكلاء AgentCore ليس لديهم أي نشاط	أذونات البحث عن المعاملات أو سجلات كلاودواتش مفقودة	تفعيل البحث عن المعاملات ومنح logs:StartQuery و logs:GetQueryResults.
نشاط AgentCore غير مكتمل	مفقود logs:DescribeLogGroups	امنح الإذن عند استخدام نقاط نهاية مخصصة.

لمشاكل الاتصال التي ليست خاصة ب Amazon Bedrock، راجع استكشاف أخطاء المنصات المتصلة.