Mulai Cepat: Menyiapkan dan menjalankan agen sampel JavaScript Claude Agent SDK

Dalam Mulai Cepat ini, pelajari penyiapan agen JavaScript Claude yang berfungsi menggunakan alat, pemberitahuan, observabilitas, dan pengujian agen 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)
Paket Claude Agent SDK dan kunci API Anthropic
Agents playground
Akses ke instalasi npm (Node Package Manager)
Akses ke GitHub
Proyek Agen AI yang sudah ada. Mulai cepat ini menggunakan agen sampel Claude dari galeri Microsoft 365 Agents Toolkit (ATK dalam VS Code).
A365 CLI
Autentikasi Identitas Agen

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

Untuk menyiapkan semuanya, instal Microsoft 365 Agents Toolkit di VS Code, buka galeri sampel, dan lakukan scaffolding sampel Claude + Node.js secara lokal sehingga Anda dapat mengonfigurasi dan menjalankannya nanti. Cuplikan layar di bawah ini menampilkan apa yang akan Anda temui selama alurnya berlangsung.

Di Visual Studio Code, buka panel Ekstensi (Ctrl+Shift+X), cari Microsoft 365 Agents Toolkit, dan pilih Instal.
Buka tampilan M365 Agents Toolkit dari Bilah Aktivitas VS Code dan pilih Lihat Sampel.
Pilih sampel Claude + Node.js, pilih Buat, dan pilih (atau buat) folder tempat proyek harus di scaffolding (misalnya, C:\A365-Ignite-Demo). Toolkit membuat subfolder (seperti sample_agent) dan membukanya di VS Code.

Setelah scaffolding selesai, Anda memiliki proyek siap dijalankan. Langkah-langkah selanjutnya dilakukan dalam folder sampel yang baru.

Instal dependensi dan konfigurasi lingkungan

package.json yang dihasilkan sudah mencantumkan paket sampel yang diperlukan oleh contoh ini, jadi instal semuanya sekaligus:

npm install

Setelah instalasi, pastikan proyek berhasil dibangun dan dijalankan dengan memulai server pengembang.

npm run dev

Server pengembangan mendengarkan port yang dikonfigurasi dalam sampel (localhost:3978 secara default) dan siap menerima permintaan dari Agents Playground atau CLI.

Menambahkan alat Microsoft 365 (server MCP)

Anda dapat menjelajahi dan mengelola server MCP menggunakan perintah a365 develop di CLI. Paket @microsoft/agents-a365-tooling-extensions-claude menyambungkan server MCP ini ke orkestrator Claude Anda sehingga Agent SDK dapat memanfaatkan alat Microsoft 365 secara langsung sesuai dengan keterampilan yang didefinisikan dalam rencana agen Claude Anda.

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. Perbarui src/client.ts untuk menginisialisasi SDK Observabilitas Agent 365 dan mengemas setiap pemanggilan agen dalam sebuah InferenceScope supaya input, output, dan metadata bisa tercatat secara otomatis.

import {
  InferenceOperationType,
  InferenceScope,
  ObservabilityManager
} from '@microsoft/agents-a365-observability';

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;
}

Kode ini adalah konfigurasi observabilitas lengkap yang diperlukan untuk sampel Node.js + Claude. Ganti metadata tempat penampung dengan nilai yang sudah Anda konfigurasikan untuk agen. Pelajari selengkapnya 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.

Ringkasan langkah-langkah pengujian

Tambahkan ANTHROPIC_API_KEY dan pengaturan model ke file .env agar sampel dapat berkomunikasi dengan Claude.
Pilih mode autentikasi. Untuk pengembangan lokal, sampel mendukung Agentic Authentication menggunakan nilai yang dibuat dari Agent Blueprint Anda.
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.

Pelajari selengkapnya tentang pengujian

Terbitkan agen Anda

Saat agen Anda siap untuk pengalaman Microsoft 365 yang sebenarnya seperti obrolan Teams, pesan Outlook, atau Word @mentions, Anda memublikasikannya 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