เริ่มต้นใช้งานด่วน: ตั้งค่าและเรียกใช้ตัวแทนตัวอย่าง JavaScript Claude Agent SDK

ในการเริ่มต้นใช้งานด่วนนี้ แนะนําการตั้งค่าตัวแทน JavaScript Claude ที่ทํางานโดยใช้เครื่องมือตัวแทน 365 การแจ้งเตือน การสังเกตการณ์ และการทดสอบตัวแทนโดยใช้ Agents Playground และ Teams

ข้อกำหนดเบื้องต้น

หากคุณวางแผนที่จะใช้ Visual Studio Code คุณต้องติดตั้ง .NET (แนะนํา.NET 8.0)
Node.js (เวอร์ชัน 18 หรือสูงกว่า)
แพคเกจ SDK ของตัวแทน Claude และคีย์ API Anthropic
สนามเด็กเล่นของตัวแทน
การเข้าถึงการติดตั้ง npm (Node โปรแกรมจัดการชุดรวมแฟ้ม)
การเข้าถึง GitHub
โครงการตัวแทน AI ที่มีอยู่ การเริ่มต้นใช้งานด่วนนี้ใช้ตัวแทนตัวอย่าง Claude จาก แกลเลอรีชุดเครื่องมือ Microsoft 365 Agents (ATK ใน VS Code)
A365 CLI
การรับรองความถูกต้องข้อมูลประจําตัวของตัวแทน

ตั้งค่าตัวอย่าง Claude + Node.js จากชุดเครื่องมือตัวแทนของ Microsoft 365

หากต้องการให้ทุกอย่างพร้อมแล้ว ให้ติดตั้งชุดเครื่องมือ Microsoft 365 Agents ใน VS Code เปิดแกลเลอรีตัวอย่าง และยกระดับตัวอย่าง Claude + Node.js ในเครื่องเพื่อให้คุณสามารถกําหนดค่าและเรียกใช้ในภายหลังได้ สกรีนช็อตด้านล่างแสดงสิ่งที่คาดหวังเมื่อคุณเลื่อนผ่านโฟลว์

ใน Visual Studio Code ให้เปิดแผงส่วนขยาย (Ctrl+Shift+X) ค้นหา ชุดเครื่องมือตัวแทนของ Microsoft 365 และเลือก ติดตั้ง
เปิดมุมมองชุดเครื่องมือตัวแทน M365 จากแถบกิจกรรมรหัส VS และเลือกดูตัวอย่าง
เลือก ตัวอย่าง Claude + Node.js เลือก สร้างและเลือก (หรือสร้าง) โฟลเดอร์ที่ควรจะยกระดับโครงการ (ตัวอย่างเช่น C:\A365-Ignite-Demo) ชุดเครื่องมือจะสร้างโฟลเดอร์ย่อย (เช่น sample_agent) และเปิดใน VS Code

เมื่อการยกระดับเสร็จสมบูรณ์แล้ว คุณมีโครงการที่สามารถทํางานได้ ขั้นตอนถัดไปเกิดขึ้นภายในโฟลเดอร์ตัวอย่างใหม่

ติดตั้งการขึ้นต่อกันและกําหนดค่าสภาพแวดล้อม

รายการที่สร้างขึ้น package.json แล้วแสดงรายการแพคเกจที่ตัวอย่างต้องการ ดังนั้นให้ติดตั้งทุกอย่างในหนึ่งผ่าน:

npm install

หลังจากการติดตั้ง ตรวจสอบการสร้างและเรียกใช้โครงการโดยการเริ่มต้นเซิร์ฟเวอร์พัฒนา

npm run dev

เซิร์ฟเวอร์นักพัฒนาจะรอรับการติดต่อจากพอร์ตที่กําหนดค่าในตัวอย่าง (localhost:3978 ตามค่าเริ่มต้น) และพร้อมที่จะยอมรับคําขอจาก Agents Playground หรือ CLI

เพิ่มเครื่องมือ Microsoft 365 (เซิร์ฟเวอร์ MCP)

คุณสามารถสํารวจและจัดการเซิร์ฟเวอร์ MCP โดยใช้ a365 พัฒนาคําสั่ง ใน CLI แพ็คเกจ @microsoft/agents-a365-tooling-extensions-claude จะต่อสายเซิร์ฟเวอร์ MCP เหล่านี้ลงใน orchestrator Claude ของคุณเพื่อให้ตัวแทน SDK สามารถเรียกเครื่องมือ Microsoft 365 แบบอินไลน์กับทักษะที่กําหนดไว้ในแผนตัวแทน Claude ของคุณ

