Install
aspire agent initلمن يناسب
يناسب من يبني تطبيقات Aspire موزعة ويريد أن يتعرف الوكيل أولاً على مساحة العمل ثم يستخدم Aspire CLI بشكل صحيح. المستودع الرسمي هو
https://github.com/microsoft/aspire-skills
يكتب Aspire Skills كـ plugin وskill pack وextension pack لهذا العمل. يريد أن يوجّه الوكيل العمل الشائع إلى مهارات مخصصة بدل ارتجال dotnet أو curl أو Docker أو shell. المادة لا تكتب أي منتج وكيل يجب استخدامه، لذا لا تُكمل قائمة عملاء من عندك.
يناسب التعرف وعرض التنسيق والتشخيص أولاً لا النشر من أول خطوة. في المادة يقوم aspire-deployment بـ Publishes, deploys, and tears down Aspire apps. لا تسلك هذا الطريق في أول محاولة.
أكمل أول محاولة في 3 دقائق
المسار الرئيسي يستخدم Aspire CLI الرسمي، وعند المطالبة تختار ربط agent guidance. لمساحة قائمة استخدم هذا:
aspire agent init
المادة تكتب أيضًا aspire new (إنشاء تطبيق واختيار الإرشاد عند المطالبة) وaspire init (إضافة هيكل Aspire لمستودع قائم واختيار الإرشاد عند المطالبة). أول محاولة تفضّل aspire agent init لأنه Add, update, or reconfigure Aspire guidance in an existing workspace. الشرط المسبق: يستطيع هذا الجهاز أصلًا تشغيل Aspire CLI، والدليل الحالي مساحة Aspire تسمح بإعادة كتابتها. المادة لا تكتب اسم حزمة تثبيت CLI ولا رقم إصدار.
أثر جانبي: يكتب أو يحدّث إعداد الإرشاد في المساحة. أكّد الدليل قبل التنفيذ. بعده انظر أولاً هل يستطيع الوكيل recognize Aspire workspaces ثم قرر تشغيل الموارد. لا تنشر ولا تهدم في هذه الخطوة.
مهمة منخفضة المخاطر: دع مهارة التوجيه العليا aspire تقوم بتأكيد قراءة فقط، مثل هل المساحة معرّفة وهل يُستدعى CLI بشكل صحيح. إن لزم لمس تطبيق قيد التشغيل فاستخدم aspire-monitoring فقط لرؤية logs وtraces وdashboard وtelemetry أو diagnostics ولا تستدعِ aspire-deployment. إشارة النجاح: لم يعد الوكيل يتحول إلى dotnet / curl / Docker / shell مرتجل لإنهاء مهام Aspire هذه. إن لم يوجد CLI فتوقف عند «لا يوجد Aspire CLI على هذا الجهاز» ولا تُنهِ أول محاولة بمثبّت آخر.
حالات الاستخدام
الحالة الأولى: ربط أو تحديث الإرشاد على مساحة قائمة. يقابل aspire agent init وrecognize Aspire workspaces. يناسب من المستودع قائم أصلًا ويريد فقط أن يعمل الوكيل بطريقة Aspire. المادة لا تكتب نص المطالبة ولا أي ملفات وُلدت؛ الحقيقة القابلة للتحقق أن مساحة قائمة يمكنها تحديث guidance. لا تكتب الحالة الأولى كمنشورة أصلًا على السحابة.
الحالة الثانية: بعد التنسيق راقب وشخّص. يقابل aspire-orchestration (Starts, stops, waits for, and manages Aspire resources) وaspire-monitoring (Routes logs, traces, dashboard, telemetry, and diagnostics work). يناسب من الموارد قائمة أصلًا ويريد فقط السجلات أو لوحة المعلومات. المادة لا تكتب عنوان لوحة ولا قواعد تنبيه؛ يجب أن تمر المراقبة بتلك المهارة لا بـ curl مرتجل. تشغيل/إيقاف الموارد له أثر جانبي؛ أكّد أن البيئة تسمح قبل التنفيذ.
حدود الاستخدام
يقوم aspire-init بـ Creates a new Aspire project or adds an Aspire skeleton to an existing repo؛ ويقوم aspireify بعد aspire init بـ Wires an AppHost. هذه تغيّر بنية المستودع؛ لا تعاملها كفحص قراءة فقط. يتضمن aspire-deployment الهدم ويحتاج تأكيدًا إضافيًا. تظهر المادة أيضًا npx skills add microsoft/aspire-skills ومجموعة أوامر /plugin؛ تلك مداخل أخرى. في أول محاولة لا تخلطها مع Aspire CLI في مسار رئيسي واحد ولا تستنتج أن عميلًا واحدًا يملكها حصرًا.