contoso creative writer
1.0.0
| page_type | اللغات | منتجات | urlfragment | اسم | وصف | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
عينة |
|
| كاتب contoso-creative | مساعد الكتابة الإبداعية - العمل مع الوكلاء الذين يستخدمون PROMPTY (تنفيذ Python) | باستخدام Azure Openai Agent مع Python ، ودمج Bing Search API و Azure AI ، لإنشاء مقالات تستند إلى موضوعات المستخدم والتعليمات. |
افتح نافذة طرفية.
تسجيل الدخول إلى حساب Azure الخاص بك. ستحتاج إلى تسجيل الدخول إلى كل من مطور Azure CLI و Azure CLI:
أنا. أولا مع مطور Azure CLI
azd auth loginالثاني. ثم تسجيل الدخول مع Azure CLI
az login --use-device-codeتوفير الموارد ونشر الرمز:
azd up سيُطلب منك تحديد بعض التفاصيل حول الموارد المنشورة ، بما في ذلك الموقع. كتذكير ، نوصي كندا شرقًا كمنطقة لهذا المشروع. بمجرد اكتمال النشر ، يجب أن تكون قادرًا على التمرير في المحطة الخاصة بك ورؤية عنوان URL الذي تم نشره على التطبيق. يجب أن يبدو مشابهاً لهذا Ingress Updated. Access your app at https://env-name.codespacesname.eastus2.azurecontainerapps.io/ . انتقل إلى الرابط لتجربة التطبيق على الفور!
بمجرد اكتمال الخطوات المذكورة أعلاه ، يمكنك اختبار العينة.
الخيار ذي الصلة هو VS Code Dev Containers ، والتي سيفتح المشروع في رمز VS المحلي باستخدام ملحق حاويات Dev:
ابدأ سطح Docker Desktop (قم بتثبيته إذا لم يتم تثبيته بالفعل)
افتح المشروع:
في نافذة VS Code التي يتم فتحها ، بمجرد ظهور ملفات المشروع (قد يستغرق ذلك عدة دقائق) ، افتح نافذة طرفية.
تثبيت الحزم المطلوبة:
cd src/api
pip install -r requirements.txtبمجرد الانتهاء من هذه الخطوات القفز إلى النشر.
ملاحظة لمستخدمي Windows: إذا كنت لا تستخدم حاوية لتشغيل هذه العينة ، فإن خطاط السنانير لدينا هي حاليًا جميع البرامج النصية Shell. لتوفير هذه العينة بشكل صحيح أثناء عملنا على التحديثات ، نوصي باستخدام Git Bash.
قم بإنشاء مجلد جديد والتبديل إليه في المحطة ، ثم قم بتشغيل هذا الأمر لتنزيل رمز المشروع:
azd init -t agent-openai-python-promptyلاحظ أن هذا الأمر سوف يهيئة مستودع GIT ، لذلك لا تحتاج إلى استنساخ هذا المستودع.
تثبيت الحزم المطلوبة:
cd src/api
pip install -r requirements.txtبمجرد فتح المشروع في مساحات الترميز أو حاويات DEV أو محليًا ، يمكنك نشره على Azure.
تسجيل الدخول إلى حساب Azure الخاص بك. ستحتاج إلى تسجيل الدخول إلى كل من مطور Azure CLI و Azure CLI:
أنا. أولا مع مطور Azure CLI
azd auth loginالثاني. ثم تسجيل الدخول مع Azure CLI
az login --use-device-code إذا كان لديك أي مشاكل مع هذا الأمر ، فقد ترغب أيضًا في تجربة azd auth login --use-device-code .
سيؤدي ذلك إلى إنشاء مجلد تحت .azure/ في مشروعك لتخزين التكوين لهذا النشر. قد يكون لديك العديد من بيئات AZD إذا رغبت في ذلك.
توفير الموارد ونشر الرمز:
azd up يستخدم هذا المشروع gpt-35-turbo-0613 و gpt-4-1106-Preview و gpt-4o-2024-05-13 والذي قد لا يكون متاحًا في جميع مناطق Azure. تحقق من توافر المنطقة الحديثة وحدد منطقة أثناء النشر وفقًا لذلك. نوصي باستخدام كندا الشرقية لهذا المشروع.
بعد تشغيل AZD UP ، قد يتم طرح السؤال التالي أثناء Github Setup :
Do you want to configure a GitHub action to automatically deploy this repo to Azure when you push code changes ?
(Y/n) Y يجب أن تستجيب بـ N ، لأن هذه ليست خطوة ضرورية ، وتستغرق بعض الوقت لإعدادها.
يحتوي مستودع العينة هذا على مجلد وكلاء يتضمن المجلدات الفرعية لكل وكيل. يحتوي كل مجلد وكيل على ملف prompty حيث يتم تعريف prompty للوكيل وملف Python مع الرمز المستخدم لتشغيله. سيساعدك استكشاف هذه الملفات على فهم ما يفعله كل وكيل. يحتوي مجلد الوكيل أيضًا على ملف orchestrator.py يمكن استخدامه لتشغيل التدفق بأكمله وإنشاء مقال. عندما قمت بتشغيل azd up تم تحميل مجموعة من المنتجات إلى متجر Azure AI Search Vector ، تم إنشاء contoso-products Contrects.
لاختبار العينة:
قم بتشغيل تطبيق Web Example محليًا باستخدام خادم Fastapi.
انتقل أولاً إلى مجلد SRC/API
cd ./src/apiقم بتشغيل خادم الويب Fastapi
fastapi dev main.py ملاحظة مهمة : إذا كنت تعمل في مساحات الترميز ، فستحتاج إلى تغيير رؤية منافذ API 8000 و 5173 إلى public PORTS VS Code Terminal الخاصة بك. يجب أن تبدو علامة تبويب المنافذ هكذا:
إذا فتحت رابط الخادم في المتصفح ، فسترى عنوان URL غير موجود ، فهذا لأننا لم ننشئ طريق URL المنزلي في Fastapi. بدلاً من ذلك ، قمنا بإنشاء مسار A /get_article الذي يتم استخدامه لتمرير السياق والتعليمات مباشرة إلى ملف get_article.py الذي يدير سير عمل الوكيل.
(اختياري) لقد أنشأنا واجهة ويب سنقوم بتشغيلها بعد ذلك ، ولكن يمكنك اختبار واجهة برمجة التطبيقات كما هو متوقع من خلال تشغيل هذا في المتصفح:
http://127.0.0.1:8080/get_article?context=Write an article about camping in alaska&instructions=find specifics about what type of gear they would need and explain in detail
بمجرد تشغيل خادم Fastapi ، يمكنك الآن تشغيل تطبيق الويب. للقيام بذلك ، افتح نافذة طرفية جديدة وانتقل إلى مجلد الويب باستخدام هذا الأمر:
cd ./src/webقم بتثبيت حزم العقدة الأولى:
npm installثم قم بتشغيل تطبيق الويب بخادم ويب DEV محلي:
npm run devسيؤدي ذلك إلى تشغيل التطبيق ، حيث يمكنك استخدام مثال سياق وإرشادات للبدء. في صفحة "الفريق الإبداعي" ، يمكنك فحص إخراج كل وكيل من خلال النقر فوقه. يجب أن يبدو التطبيق هكذا:
قم بتغيير التعليمات والسياق لإنشاء مقالة من اختيارك.
لأغراض تصحيح الأخطاء ، قد ترغب في اختبار في بيثون باستخدام منطق أوركسترا
لتشغيل العينة باستخدام منطق Orchestrator فقط ، استخدم الأمر التالي:
cd ./src/api
python -m orchestrator
لتفعيل خادم تتبع Prompty:
export LOCAL_TRACING=true
ثم ابدأ الأوركستور:
cd ./src/api
python -m orchestrator
بمجرد أن تتمكن من رؤية المقالة ، يجب أن يظهر مجلد .runs في ./src/api . حدد هذا المجلد وانقر فوق ملف .tracy فيه. هذا يوضح لك جميع وظائف Python التي تم استدعاؤها من أجل إنشاء المقال. استكشف كل قسم ومعرفة المعلومات المفيدة التي يمكنك العثور عليها.
يستخدم Contoso Creative Conster المقيمين لتقييم جودة استجابة التطبيق. المقاييس الأربعة التي يقيمها المقيمون في هذا المشروع هي التماسك والطلاقة والأهمية والأساس. تم كتابة برنامج evaluate.py مخصص.
cd ./src/api
python -m evaluate.evaluatesrc/api/evaluate/eval_inputs.jsonl .تم إعداد هذا القالب لتشغيل CI/CD عند الضغط على التغييرات إلى الريبو. عند تكوين CI/CD ، ستقوم التقييمات في إجراءات GitHub ثم تنشر تطبيقك تلقائيًا على Push to Main.
لإعداد CI/CD مع إجراءات github على مستودعك ، قم بتشغيل الأمر التالي:
azd pipeline config يستخدم هذا القالب gpt-35-turbo-0613 و gpt-4-1106-Preview و gpt-4o-2024-05-13 والذي قد لا يكون متاحًا في جميع مناطق Azure. تحقق من توافر المنطقة المحدثة وحدد منطقة أثناء النشر وفقًا لذلك
يمكنك تقدير تكلفة بنية هذا المشروع من خلال حاسبة تسعير Azure
ملحوظة
عند تنفيذ هذا القالب ، يرجى تحديد ما إذا كان القالب يستخدم الهوية المدارة أو قبو المفتاح
لقد تمكن هذا القالب من الهوية أو قبو رئيسي مدمج للقضاء على الحاجة للمطورين لإدارة بيانات الاعتماد هذه. يمكن للتطبيقات استخدام الهويات المدارة للحصول على رمز Microsoft Entra دون الحاجة إلى إدارة أي بيانات اعتماد. بالإضافة إلى ذلك ، أضفنا أداة عمل GitHub تقوم بمسح الملفات على البنية التحتية كقائد وإنشاء تقرير يحتوي على أي مشكلات تم اكتشافها. لضمان أفضل الممارسات في ريبوك ، نوصي أي شخص بإنشاء حلول بناءً على قوالبنا ، مما يضمن تمكين إعداد المسح السري لـ Github في Repos.
اعتمد هذا المشروع رمز سلوك المصدر المفتوح Microsoft.
موارد:
لمزيد من المعلومات ، راجع مدونة الشهادة الأسئلة الشائعة أو الاتصال بـ [email protected] مع أي أسئلة أو تعليقات إضافية.
يلي هذا المشروع أدناه إرشادات AI المسؤولة وأفضل الممارسات ، يرجى مراجعتها قبل استخدام هذا المشروع:
