التشغيل السريع: إعداد وتشغيل عامل عينة JavaScript LangChain

في هذا التشغيل السريع، راجع إعداد عامل JavaScript LangChain باستخدام أدوات Agent 365 والإعلامات وإمكانية المراقبة واختبار العامل باستخدام Agents Playground وTeams.

المتطلبات المسبقه

إذا كنت تخطط لاستخدام تعليمة Visual Studio برمجية، فيجب أن يكون لديك .NET مثبتا. (يوصى باستخدام .NET 8.0.)
Node.js (الإصدار 18 أو أعلى)
لانغتشين
ملعب الوكلاء
تم تثبيت الوصول إلى Npm (مدير الحِزَم العقدة) مَعَ NodeJS
الوصول إلى GitHub
هناك مشروع وكيل الذكاء الاصطناعي موجود. يستخدم هذا البدء السريع عامل عينة Agent 365 من مجموعة أدوات عامل Microsoft 365 المعروفة أيضا باسم ATK في VS Code.
A365 CLI
مصادقة هوية العامل

إعداد عينة LangChain + Node.js من مجموعة أدوات Microsoft 365 Agents

للحصول على كل شيء جاهز، يمكنك تثبيت مجموعة أدوات Microsoft 365 Agents في VS Code، وافتح معرض العينات، وقم بدعم عينة LangChain + Node.js محليا حتى تتمكن من تكوينها وتشغيلها لاحقا. تظهر لقطات الشاشة التالية ما يجب أن تتوقع رؤيته أثناء التنقل.

افتح تعليمة Visual Studio برمجية، ثم افتح لوحة ExtensionsCtrl+Shift+X.
في شريط البحث، اكتب "Agents Toolkit".
يجب أن تشاهد النتيجة الموضحة في لقطة الشاشة هنا:
حدد Microsoft 365 Agents Toolkit.
حدد تثبيت.

تظهر VS Code طريقة عرض تفاصيل الملحق مشابهة لـ:
بمجرد التثبيت، تظهر أيقونة M365 Agents Toolkit في شريط التنقل الأيمن.
اختره لفتح تجربة الترحيب.

يجب أن تشاهد الآن خيارات مثل إنشاء عامل تعريفي، إنشاء عامل/تطبيق جديد، و عرض العينات، كما هو موضح هنا:
حدد عرض العينات.
في قائمة العينات، قم بالتمرير للعثور على عينة عامل LangChain + Node.js.
حددها.

سترى خيارين: إنشاء (سقالة محليا) أو عرض على GitHub.
اختر إنشاء.
عند المطالبة، حدد مجلدًا على جهازك حيث يجب إنشاء العينة. على سبيل المثال: C:\A365-Ignite-Demo

تقوم مجموعة الأدوات بدعم عينة LangChain + Node.js في مجلد فرعي (مثل sample_agent) ثم تفتحه تلقائيًا في VS Code.

بمجرد اكتمال إعداد الهيكل، لديك الآن مشروع عميل LangChain + Node.js كامل الوظائف على جهازك

تثبيت حزم Agent 365 المطلوبة

قبل تشغيل النموذج، افتح package.json في مشروعك وتأكد من إدراج جميع التبعيات المطلوبة لـ Agent 365 وAgent framework. تتضمن العينة التي تم إنشاؤها بواسطة مجموعة أدوات Microsoft 365 Agents بالفعل هذه الإدخالات.

بمجرد مراجعة package.json، قم بتثبيت كل شيء عن طريق تشغيل:

npm install

يؤدي هذا إلى سحب جميع مكتبات Agent 365 وتبعيات Agent Framework ومكونات الاستضافة وأي تبعيات أخرى محددة في العينة. بعد التثبيت، تحقق من إنشاء المشروع وتشغيله عن طريق بدء تشغيل خادم التطوير

npm run dev

إضافة أدوات Microsoft 365 (خوادم MCP)

يمكنك استكشاف وإدارة خوادم MCP باستخدام أوامر تطوير a365 في CLI.

عندما تعمل مع أدوات Microsoft MCP، يمكنك:

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

بعد إضافة خوادم MCP، يتوسع بيان أدوات العامل الخاص بك ليشمل إدخالات مشابهة لـ:

{
   "mcpServers": [
      {
         "mcpServerName": "mcp_MailTools",
         "mcpServerUniqueName": "mcp_MailTools",
         "scope": "McpServers.Mail.All",
         "audience": "api://00001111-aaaa-2222-bbbb-3333cccc4444"
      }
   ]
}

تعرف على كيفية إضافة الأدوات وإدارتها

الاشتراك في الإعلامات ومعالجتها

يشترك العامل النموذجي فِي جميع إشعارات Agent 365 باستخدام onAgentNotification("*") ويوجهها إلى معالج واحد. يسمح هذا المعالج للعامل بالتفاعل مع أحداث الخلفية أو النظام، وليس فقط رسائل المستخدم المباشرة.

