Pikaopas: JavaScript Claude Agent SDK -näyteagentin määrittäminen ja suorittaminen

Tässä pikaoppaassa käydään läpi toimivan JavaScript Claude -agentin määrittäminen Agent 365:n työkalujen, ilmoitusten, havainnoitavuuden ja agentin testauksen avulla Agent Playgroundin ja Teamsin avulla.

Edellytykset

• Jos aiot käyttää Visual Studio Codea, sinulla on oltava .NET asennettuna. (.NET 8.0 on suositus.)
• Node.js (versio 18 tai uudempi versio)
• Claude Agent SDK -paketit ja antropisen ohjelmointirajapinnan avain
• Agenttien leikkikenttä
• Npm (Node Package Manager) -asennusten käyttö
• Pääsy GitHubiin
• Aiemmin luotu tekoälyagenttiprojekti. Tässä pikaoppaassa käytetään Clauden näyteagenttia Microsoft 365 Agent Toolkit -valikoimasta (ATK VS Codessa).
• A365 CLI
• Agentin käyttäjätietojen todennus

Claude + Node.js -näytteen määrittäminen Microsoft 365 Agent Toolkitistä

Saat kaiken valmiiksi asentamalla Microsoft 365 Agent Toolkitin VS Codeen, avaamalla näytevalikoiman ja luomalla Claude + Node.js -näytteen paikallisesti, jotta voit määrittää sen ja suorittaa sen myöhemmin. Alla oleviksi näyttökuviksi näytetään, mitä on odotettavissa työnkulkua siirtyessäsi.

1. Avaa Visual Studio Codessa Laajennuspaneeli (Ctrl+Vaihto+X), etsi Microsoft 365 Agents Toolkit ja valitse Asenna.

   

2. Avaa M365 Agentit Toolkit -näkymä VS Code Activity Barista ja valitse Näytä mallit.

   

3. Valitse Claude + Node.js otos, valitse Luo ja valitse (tai luo) kansio, johon projektin tulee olla rakennettu (esimerkiksi C:\A365-Ignite-Demo). Työkalupaketti luo alikansion (kuten sample_agent) ja avaa sen VS Codessa.

   

Kun rakenne on valmis, sinulla on suoritettava projekti. Seuraavat vaiheet suoritetaan uudessa mallikansiossa.

Riippuvuuksien asentaminen ja ympäristön määrittäminen

Luoduissa package.json luetteloissa on jo paketit, joita malli tarvitsee, joten asenna kaikki yhdessä syötössä:

npm install

Asennuksen jälkeen voit tarkistaa projektin koontiversiot ja suoritukset käynnistämällä kehityspalvelimen.

npm run dev

Kehityspalvelin kuuntelee mallissa (localhost:3978 oletusarvoisesti) määritettyä porttia ja on valmis hyväksymään pyyntöjä Agents Playgroundilta tai komentorivikäyttöliittymältä.

Lisää Microsoft 365 -työkaluja (MCP-palvelimet)

Voit tutkia ja hallita MCP-palvelimia komentorivikäyttöliittymän a365-kehityskomennoilla . Paketti @microsoft/agents-a365-tooling-extensions-claude liittää nämä MCP-palvelimet Clauden orkestraattoriisi, - jotta agentti SDK voi soittaa Microsoft 365:n työkaluille, - jotka liittyvät Claude Agent -suunnitelmasi mukaisiin taitoihin.

Kun käytät MCP-palvelimia, voit tehdä seuraavaa:

• Selvitä, mitkä MCP-palvelimet ovat käytettävissä
• Lisää yksi tai useampi MCP-palvelin agenttisi kokoonpanoon
• Tarkista mcp-palvelimet, jotka on tällä hetkellä määritetty
• Poista MCP-palvelimet, joita et enää tarvitse

Kun MCP-palvelimet on lisätty, agenttisi työkaluluettelo laajenee sisältämään seuraavanlaisia merkintöjä:

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

Opi lisäämään ja hallitsemaan työkaluja

Ilmoitusten tilaus ja käsittely

Malliagentti tilaa kaikki Agent 365 -ilmoitukset käyttämällä onAgentNotification("*") ja reitittää ne yksittäiselle käsittelijälle. Tämän käsittelijän avulla agentti voi reagoida tausta- tai järjestelmätapahtumiin, ei pelkästään suoriin käyttäjäviesteihin.

Lue, miten voit ilmoittaa agenteille

Seuraava koodi näyttää, miten ilmoitus määritetään tiedostossa 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
}

Näkyvyys

Tämä katkelma näyttää vain ne vähimmäismuutokset, jotka tarvitaan näytteessä havaittavuuden mahdollistamiseen. Päivitä src/client.ts , jotta agentin 365 Observability SDK alustaa ja rivittää kunkin agentin kutsun, InferenceScope jotta syötteet, tulosteet ja metatiedot voidaan siepata automaattisesti.

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

Tämä koodi on Node.js + Claude -näytteen vaatima täydellinen havainnoitavuuden määritys. Korvaa paikkamerkin metatiedot arvoilla, jotka olet jo määrittänyt agentille. Lue lisätietoja havainnoitavuudesta

Agentin testaaminen

Määritä tarvittavat ympäristömuuttujat, valitse todennustila ja käynnistä agentti paikallisesti. Voit testata kaiken loppuun Agent Playgroundin avulla tarvitsematta Microsoft 365 -vuokraajaa, ellet halua julkaista agenttia ja käyttää sitä Teamsin tai Outlookin kaltaisissa sovelluksissa.

Testausvaiheiden yleiskatsaus

• Lisää sinun ANTHROPIC_API_KEY ja mallin asetukset tiedostoon, .env jotta näyte voi puhua Claudelle.
• Valitse todentamistilasi. Paikallisessa kehitystyössä malli tukee agenttiTodennusta agentti Blueprintistä luotujen arvojen avulla.
• Käynnistä agentti paikallisesti, jolloin se paljastuu Agentit Playgroundin kaltaisille työkaluille.
• Agenttien leikkikentän avulla voit testata viestejä, työkaluja ja ilmoituksia määrittämättä vuokraajaa tai ottamalla käyttöön mitään.
• Kun olet valmis todelliseen toimintaan, julkaise Microsoft 365 -vuokraaja ja testaa agenttia Teamsin, Outlookin tai muiden Microsoft 365 -pintojen sisällä.

Lue lisätietoja testauksesta

Agentin julkaiseminen

Kun agenttisi on valmis todellisiin Microsoft 365 -käyttökokemuksiin, kuten Teams-keskusteluihin, Outlook-viesteihin tai Wordiin @mentions, julkaise se Microsoft 365 -vuokraajaan. Agent 365 CLI publish -komento käsittelee pakkaukset: se päivittää kokoonpanotiedot, niputtaa kaiken ja lataa agentin Microsoftin hallintakeskukseen.

Tarkista julkaisun aikana agentin nimi, kuvaus, kuvakkeet ja versio sekä mukauta sitä ennen latauksen valmistumista. Julkaisun jälkeen agenttisi on löydettävissä ja asennettavissa vuokraajan sisällä.

Voit tarkastella julkaistuja agentteja täällä: https://admin.cloud.microsoft/#/agents/all

Lue lisätietoja täydellisestä työnkulusta ja vaiheittaiset ohjeet