เมื่อทํางานกับ เซิร์ฟเวอร์ 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
}

ความสามารถในการสังเกต

ส่วนย่อยนี้แสดงการเปลี่ยนแปลงน้อยที่สุดที่จําเป็นเพื่อเปิดใช้งานการสังเกตได้ในตัวอย่าง อัปเดต src/client.ts เพื่อเริ่มต้น SDK การสังเกตการณ์ของตัวแทน 365 และครอบคลุมการเรียกใช้แต่ละตัวแทนในการ InferenceScope ป้อนข้อมูล เอาต์พุต และเมตาดาต้าสามารถบันทึกได้โดยอัตโนมัติ

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

โค้ดนี้คือการตั้งค่าความสามารถในการสังเกตการณ์เต็มรูปแบบที่จําเป็นสําหรับตัวอย่าง Node.js + Claude แทนที่เมตาดาต้าของตัวแทนข้อความด้วยค่าที่คุณกําหนดค่าไว้แล้วสําหรับตัวแทน เรียนรู้เพิ่มเติมเกี่ยวกับความสามารถในการสังเกต

ทดสอบเอเจนต์ของคุณ

ตั้งค่าตัวแปรสภาพแวดล้อมที่จําเป็น เลือกโหมดการรับรองความถูกต้อง และเริ่มต้นตัวแทนภายในเครื่อง คุณสามารถทดสอบทุกอย่างแบบครบวงจรด้วย Agents Playground โดยไม่จําเป็นต้องมีผู้เช่า Microsoft 365 เว้นแต่ว่าคุณต้องการเผยแพร่ตัวแทนและใช้ในแอป เช่น Teams หรือ Outlook

ภาพรวมของขั้นตอนการทดสอบ

เพิ่มการตั้งค่าแบบจําลอง และ ของคุณ ANTHROPIC_API_KEY ไปยัง .env ไฟล์เพื่อให้ตัวอย่างสามารถพูดคุยกับ Claude ได้
เลือกโหมดการรับรองความถูกต้องของคุณ สําหรับการพัฒนาภายใน เครื่อง ตัวอย่างสนับสนุนการรับรองความถูกต้องแบบตัวแทนโดยใช้ค่าที่สร้างขึ้นจากพิมพ์เขียวตัวแทนของคุณ
เริ่มต้นเจ้าหน้าที่ภายในเครื่อง ซึ่งแสดงเครื่องมือเช่น Agents Playground
ใช้ Agents Playground เพื่อทดสอบข้อความ เครื่องมือ และการแจ้งเตือนโดยไม่ต้องตั้งค่าผู้เช่าหรือปรับใช้อะไรเลย
เมื่อคุณพร้อมสําหรับลักษณะการทํางานในโลกแห่งความจริง เผยแพร่ผู้เช่า Microsoft 365 และทดสอบตัวแทนภายใน Teams, Outlook หรือพื้นผิวอื่น ๆ ของ Microsoft 365

เรียนรู้เพิ่มเติมเกี่ยวกับการทดสอบ

เผยแพร่เอเจนต์ของคุณ

เมื่อตัวแทนของคุณพร้อมสําหรับประสบการณ์การใช้งาน Microsoft 365 จริง เช่น การสนทนาใน Teams ข้อความ Outlook หรือ Word @mentionsคุณจะเผยแพร่ไปยังผู้เช่า Microsoft 365 คําสั่ง Agent 365 CLI publish จัดการบรรจุภัณฑ์: จะอัปเดตรายการ รวมทุกอย่างเข้าด้วยกัน และอัปโหลดตัวแทนไปยังศูนย์การจัดการ Microsoft

ในระหว่างการเผยแพร่ ตรวจทานและปรับแต่งชื่อ คําอธิบาย ไอคอน และเวอร์ชันของตัวแทนก่อนที่จะเสร็จสิ้นการอัปโหลด เมื่อเผยแพร่ ตัวแทนของคุณจะกลายเป็นสิ่งที่ค้นพบและสามารถติดตั้งภายในผู้เช่าได้

คุณสามารถดูตัวแทนที่เผยแพร่ได้ที่นี่: https://admin.cloud.microsoft/#/agents/all

เรียนรู้เพิ่มเติมเกี่ยวกับเวิร์กโฟลว์แบบเต็มและคําแนะนําทีละขั้นตอน

คำติชม

หน้านี้มีประโยชน์หรือไม่

Last updated on 2025-12-02