Sdílet prostřednictvím

Rychlý start: Nastavení a spuštění ukázkového agenta sady JavaScript Claude Agent SDK

V tomto rychlém startu si projděte nastavení funkčního agenta JavaScriptu Claude pomocí nástrojů agenta 365, oznámení, pozorovatelnosti a testování agenta pomocí agentů Playground a Teams.

Předpoklady

Nastavení ukázky Clauda + Node.js ze sady nástrojů Microsoft 365 Agents

Pokud chcete všechno připravit, nainstalujte sadu Microsoft 365 Agents Toolkit ve VS Code, otevřete ukázkovou galerii a místně vygenerujte ukázku Clauda + Node.js, abyste ji mohli nakonfigurovat a spustit později. Následující snímky obrazovky ukazují, co můžete očekávat při procházení toku.

  1. V editoru Visual Studio Code otevřete panel Rozšíření (Ctrl+Shift+X), vyhledejte sadu nástrojů Microsoft 365 Agents Toolkit a vyberte Nainstalovat.

    Snímek obrazovky s vyhledáváním rozšíření Marketplace pro sadu nástrojů Agents Toolkit

  2. Otevřete zobrazení M365 Agents Toolkit z panelu aktivit VS Code a zvolte Zobrazit ukázky.

    Snímek obrazovky s úvodním zobrazením sady nástrojů s deklarativním agentem, vytvořením nového agenta nebo aplikací a možnostmi zobrazit ukázky

  3. Vyberte ukázku Clauda + Node.js , zvolte Vytvořit a vyberte (nebo vytvořte) složku, ve které má být projekt vygenerován (například C:\A365-Ignite-Demo). Sada nástrojů vytvoří podsložku (například sample_agent) a otevře ji ve VS Code.

    Snímek obrazovky s ukázkami sady nástrojů Agent Clauda ukázka se zaměřila.

Po dokončení generování uživatelského rozhraní máte spustitelný projekt. Další kroky probíhají uvnitř nové ukázkové složky.

Instalace závislostí a konfigurace prostředí

Vygenerované package.json už obsahuje seznam balíčků, které ukázka potřebuje, takže nainstalujte vše v jednom průchodu:

npm install

Po instalaci ověřte sestavení a spuštění projektu spuštěním vývojového serveru.

npm run dev

Vývojový server naslouchá na portu nakonfigurovaného v ukázce (localhost:3978 ve výchozím nastavení) a je připravený přijímat požadavky z webu Agents Playground nebo rozhraní příkazového řádku.

Přidání nástrojů Microsoftu 365 (servery MCP)

Servery MCP můžete zkoumat a spravovat pomocí vývojových příkazů a365 v rozhraní příkazového řádku. Balíček @microsoft/agents-a365-tooling-extensions-claude tyto servery MCP propoří do orchestrátoru Claude, aby sada SDK agenta volala nástroje Microsoftu 365 v souladu s dovednostmi definovanými v plánu agenta Clauda.

Při práci se servery MCP můžete:

  • Zjištění, které servery MCP jsou k dispozici pro použití
  • Přidání jednoho nebo více serverů MCP do konfigurace agenta
  • Zkontrolujte aktuálně nakonfigurované servery MCP.
  • Odebrání serverů MCP, které už nepotřebujete

Po přidání serverů MCP se manifest nástrojů vašeho agenta rozbalí tak, aby zahrnoval položky podobné:

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

Naučte se přidávat a spravovat nástroje.

Odběr oznámení a zpracování

Ukázkový agent se přihlásí k odběru všech oznámení agenta 365 pomocí onAgentNotification("*") a přesměruje je do jedné obslužné rutiny. Tato obslužná rutina umožňuje agentovi reagovat na události na pozadí nebo systému, nejen na přímé uživatelské zprávy.

Informace o tom, jak informovat agenty

Následující kód ukazuje, jak je v agent.ts souboru nakonfigurováno oznámení.

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
}

Pozorovatelnost

Tento fragment kódu ukazuje minimální změny potřebné k povolení pozorovatelnosti v ukázce. Aktualizujte src/client.ts na inicializaci sady Agent 365 Observability SDK a zabalte každé vyvolání agenta tak InferenceScope , aby se vstupy, výstupy a metadata mohly zachytit automaticky.

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

Tento kód je úplné nastavení pozorovatelnosti potřebné pro ukázku Node.js + Claude. Zástupná metadata nahraďte hodnotami, které jste už pro agenta nakonfigurovali. Další informace o pozorovatelnosti

Otestujte svého agenta

Nastavte požadované proměnné prostředí, vyberte režim ověřování a spusťte agenta místně. Pokud nechcete agenta publikovat a používat ho v aplikacích, jako je Teams nebo Outlook, můžete otestovat všechno kompletní pomocí agentů a bez nutnosti používat tenanta Microsoftu 365.

Přehled testovacích kroků

  • Přidejte nastavení modelu ANTHROPIC_API_KEY do .env souboru, aby ukázka mohl mluvit s Claudem.
  • Zvolte režim ověřování. V případě místního vývoje ukázka podporuje ověřování agentů pomocí hodnot vytvořených z podrobného plánu agenta.
  • Spusťte agenta místně, který ho zpřístupňuje nástrojům, jako jsou Agenti Playground.
  • Pomocí služby Agents Playground můžete testovat zprávy, nástroje a oznámení bez nastavení tenanta nebo nasazení čehokoli.
  • Až budete připraveni na skutečné chování, publikujte tenanta Microsoftu 365 a otestujte agenta uvnitř Teams, Outlooku nebo jiných povrchů Microsoftu 365.

Další informace o testování

Publikování agenta

Až bude váš agent připravený na skutečné prostředí Microsoftu 365, jako jsou chaty Teams, outlookové zprávy nebo Word @mentions, publikujete ho do tenanta Microsoftu 365. Příkaz Rozhraní příkazového řádku publish agenta 365 zpracovává balení: aktualizuje váš manifest, sbalí všechno a nahraje agenta do Centra pro správu Microsoftu.

Během publikování zkontrolujte a přizpůsobte název agenta, popis, ikony a verzi před dokončením nahrávání. Po publikování se váš agent stane zjistitelným a instalovatelným v rámci tenanta.

Publikované agenty můžete zobrazit tady: https://admin.cloud.microsoft/#/agents/all

Další informace o úplném pracovním postupu a podrobných pokynech

  • Last updated on