Γρήγορη εκκίνηση: Ρύθμιση και εκτέλεση του δείγματος παράγοντα JavaScript Claude Agent SDK

Σε αυτή τη Γρήγορη εκκίνηση, δείτε μια αναλυτική παρουσίαση της ρύθμισης ενός παράγοντα JavaScript Claude που εργάζεται, χρησιμοποιώντας εργαλεία του Agent 365, ειδοποιήσεις, παρατηρησιμότητα και δοκιμή του παράγοντα χρησιμοποιώντας το Agents Playground και το Teams.

Προαπαιτούμενα στοιχεία

Εάν σκοπεύετε να χρησιμοποιήσετε το Visual Studio Code, πρέπει να έχετε εγκατεστημένο το .NET. (Συνιστάται.NET 8.0.)
Node.js (έκδοση 18 ή νεότερη)
Πακέτα SDK του Claude Agent και κλειδί API Anthropic
Πράκτορες παιδική χαρά
Πρόσβαση σε εγκαταστάσεις npm (Διαχείριση πακέτων κόμβων)
Πρόσβαση στο GitHub
Ένα υπάρχον έργο παράγοντα AI. Αυτός ο οδηγός γρήγορης εκκίνησης χρησιμοποιεί ένα δείγμα παράγοντα Claude από τη συλλογή Toolkit Microsoft 365 Agents (ATK in VS Code).
A365 CLI
Έλεγχος ταυτότητας παράγοντα

Ρυθμίστε το δείγμα Claude + Node.js από το Κιτ εργαλείων Microsoft 365 Agents

Για να προετοιμάσετε τα πάντα, εγκαταστήστε το Κιτ εργαλείων Microsoft 365 Agents στο VS Code, ανοίξτε τα δείγματα συλλογής και δημιουργήστε ένα σκελετό στο δείγμα Claude + Node.js τοπικά, ώστε να μπορείτε να το ρυθμίσετε και να το εκτελέσετε αργότερα. Τα παρακάτω στιγμιότυπα οθόνης εμφανίζουν τι να περιμένετε καθώς μετακινείστε στη ροή.

Στο Visual Studio Code, ανοίξτε τον πίνακα Επεκτάσεις (Ctrl+Shift+X), αναζητήστε το Κιτ εργαλείων Microsoft 365 Agents και επιλέξτε Εγκατάσταση.
Ανοίξτε την προβολή Κιτ εργαλείων M365 Agents από τη Γραμμή δραστηριότητας κώδικα VS και επιλέξτε Προβολή δειγμάτων.
Επιλέξτε το δείγμα Claude + Node.js , επιλέξτε Δημιουργία και επιλέξτε (ή δημιουργήστε) τον φάκελο στον οποίο θα πρέπει να δημιουργηθεί το έργο (για παράδειγμα, C:\A365-Ignite-Demo). Το κιτ εργαλείων δημιουργεί έναν υποφάκελο (όπως sample_agent) και τον ανοίγει σε κώδικα VS.

Όταν ολοκληρωθεί η δημιουργία σκελετού, έχετε ένα έργο με δυνατότητα εκτέλεσης. Τα επόμενα βήματα πραγματοποιούνται μέσα στο νέο δείγμα φακέλου.

Εγκατάσταση εξαρτήσεων και ρύθμιση παραμέτρων του περιβάλλοντος

Το ήδη δημιουργημένο package.json εμφανίζει τα πακέτα που χρειάζεται το δείγμα, επομένως εγκαταστήστε όλα τα στοιχεία με μία διαβίβαση:

npm install

Μετά την εγκατάσταση, επαληθεύστε ότι το έργο δημιουργείται και εκτελείται ξεκινώντας τον διακομιστή dev

npm run dev

Ο διακομιστής ανάπτυξης παρακολουθεί τη θύρα που έχει ρυθμιστεί στο δείγμα (localhost:3978 από προεπιλογή) και είναι έτοιμος να δεχτεί αιτήσεις από το Agents Playground ή το CLI.

Προσθήκη εργαλείων Microsoft 365 (διακομιστές MCP)

Μπορείτε να εξερευνήσετε και να διαχειριστείτε διακομιστές MCP χρησιμοποιώντας τις εντολές ανάπτυξης a365 στη CLI. Το @microsoft/agents-a365-tooling-extensions-claude πακέτο μεταφέρει αυτούς τους διακομιστές MCP στον ενορχηστρωτή σας 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"
    }
  ]
}

Μάθετε πώς μπορείτε να προσθέσετε και να διαχειριστείτε εργαλεία

Συνδρομή και χειρισμός ειδοποιήσεων

Το δείγμα παράγοντα εγγράφει σε όλες τις ειδοποιήσεις του παράγοντα 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.
Επιλέξτε τη λειτουργία ελέγχου ταυτότητας. Για την τοπική ανάπτυξη, το δείγμα υποστηρίζει έλεγχο ταυτότητας agentic με χρήση τιμών που δημιουργήθηκαν από τον παράγοντα Blueprint.
Ξεκινήστε τον παράγοντα τοπικά, το οποίο το εκθέτει σε εργαλεία όπως το Agents Playground.
Χρησιμοποιήστε το Agents Playground για να δοκιμάσετε μηνύματα, εργαλεία και ειδοποιήσεις χωρίς να ρυθμίσετε έναν μισθωτή ή να αναπτύξετε τίποτα.
Όταν είστε έτοιμοι για συμπεριφορά από τον πραγματικό κόσμο, δημοσιεύστε έναν μισθωτή Microsoft 365 και δοκιμάστε τον παράγοντα μέσα στο Teams, το Outlook ή σε άλλες επιφάνειες του Microsoft 365.

Μάθετε περισσότερα σχετικά με τις δοκιμές

Δημοσίευση του παράγοντά σας

Όταν ο πράκτοράς σας είναι έτοιμος για πραγματικές εμπειρίες του Microsoft 365, όπως συνομιλίες του Teams, μηνύματα Outlook ή Word @mentions, θα τις δημοσιεύσετε σε έναν μισθωτή Microsoft 365. Η εντολή CLI publish agent 365 χειρίζεται τη συσκευασία: ενημερώνει τη διακήρυξη, ομαδοποιεί τα πάντα και αποστέλλει τον πράκτορα στο Κέντρο διαχείρισης της Microsoft.

Κατά τη διάρκεια της δημοσίευσης, εξετάστε και προσαρμόστε το όνομα, την περιγραφή, τα εικονίδια και την έκδοση του παράγοντα πριν ολοκληρώσετε την αποστολή. Μόλις δημοσιευτεί, ο πράκτοράς σας καθίσταται ανιχνεύσιμος και μπορεί να εγκατασταθεί εντός του μισθωτή.

Μπορείτε να δείτε δημοσιευμένους υπαλλήλους εδώ: https://admin.cloud.microsoft/#/agents/all

Μάθετε περισσότερα σχετικά με την πλήρη ροή εργασιών και τις οδηγίες βήμα προς βήμα

Ανάδραση

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2025-12-02