الاتصال بـ AWS Bedrock

فكّر في Amazon Bedrock على أنه آلة بيع ضخمة لنماذج الذكاء الاصطناعي—بدلاً من الوجبات الخفيفة، يقدّم لك نماذج لغوية قوية من Anthropic وMeta وغيرهم، وكل ذلك بطريقة دفع واحدة بسيطة: حساب AWS الخاص بك.

ما الذي ستحتاجه

قبل أن نبدأ، تأكد من أن لديك:

• حساب AWS (الطبقة المجانية تعمل بشكل جيد)
• بيانات اعتماد AWS—هذه مثل بطاقة هويتك. يمكنك استخدام:
  • دور IAM إذا كنت تعمل على EC2/ECS/Lambda (بدون أي إعداد!)
  • متغيرات البيئة AWS_ACCESS_KEY_ID + AWS_SECRET_ACCESS_KEY
  • AWS_PROFILE لتسجيل الدخول الموحد SSO أو الملفات الشخصية المسماة
  • فقط قم بتشغيل aws configure للتطوير المحلي

الخطوة 1: تثبيت Hermes مع دعم Bedrock

افتح الطرفية وشغّل:

cd ~/.hermes/hermes-agent
uv pip install -e ".[bedrock]"

هذا يضيف “الملحق” الخاص بـ Bedrock إلى تثبيت Hermes الخاص بك. اعتبره مثل تثبيت حزمة لغة على هاتفك.

الخطوة 2: أخبر Hermes لاستخدام Bedrock

قم بتشغيل هذا الأمر لاختيار المزوّد:

hermes model

عندما يُطلب منك:

1. اختر “More providers…”
2. حدد “AWS Bedrock”
3. اختر منطقتك (مثل us-east-2)
4. اختر نموذجًا (مثل Claude Sonnet 4)

سيقوم Hermes بحفظ إعداداتك تلقائيًا. سيبدو ملف ~/.hermes/config.yaml الخاص بك شيئًا مثل:

model:
  default: us.anthropic.claude-sonnet-4-6
  provider: bedrock
  base_url: https://bedrock-runtime.us-east-2.amazonaws.com
bedrock:
  region: us-east-2

الخطوة 3: ابدأ الدردشة

hermes chat

هذا كل شيء! أنت الآن تتحدث إلى نموذج عبر AWS Bedrock.

تعيين منطقتك

يمكنك تعيين منطقة AWS الخاصة بك بثلاث طرق (الأولوية القصوى أولاً):

1. أضف region تحت bedrock: في ملف الإعدادات الخاص بك
2. عيّن متغير البيئة AWS_REGION
3. عيّن متغير البيئة AWS_DEFAULT_REGION

إذا لم تقم بتعيينها، فسيستخدم Hermes المنطقة الافتراضية us-east-1.

إضافي: الحواجز الواقية (مرشحات الأمان)

هل تريد إضافة مرشحات محتوى؟ أضف هذا إلى إعداداتك:

bedrock:
  region: us-east-2
  guardrail:
    guardrail_identifier: "abc123def456"  # من وحدة تحكم Bedrock
    guardrail_version: "1"                # أو "DRAFT"
    stream_processing_mode: "async"       # "sync" أو "async"
    trace: "disabled"                     # "enabled", "disabled", "enabled_full"

اكتشاف النماذج

يقوم Hermes تلقائيًا باكتشاف النماذج المتاحة في منطقتك. يمكنك تخصيص أي منها يظهر:

bedrock:
  discovery:
    enabled: true
    provider_filter: ["anthropic", "meta"]

ملخص

ربط AWS Bedrock بـ Hermes يشبه توصيل وحدة تحكم ألعاب جديدة بجهاز التلفزيون—قم بتثبيت برنامج التشغيل، واختر لعبتك، والعب. ستحصل على إمكانية الوصول إلى نماذج من الدرجة الأولى مع أمان وموثوقية AWS.

نصيحة عملية: إذا كنت تعمل على EC2 أو Lambda، فتخطى مفاتيح API تمامًا. فقط قم بإرفاق دور IAM مع صلاحية AmazonBedrockFullAccess وسيكتشفه Hermes تلقائيًا. لا إعدادات، لا عناء—فقط قوة الذكاء الاصطناعي الخالصة.

---