تعرف على كيفية إعلام العوامل

توضح التعليمة البرمجية التالية كيفية تكوين الإعلام في الملف agent.ts.

constructor() {
   super();

   this.onAgentNotification("agents:*", async(context, state, activity) => {

      await this.handleAgentNotificationActivity(context, state, activity);

   });
}

async handleAgentNotificationActivity(context, state, activity)
{
   await context.sendActivity("Received an AgentNotification!");

   // Add custom handling here
}

Observability

مهم

تستخدم هذه العينة مجموعة SDK قابلية الملاحظة Agent 365 المهجورة. تجنب استخدام هذا النمط لتكامل جديد لإمكانية المراقبة. استخدم توزيعة Microsoft OpenTelemetry بدلا من ذلك.

تقوم القصاصة البرمجية التالية بتهيئة حزمة Observability SDK المهملة فِي Agent 365، وتغلّف كل استدعاء للعامل ضمن ‎ InferenceScope بحيث يمكن التقاط المدخلات والمخرجات وبيانات التعريف تلقائيًا.

تظهر التعليمة البرمجية التالية مثالاً مبسطًا لقابلية الملاحظة في الملف client.ts.

const sdk = ObservabilityManager.configure(b =>
   b.withService('<service-name>', '<version>')
);

sdk.start();

async invokeAgentWithScope(prompt: string) {

   const scope = InferenceScope.start(
      { 
         operationName: InferenceOperationType.CHAT, 
         model: '<llm-name>' 
      },
      { 
         agentId: '<agent-id>', 
         agentName: '<agent-name>', 
         conversationId: '<conv-id>' 
      },
      { tenantId: '<tenant-id>' }
   );

   const response = await this.invokeAgent(prompt);
   scope?.recordInputMessages([prompt]);
   scope?.recordOutputMessages([response]);
   scope?.recordResponseId(`resp-${Date.now()}`);
   return response;

}

تُظهر هذه القصاصة البرمجية نمط حزمة Observability SDK المهملة فِي Agent 365 الذي يستخدمه نموذج Node.js + LangChain. للحصول على إرشادات الإعداد والترحيل الكاملة، راجع وثائق SDK القديمة.

اختبار وكيلك

قم بتعيين متغيرات البيئة المطلوبة، وحدد وضع المصادقة، وابدأ تشغيل العامل محليًا. يمكنك اختبار كل شيء من طرف إلى طرف باستخدام Agents Playground دون الحاجة إلى مستأجر Microsoft 365 إلا إذا كنت تريد نشر العامل واستخدامه في تطبيقات مثل Teams أو Outlook. يُرجى الرجوع للحصول على خطوات مفصلة في معرفة المزيد حول الاختبار لتكوين اختبار العامل في agents playground.

نظرة عامة على خطوات الاختبار

أضف مفاتيح واجهة برمجة التطبيقات وإعدادات النموذج إلى ملفل .env حتى يتمكن النموذج من التحدث إلى LLM.
اختر وضع المصادقة الخاص بك. للتطوير المحلي، تدعم العينة المصادقة القائمة على العاملين باستخدام القيم التي تم إنشاؤها مِنْ Agent Blueprint.
ابدأ تشغيل العامل محليًا، مما يعرضه لأدوات مثل Agents Playground.
استخدم Agents Playground لاختبار الرسائل والأدوات والإعلامات دون إعداد مستأجر أو نشر أي شيء.
عندما تكون مستعدا للسلوك في العالم الحقيقي، انشر مستأجرا Microsoft 365 واختبر العامل داخل Teams أو Outlook أو أسطح Microsoft 365 الأخرى.

نشر الوكيل الخاص بك

عندما يكون وكيلك جاهزا لتجارب Microsoft 365 الفعلية مثل دردشات Teams، Outlook الرسائل، Word @mentions، يمكنك نشره إلى مستأجر Microsoft 365. أمر CLI publish الخاص بالوكيل 365 يتولى التغليف: يقوم بتحديث البيان الخاص بك، ويجمع كل شيء، ويرفع الوكيل إلى مركز إدارة مايكروسوفت.

أثناء النشر، راجع اسم العامل ووصفه وأيقوناته وإصداره وراجعه وخصصه قبل إكمال التحميل. بمجرد النشر، يصبح وكيلك مسجلا وقابلا للتنزيل داخل المستأجر.

مهم

بعد نشر وكيلك، يجب عليك تكوين مخطط الوكيل في بوابة المطورين قبل إنشاء الحالات. تعلم كيفية تكوين مخطط الوكيل في بوابة المطورين

يمكنك عرض الوكلاء المنشورين هنا: https://admin.cloud.microsoft/#/agents/all

الملاحظات

هل كانت هذه الصفحة مفيدة؟

تاريخ آخر تحديث في 2026-10-02