يشرح هذا الدليل كيفية إعداد مفاتيح واجهة برمجة التطبيقات (API keys) لـ Amazon Bedrock لتمكين ميزات Discourse AI التي تتطلب مفاتيح نماذج لغوية كبيرة (LLM) من جهات خارجية.
مستوى المستخدم المطلوب: المشرف (Administrator)
في هذا المثال، نستخدم Amazon Bedrock لتوليد المفاتيح.
ملاحظة: ستحتاج إلى خطة مدفوعة ومفاتيح واجهة برمجة التطبيقات (API keys) مُعدّة.
قد تتغير المنصات باستمرار، لذا قد لا يعكس هذا الدليل العملية بنسبة 100%.
الحصول على مفاتيح واجهة برمجة التطبيقات (API keys)
إعداد المفاتيح على Amazon Bedrock أكثر تعقيدًا بعض الشيء مقارنة بمعظم المزوّدين الآخرين. من المرجح أن تحتاج إلى الإلمام بمفاهيم مثل أدوار IAM وما إلى ذلك. توجد تعليمات حول كيفية الحصول على المفاتيح في:
ما هي نماذج Bedrock التي يدعمها Discourse AI؟
يدعم Discourse AI جميع نماذج Anthropic Claude وجميع نماذج اللغة Nova (Micro / Lite و Pro).
تدعم هذه النماذج الصور والفيديو واستدعاء الأدوات (xml و native).
إليك بعض معرفات النماذج الرئيسية:
Nova:
- amazon.nova-pro-v1:0
- amazon.nova-lite-v1:0
- amazon.nova-micro-v1:0
Claude:
- anthropic.claude-sonnet-4-6
- anthropic.claude-opus-4-6-v1
- anthropic.claude-haiku-4-5-20251001-v1:0
- والعديد غيرها
للحصول على القائمة الكاملة والمحدّثة لمعرفات نماذج Claude المدعومة، راجع طريقة bedrock_model_id في كود المصدر. علاوة على ذلك، سيتم تمرير أي اسم نموذج غير مُعَرَّف صراحة كما هو، مما يتيح لك استخدام معرفات النماذج الأحدث مباشرة.
تذكّر أن ليس جميع النماذج متاحة في جميع المناطق؛ تحقق من صفحة إعدادات Bedrock الخاصة بك.
استخدام مفاتيح واجهة برمجة التطبيقات (API keys) لـ Discourse AI
- انتقل إلى
Admin→Plugins→AI→ علامة التبويبLLMs. - انقر على زر Set up بجانب “Manual configuration”.
- أدخل جميع إعدادات النموذج:
يدعم Discourse AI طريقتين للمصادقة على Bedrock:
- مفاتيح الوصول الثابتة: قدم مفتاح واجهة برمجة التطبيقات (المفتاح السري)، ومعرف مفتاح الوصول، والمنطقة.
- المصادقة القائمة على دور IAM: قدم معرف دور (Role ARN) والمنطقة. تستخدم هذه الطريقة AWS STS AssumeRole لتدوير بيانات الاعتماد تلقائيًا.
يجب عليك إعداد إما معرف مفتاح الوصول أو معرف دور (Role ARN) (بالإضافة إلى المنطقة) للمصادقة.
يمكنك استخدام OpenAiTokenizer كـ مُجزِّئ (tokenizer) لنماذج Nova، واستخدام AnthropicTokenizer لنماذج Claude.
هل يجب علي تعطيل دعم الأدوات الأصلية أم لا؟
يتم توفير Discourse مع تكوينات تعتمد على الأدوات الأصلية وأدوات XML. في بعض الحالات، تتفوق أدوات XML على تنفيذ الأدوات الأصلية؛ لذا يجب عليك التجربة لمعرفة أي التكوينات يعمل بشكل أفضل بالنسبة لك.