الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

؟ مساعد الطيار openai-todo

يعد هذا المشروع مثالًا على تنفيذ تطبيق Todo، والذي يهدف إلى عرض كيفية استخدام GitHub Copilot لإنشاء تطبيق Todo مدعوم بالذكاء الاصطناعي باستخدام Azure OpenAI وAzure Cosmos DB.

الطلب المكتمل موجود في الفرع المكتمل.

المتطلبات الأساسية

  • Node.js v18+
  • دوكر v20+
  • حساب أزور . إذا كنت جديدًا في Azure، فاحصل على حساب Azure مجانًا للحصول على أرصدة Azure مجانية للبدء.
  • اشتراك Azure مع تمكين الوصول لخدمة Azure OpenAI . يمكنك طلب الوصول باستخدام هذا النموذج.
    • وبدلاً من ذلك، يمكنك استخدام مفتاح OpenAI API بدلاً من خدمة Azure OpenAI.

يمكنك استخدام GitHub Codespaces للعمل على هذا المشروع مباشرة من متصفحك: حدد زر Code ، ثم علامة التبويب Codespaces وانقر على Create Codespaces في الملف الرئيسي .

يمكنك أيضًا استخدام ملحق Dev Containers لـ VS Code للعمل محليًا باستخدام بيئة تطوير جاهزة للاستخدام.

بعد استنساخ المشروع أو فتحه في بيئة التطوير الخاصة بك، قم بتشغيل الأمر التالي لتثبيت التبعيات: 

npm install

تفاصيل المشروع

تم تصميم هذا المشروع على أنه monorepo ويستفيد من مساحات عمل NPM. يتم تنظيمها على النحو التالي: 

.devcontainer/    # Dev container configuration
.github/          # GitHub Actions CI/CD pipeline
packages/         # The different parts of our app
| - server/        # The Express server, hosting the API and the website
+- client/        # The website client
package.json      # NPM workspace configuration

كيفية بناء المشروع 

npm run build

سيقوم هذا الأمر ببناء حزم العميل والخادم.

كيفية إعداد النشر

لتوفير الموارد على Azure ونشر الخدمات، نستخدم Azure Dev CLI. 

 # Only needed once
azd auth login --use-device-code

# Provision and deploy infrastructure
azd up

يمكنك أيضًا توفير البنية الأساسية ونشرها بشكل منفصل: 

 # Provision infrastructure
azd provision

# Deploy infrastructure
azd deploy

كيفية تشغيل محليا

لتشغيل التطبيق محليًا، ستحتاج إلى إعداد متغيرات البيئة التالية في ملف .env في جذر المشروع بالمحتوى التالي: 

AZURE_OPENAI_ENDPOINT= < your Azure OpenAI endpoint >
AZURE_COSMOS_DB_ENDPOINT= < your Azure Cosmos DB endpoint >

نظرًا لأن التطبيق يعتمد على خدمات Azure لإكمال OpenAI وتخزين Cosmos DB، فستحتاج إلى توفير هذه الموارد على Azure أولاً (راجع كيفية إعداد النشر).

ثم قم بتشغيل الأوامر التالية لإنشاء ملف .env الخاص بك: 

azd env get-values > .env

بمجرد أن يصبح ملف .env جاهزًا، يمكنك بدء التطبيق عن طريق تشغيل الأمر التالي في جذر المشروع: 

npm run start

سيؤدي هذا إلى تشغيل كل من العميل والخادم:

  • سيكون العميل متاحًا على http://localhost:4200.
  • سيكون الخادم متاحًا على http://localhost:3000.

المساهمة

يرحب هذا المشروع بالمساهمات والاقتراحات. تتطلب معظم المساهمات منك الموافقة على اتفاقية ترخيص المساهم (CLA) التي تعلن أن لديك الحق في منحنا حقوق استخدام مساهمتك، بل وتفعل ذلك بالفعل. للحصول على التفاصيل، تفضل بزيارة https://cla.opensource.microsoft.com.

عند إرسال طلب سحب، سيحدد روبوت CLA تلقائيًا ما إذا كنت بحاجة إلى تقديم CLA وتزيين العلاقات العامة بشكل مناسب (على سبيل المثال، التحقق من الحالة، التعليق). ما عليك سوى اتباع التعليمات التي يقدمها لك الروبوت. سوف تحتاج إلى القيام بذلك مرة واحدة فقط عبر جميع اتفاقيات إعادة الشراء باستخدام CLA الخاصة بنا.

اعتمد هذا المشروع قواعد السلوك الخاصة بشركة Microsoft مفتوحة المصدر. لمزيد من المعلومات، راجع الأسئلة الشائعة حول قواعد السلوك أو اتصل بـ [email protected] لطرح أي أسئلة أو تعليقات إضافية.

العلامات التجارية

قد يحتوي هذا المشروع على علامات تجارية أو شعارات للمشاريع أو المنتجات أو الخدمات. يخضع الاستخدام المصرح به للعلامات التجارية أو الشعارات الخاصة بشركة Microsoft ويجب أن يتبع إرشادات العلامة التجارية والعلامات التجارية الخاصة بشركة Microsoft. يجب ألا يتسبب استخدام العلامات التجارية أو الشعارات الخاصة بشركة Microsoft في الإصدارات المعدلة من هذا المشروع في حدوث ارتباك أو الإشارة ضمنًا إلى رعاية Microsoft. ويخضع أي استخدام لعلامات تجارية أو شعارات تابعة لجهات خارجية لسياسات تلك الجهات الخارجية.

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل