Aracılığıyla paylaş

Hızlı Başlangıç: JavaScript Claude Aracısı SDK örnek aracısını ayarlama ve çalıştırma

Bu Hızlı Başlangıçta Agent 365 araçlarını, bildirimlerini, gözlemlenebilirliğini ve AracıLar Playground ve Teams kullanarak aracıyı test ederek çalışan bir JavaScript Claude aracısını ayarlama adımlarını izleyin.

Önkoşullar

  • Visual Studio Code kullanmayı planlıyorsanız.NET yüklü olmalıdır. TLS 1.2 önerilir.
  • Node.js sürüm 20 veya üstü
  • Claude Aracısı SDK paketleri ve Antropik API anahtarı
  • Aracı Deneme Alanı
  • npm (Node Paket Yöneticisi) yüklemelerine erişim
  • GitHub'a erişim
  • Mevcut bir Yapay Zeka Aracısı projesi. Bu hızlı başlangıçta Microsoft 365 Aracıları Araç Seti galerisinden (VS Code'da ATK) claude örnek aracısı kullanılır.
  • A365 CLI
  • Aracı Kimliği Kimlik Doğrulaması

Microsoft 365 Aracıları Araç Seti'nden Claude + Node.js örneğini ayarlama

Her şeyi hazırlamak için VS Code'da Microsoft 365 Aracıları Araç Seti'ni yükleyin, örnek galeriyi açın ve daha sonra yapılandırıp çalıştırabilmek için Claude + Node.js örneğini yerel olarak iskeleye alın. Aşağıdaki ekran görüntüleri, akışta ilerlediğinizde neler bekleyebileceğinizi gösterir.

  1. Visual Studio Code'da Uzantılar panelini (Ctrl+Shift X)+açın, Microsoft 365 Aracılar Araç Seti'ni arayın ve Yükle'yi seçin.

    Aracılar Araç Seti için Uzantılar Market araması ekran görüntüsü.

  2. VS Code Etkinlik Çubuğu'ndan M365 Aracıları Araç Seti görünümünü açın ve Örnekleri Görüntüle'yi seçin.

    Bildirim Temelli Aracı Oluşturma, Yeni Aracı veya Uygulama Oluşturma ve Örnekleri Görüntüle seçeneklerini içeren Araç Seti Hoş Geldiniz Görünümünün ekran görüntüsü.

  3. Claude + Node.js örneğini seçin, Oluştur'u seçin ve projenin iskelesinin oluşturulması gereken klasörü (örneğin, C:\A365-Ignite-Demo) seçin (veya oluşturun). Araç seti bir alt klasör (örneğin sample_agent) oluşturur ve bunu VS Code'da açar.

    Aracı araç seti örneklerinin ekran görüntüsü. Claude örneği odaklandı.

yapı iskelesi tamamlandıktan sonra çalıştırılabilir bir projeniz vardır. Sonraki adımlar yeni örnek klasörün içinde gerçekleşir.

Bağımlılıkları yükleme ve ortamı yapılandırma

Oluşturulan package.json paket zaten örnek için gereken paketleri listeler, bu nedenle her şeyi tek bir geçişte yükleyin:

npm install

Yüklemeden sonra geliştirme sunucusunu başlatarak projenin derlendiğini ve çalıştığını doğrulayın

npm run dev

Geliştirme sunucusu, örnekte yapılandırılan bağlantı noktasını (localhost:3978 varsayılan olarak) dinler ve Agents Playground veya CLI'dan gelen istekleri kabul etmeye hazırdır.

Microsoft 365 araçları (MCP sunucuları) ekleme

CLI'daki a365 geliştirme komutlarını kullanarak MCP sunucularını keşfedebilir ve yönetebilirsiniz. Paket, @microsoft/agents-a365-tooling-extensions-claude bu MCP sunucularını Claude düzenleyicinize aktarır, böylece Aracı SDK'sı Claude aracı planınızda tanımlanan becerilerle Microsoft 365 araçlarını satır içi olarak çağırabilir.

MCP sunucularıyla çalışırken şunları yapabilirsiniz:

  • Hangi MCP sunucularının kullanılabilir olduğunu keşfedin
  • Aracınızın yapılandırmasına bir veya daha fazla MCP sunucusu ekleme
  • Şu anda yapılandırılmış OLAN MCP sunucularını gözden geçirin
  • Artık ihtiyacınız olmayan MCP sunucularını kaldırma

MCP sunucuları eklendikten sonra aracınızın araç bildirimi aşağıdakine benzer girdileri içerecek şekilde genişler:

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

Araç eklemeyi ve yönetmeyi öğrenin

Bildirim aboneliği ve işleme

Örnek aracı kullanarak onAgentNotification("*") tüm Aracı 365 bildirimlerine abone olur ve bunları tek bir işleyiciye yönlendirir. Bu işleyici, aracının yalnızca doğrudan kullanıcı iletilerine değil, arka plan veya sistem olaylarına tepki vermesine olanak tanır.

Aracıları nasıl bilgilendireceğinizi öğrenin

Aşağıdaki kod, bildirimin dosyada agent.ts nasıl yapılandırıldığını gösterir.

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
}

Gözlemlenebilirlik

Bu kod parçacığı, örnekte gözlemlenebilirliği etkinleştirmek için gereken en düşük değişiklikleri gösterir. Agent 365 Gözlemlenebilirlik SDK'sını başlatmak ve her aracı çağrısını bir InferenceScope içinde sarmalayarak girişlerin, çıkışların ve meta verilerin otomatik olarak yakalanmasını sağlamak için güncelleştirinsrc/client.ts.

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

Bu kod, Node.js + Claude örneği için gereken tam gözlemlenebilirlik kurulumudur. Yer tutucu meta verilerini aracı için önceden yapılandırdığınız değerlerle değiştirin. Gözlemlenebilirlik hakkında daha fazla bilgi edinin

Aracınızı test etme

Gerekli ortam değişkenlerini ayarlayın, bir kimlik doğrulama modu seçin ve aracıyı yerel olarak başlatın. Aracıyı yayımlamak ve Teams veya Outlook gibi uygulamalarda kullanmak istemiyorsanız, Aracılar Oyun Alanı ile microsoft 365 kiracısına gerek kalmadan her şeyi uçtan uca test edebilirsiniz.

Test adımlarına genel bakış

  • ANTHROPIC_API_KEY Örneğin Claude ile konuşabilmesi için ve model ayarlarınızı bir .env dosyaya ekleyin.
  • Kimlik doğrulama modunuzu seçin. Yerel geliştirme için örnek, Aracı Şemanızdan oluşturulan değerleri kullanarak Aracılı Kimlik Doğrulamasını destekler.
  • Aracıyı yerel olarak başlatın ve aracıyı Agents Playground gibi araçlarla kullanıma sunar.
  • Kiracı ayarlamadan veya herhangi bir şey dağıtmadan iletileri, araçları ve bildirimleri test etmek için Agents Playground'ı kullanın.
  • Gerçek hayattaki davranışlara hazır olduğunuzda bir Microsoft 365 kiracısı yayımlayın ve aracıyı Teams, Outlook veya diğer Microsoft 365 yüzeylerinde test edin.

Test etme hakkında daha fazla bilgi edinin

Temsilcinizi yayımlama

Aracınız Teams sohbetleri, Outlook iletileri veya Word @mentionsgibi gerçek Microsoft 365 deneyimlerine hazır olduğunda, aracıyı bir Microsoft 365 kiracısına yayımlarsınız. Agent 365 CLI publish komutu paketlemeyi işler: bildiriminizi güncelleştirir, her şeyi paketler ve aracıyı Microsoft Yönetim Merkezi'ne yükler.

Yayımlama sırasında, karşıya yüklemeyi tamamlamadan önce aracının adını, açıklamasını, simgelerini ve sürümünü gözden geçirin ve özelleştirin. Aracınız yayımlandıktan sonra kiracı içinde bulunabilir ve yüklenebilir hale gelir.

Yayımlanan aracıları burada görüntüleyebilirsiniz: https://admin.cloud.microsoft/#/agents/all

tam iş akışı ve adım adım yönergeler hakkında daha fazla bilgi edinin

  • Last updated on