create-env-file.md

إنشاء ملف .env في الدليل الجذري

في هذا الدرس، سنرشدك خلال إعداد متغيرات البيئة الخاصة بك لخدمات Azure باستخدام ملف .env. تتيح لك متغيرات البيئة إدارة بيانات الاعتماد الحساسة بأمان، مثل مفاتيح API، دون تضمينها مباشرة في قاعدة الشفرة الخاصة بك.

Important

• يلزم تكوين خدمة نموذج لغة واحدة فقط (Azure OpenAI أو OpenAI). املأ متغيرات البيئة للخدمة التي تفضلها. إذا تم تعيين متغيرات بيئة لعدة نماذج لغوية، سيختار المترجم التعاوني واحدة بناءً على الأولوية.
• إذا لم يتم تعيين متغيرات بيئة Computer Vision، سيقوم المترجم بالتبديل تلقائيًا إلى وضع Markdown فقط.

Note

يركز هذا الدليل أساسًا على خدمات Azure، ولكن يمكنك اختيار أي نموذج لغة مدعوم من قائمة النماذج والخدمات المدعومة.

إنشاء ملف .env

في الدليل الجذري لمشروعك، أنشئ ملفًا باسم .env. سيخزن هذا الملف جميع متغيرات البيئة بتنسيق بسيط.

Warning

لا تقم بإضافة ملف .env إلى أنظمة التحكم في الإصدارات مثل Git. أضف .env إلى ملف .gitignore لمنع الالتزامات العرضية.

1. انتقل إلى الدليل الجذري لمشروعك.

2. أنشئ ملف .env في الدليل الجذري لمشروعك.

3. افتح ملف .env والصق القالب التالي:

   # Azure Credentials
   AZURE_AI_SERVICE_API_KEY="your_azure_ai_service_api_key"
   AZURE_AI_SERVICE_ENDPOINT="https://your_azure_ai_service_endpoint"
   
   # Optional fallback set example (index 1)
   AZURE_AI_SERVICE_API_KEY_1="your_azure_ai_service_api_key_1"
   AZURE_AI_SERVICE_ENDPOINT_1="https://your_azure_ai_service_endpoint_1"
   
   # Azure OpenAI Credentials
   AZURE_OPENAI_API_KEY="your_azure_openai_api_key"
   AZURE_OPENAI_ENDPOINT="https://your_azure_openai_endpoint"
   AZURE_OPENAI_MODEL_NAME="your_model_name"
   AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="your_deployment_name"
   AZURE_OPENAI_API_VERSION="your_api_version"
   
   # Optional fallback sets: duplicate the full AZURE_OPENAI_* set with suffix _1/_2 (same index for all variables)
   
   # OpenAI Credentials
   OPENAI_API_KEY="your_openai_api_key"
   OPENAI_ORG_ID="your_openai_org_id"
   OPENAI_CHAT_MODEL_ID="your_chat_model_id(ex. gpt-4o)"
   OPENAI_BASE_URL="https://api.openai.com/v1 (If you don't have a custom base URL, you can delete this lin, then it will use the default base URL)"
   
   # Optional fallback sets: duplicate the full OPENAI_* set with suffix _1/_2 (same index for all variables)
   

Note

إذا كنت تريد العثور على مفاتيح API ونقاط النهاية الخاصة بك، يمكنك الرجوع إلى set-up-azure-ai.md.

---

تنويه: تمت ترجمة هذا المستند باستخدام خدمة الترجمة الآلية Co-op Translator. بينما نسعى للدقة، يرجى العلم أن الترجمات الآلية قد تحتوي على أخطاء أو عدم دقة. يجب اعتبار المستند الأصلي بلغته الأصلية المصدر الموثوق. للمعلومات الحساسة، يُنصح بالاستعانة بالترجمة البشرية الاحترافية. نحن غير مسؤولين عن أي سوء فهم أو تفسير ناتج عن استخدام هذه الترجمة.