Panduan Cepat: Menyiapkan dan menjalankan agen sampel JavaScript LangChain

Dalam Mulai Cepat ini, pelajari penyiapan agen JavaScript LangChain yang berfungsi menggunakan alat, pemberitahuan, observabilitas, dan pengujian agen Microsoft Agent 365 menggunakan Agents Playground dan Teams.

Prasyarat

Jika Anda berencana untuk menggunakan Visual Studio Code, Anda harus menginstal .NET. (.NET 8.0 direkomendasikan.)
Node.js (versi 18 atau yang lebih tinggi)
LangChain
Agents playground
Akses ke Npm (Node Package Manager), yang sudah terpasang bersama NodeJS
Akses ke GitHub
Proyek Agen AI yang sudah ada. Mulai cepat ini menggunakan agen sampel Agent 365 dari toolkit agen Microsoft 365 yang juga dikenal sebagai ATK dalam VS Code.
A365 CLI
Autentikasi Identitas Agen

Menyiapkan sampel LangChain + Node.js dari Microsoft 365 Agents Toolkit.

Untuk menyiapkan semuanya, Anda menginstal Microsoft 365 Agents Toolkit di VS Code, membuka galeri sampel, dan membuat kerangka sampel LangChain + Node.js secara lokal sehingga Anda dapat mengonfigurasi dan menjalankannya nanti. Cuplikan layar berikut menampilkan tampilan yang akan muncul selama proses berlangsung.

Buka Visual Studio Code, lalu buka panel EkstensiCtrl+Shift+X.
Di bilah pencarian, ketik "Agents Toolkit".
Anda akan melihat hasilnya seperti yang ditampilkan pada cuplikan layar berikut.
Pilih Microsoft 365 Agents Toolkit.
Pilih Instal.

VS Code menampilkan tampilan detail ekstensi yang mirip dengan:
Setelah diinstal, ikon M365 Agents Toolkit muncul di bilah navigasi kiri.
Pilih ikon tersebut untuk mendapatkan pengalaman selamat datang.

Sekarang Anda akan melihat opsi seperti Buat Agen Deklaratif, Buat Agen/Aplikasi Baru, dan Lihat Sampel, seperti yang ditunjukkan di sini:
Pilih Lihat Sampel.
Dalam daftar sampel, gulir untuk menemukan sampel agen LangChain + Node.js.
Pilih.

Anda akan melihat dua pilihan: Buat (perancah secara lokal) atau Lihat di GitHub.
Pilih Buat.
Saat diminta, pilih folder di komputer Anda di mana sampel akan dibuat. Misalnya: C:\A365-Ignite-Demo

Toolkit membuat sampel LangChain + Node.js ke subfolder (seperti sample_agent) dan kemudian membukanya secara otomatis di VS Code.

Setelah proses scaffolding selesai, Anda sekarang memiliki proyek agen LangChain + Node.js yang sepenuhnya berfungsi di komputer Anda.

Instal paket Agent 365 yang diperlukan

Sebelum menjalankan sampel, buka package.json di proyek Anda dan konfirmasikan bahwa semua dependensi yang diperlukan untuk Agent 365 dan Agent Framework sudah tercantum. Sampel yang dihasilkan oleh Microsoft 365 Agents Toolkit sudah mencantumkan semua entri yang diperlukan.

Setelah Anda meninjau package.json, instal semuanya dengan menjalankan:

npm install

Ini akan mengunduh semua pustaka Agent 365, dependensi Agent framework, komponen hosting, dan dependensi lain yang didefinisikan dalam sampel. Setelah instalasi, pastikan proyek berhasil dibangun dan dijalankan dengan memulai server pengembang.

npm run dev

Menambahkan alat Microsoft 365 (server MCP)

Anda dapat menjelajahi dan mengelola server MCP menggunakan perintah a365 develop di CLI.

Saat bekerja dengan server MCP, Anda dapat:

