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

Dalam Mulai Cepat ini, telusuri penyiapan agen JavaScript Claude yang berfungsi menggunakan alat Agen 365, pemberitahuan, pengamatan, dan pengujian agen menggunakan Agents Playground dan Teams.

Prasyarat

Jika Anda berencana menggunakan Visual Studio Code, Anda harus menginstal .NET. (.NET 8.0 disarankan.)
Instal Node.js versi 10.x atau lebih tinggi.
Paket Claude Agent SDK dan kunci API Antropik
Taman bermain agen
Akses ke penginstalan npm (Node Package Manager)
Akses ke GitHub
Proyek Agen AI yang ada. Mulai cepat ini menggunakan agen sampel Claude dari galeri Toolkit Agen Microsoft 365 (ATK di VS Code).
A365 CLI
Autentikasi Identitas Agen

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

Untuk menyiapkan semuanya, instal Toolkit Agen Microsoft 365 di Visual Studio Code, buka galeri sampel, dan buat sampel Claude + Node.js secara lokal sehingga Anda dapat mengonfigurasi dan menjalankannya nanti. Cuplikan layar di bawah ini menunjukkan apa yang diharapkan saat Anda menelusuri alur.

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

Setelah perancah selesai, Anda memiliki proyek yang dapat dijalankan. Langkah berikutnya terjadi di dalam folder sampel baru.

Menginstal dependensi dan mengonfigurasi lingkungan

yang dihasilkan package.json sudah mencantumkan paket yang dibutuhkan sampel, jadi instal semuanya dalam satu pass:

npm install

Setelah penginstalan, verifikasi proyek yang dibangun dan dijalankan dengan memulai server dev

npm run dev

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

Menambahkan alat Microsoft 365 (server MCP)

Anda dapat menjelajahi dan mengelola server MCP menggunakan perintah pengembangan a365 di CLI. Paket menghubungkan @microsoft/agents-a365-tooling-extensions-claude server MCP ini ke orkestrator Claude Anda sehingga Agent SDK dapat memanggil alat Microsoft 365 sebaris dengan keterampilan yang ditentukan dalam rencana agen Claude Anda.

Saat bekerja dengan server MCP, Anda dapat:

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

Setelah server MCP ditambahkan, manifes peralatan agen Anda diperluas untuk menyertakan 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 pemberitahuan dan penanganan

Agen sampel berlangganan semua pemberitahuan Agen 365 menggunakan onAgentNotification("*") dan merutekannya ke satu handler. Handler ini memungkinkan agen untuk bereaksi terhadap peristiwa latar belakang atau sistem, bukan hanya pesan pengguna langsung.

Pelajari cara memberi tahu agen

Kode berikut menunjukkan bagaimana pemberitahuan dikonfigurasi dalam agent.ts file.

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 menunjukkan perubahan minimal yang diperlukan untuk mengaktifkan pengamatan dalam sampel. Perbarui src/client.ts untuk menginisialisasi SDK Observabilitas Agen 365 dan membungkus setiap pemanggilan agen dengan InferenceScope begitu input, output, dan metadata dapat ditangkap 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 penyiapan pengamatan lengkap yang diperlukan untuk sampel Node.js + Claude. Ganti metadata tempat penampung dengan nilai yang sudah Anda konfigurasi untuk agen. Pelajari selengkapnya tentang pengamatan

Menguji agen

Atur variabel lingkungan yang diperlukan, pilih mode autentikasi, dan mulai agen secara lokal. Anda dapat menguji semuanya secara menyeluruh dengan Agen Playground tanpa memerlukan penyewa Microsoft 365 kecuali Anda ingin menerbitkan agen dan menggunakannya di aplikasi seperti Teams atau Outlook.

Gambaran umum langkah pengujian

Tambahkan pengaturan model dan Anda ANTHROPIC_API_KEY ke .env file sehingga sampel dapat berbicara dengan Claude.
Pilih mode autentikasi Anda. Untuk pengembangan lokal, sampel mendukung Autentikasi Agenik menggunakan nilai yang dibuat dari Cetak Biru Agen Anda.
Mulai agen secara lokal, yang mengeksposnya ke alat seperti Agents Playground.
Gunakan Agen Playground untuk menguji pesan, alat, dan pemberitahuan tanpa menyiapkan penyewa atau menyebarkan apa pun.
Saat Anda siap untuk perilaku dunia nyata, terbitkan penyewa Microsoft 365 dan uji agen di dalam permukaan Teams, Outlook, atau Microsoft 365 lainnya.

Pelajari selengkapnya tentang pengujian

Terbitkan agen Anda

Saat agen Anda siap untuk pengalaman Microsoft 365 aktual seperti obrolan Teams, pesan Outlook, atau Word @mentions, Anda menerbitkannya ke penyewa Microsoft 365. Perintah Agen 365 CLI publish menangani kemasan: perintah ini memperbarui manifes Anda, membedel semuanya, dan mengunggah agen ke Pusat Admin Microsoft.

Selama penerbitan, tinjau dan sesuaikan nama, deskripsi, ikon, dan versi agen sebelum menyelesaikan unggahan. Setelah dipublikasikan, agen Anda menjadi dapat ditemukan dan dapat diinstal di dalam penyewa.

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

Pelajari selengkapnya tentang alur kerja lengkap dan instruksi langkah demi langkah

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-12-02