Menemukan server MCP yang tersedia untuk digunakan
Menambahkan satu atau beberapa server MCP ke konfigurasi agen Anda
Meninjau server MCP yang saat ini dikonfigurasi
Menghapus server MCP yang tidak lagi Anda perlukan

Setelah server MCP ditambahkan, manifes alat pada agen Anda akan diperluas untuk mencakup entri yang mirip dengan:

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

Pelajari cara menambahkan dan mengelola alat

Langganan dan penanganan pemberitahuan

Agen sampel berlangganan semua notifikasi Agent 365 menggunakan onAgentNotification("*") dan mengarahkannya ke satu handler. Handler ini memungkinkan agen untuk merespons kejadian latar belakang atau sistem, bukan hanya pesan langsung dari pengguna.

Pelajari cara memberi notifikasi kepada para agen

Kode berikut menunjukkan bagaimana pemberitahuan dikonfigurasi pada file 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
}

Observabilitas

Cuplikan ini menampilkan perubahan minimal yang diperlukan untuk memungkinkan observabilitas dalam sampel. Cuplikan menginisialisasi SDK Observabilitas Agent 365 dan membungkus setiap pemanggilan agen dalam InferenceScope sehingga input, output, dan metadata dapat ditangkap secara otomatis.

Kode berikut menunjukkan contoh observabilitas yang disederhanakan pada file 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;

}

Cuplikan ini menunjukkan pola inti untuk mengaktifkan observabilitas pada sampel Node.js + LangChain. Untuk penyiapan observabilitas lengkap, lihat Pelajari lebih lanjut tentang observabilitas

Menguji agen

Atur variabel lingkungan yang diperlukan, pilih mode autentikasi, dan mulai agen secara lokal. Anda dapat menguji semuanya secara end-to-end dengan Agents Playground tanpa memerlukan penyewa Microsoft 365, kecuali jika Anda ingin memublikasikan agen dan menggunakannya di aplikasi seperti Teams atau Outlook. Silakan lihat untuk langkah-langkah terperinci dalam Pelajari selengkapnya tentang pengujian untuk mengonfigurasi pengujian agen dengan agents playground.

Ringkasan langkah-langkah pengujian

Tambahkan kunci API dan pengaturan model Anda ke file .env agar sampel dapat terhubung dengan LLM.
Pilih mode autentikasi. Untuk pengembangan lokal, sampel mendukung Agentic Auth dengan memanfaatkan nilai yang berasal dari Blueprint Agen.
Jalankan agen secara lokal agar tersedia untuk alat seperti Agents Playground.
Gunakan Agents Playground untuk menguji pesan, alat, dan notifikasi tanpa menyiapkan penyewa atau menyebarkan apa pun.
Saat Anda siap untuk perilaku dunia nyata, publikasikan penyewa Microsoft 365 dan uji agen di Teams, Outlook, atau permukaan Microsoft 365 lainnya.

Terbitkan agen Anda

Saat agen Anda siap untuk pengalaman Microsoft 365 yang sebenarnya seperti obrolan Teams, pesan Outlook, Word @mentions, Anda publikasikan ke penyewa Microsoft 365. Perintah Agent 365 CLI publishbertanggung jawab atas pengemasan: memperbarui manifes Anda, menggabungkan semuanya, dan mengunggah agen ke pusat admin Microsoft.

Saat proses publikasi, tinjau dan sesuaikan nama, deskripsi, ikon, dan versi agen sebelum menyelesaikan pengunggahan. Setelah dipublikasikan, agen Anda akan terdaftar dan dapat diinstal pada penyewa.

Penting

Setelah agen dipublikasikan, Anda harus mengonfigurasi blueprint agen di Portal Pengembang sebelum membuat instans. Pelajari cara mengonfigurasi blueprint agen di Portal Pengembang

Anda dapat melihat agen yang diterbitkan di sini: https://admin.cloud.microsoft/#/agents/all

Pelajari lebih lanjut tentang alur kerja lengkap dan panduan langkah demi langkah

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2026-07-31