Προσθήκη και διαχείριση εργαλείων

Σημαντικό

Πρέπει να είστε μέρος του προγράμματος προεπισκόπησης Σύνορα για να αποκτήσετε πρώιμη πρόσβαση στον Παράγοντα Microsoft 365. Η Frontier σάς συνδέει απευθείας με τις τελευταίες καινοτομίες τεχνητής νοημοσύνης της Microsoft. Οι προεπισκοπήσεις για τα σύνορα υπόκεινται στους υφιστάμενους όρους προεπισκόπησης των συμβάσεων πελατών σας. Καθώς αυτές οι δυνατότητες είναι ακόμα σε εξέλιξη, η διαθεσιμότητά τους και οι δυνατότητές τους ενδέχεται να αλλάξουν με την πάροδο του χρόνου.

Η εκπαιδευτική ενότητα Εργαλείων επιτρέπει στους προγραμματιστές να ανακαλύπτουν, ρυθμίζουν και ενσωματώνουν διακομιστές πρωτοκόλλου περιβάλλοντος μοντέλου (MCP) σε ροές εργασιών παράγοντα AI. Οι διακομιστές MCP αποκαλύπτουν εξωτερικές δυνατότητες ως εργαλεία που μπορούν να καλούν οι παράγοντες AI. Για μια επισκόπηση των διαθέσιμων διακομιστών εργαλείων, ανατρέξτε στο θέμα Διακομιστές εργαλείων του Παράγοντα 365.

Επισκόπηση

Η ενοποίηση εργαλείων του Παράγοντα 365 ακολουθεί μια ροή εργασιών τεσσάρων βημάτων:

1. Ρύθμιση παραμέτρων διακομιστών MCP - Χρησιμοποιήστε τον Παράγοντα 365 CLI για τον εντοπισμό και την προσθήκη διακομιστών MCP
2. Δημιουργία διακήρυξης - Η CLI δημιουργεί ToolingManifest.json με ρυθμίσεις παραμέτρων διακομιστή
3. Ενοποίηση στον κώδικα - Φόρτωση διακήρυξης και εργαλείων καταχώρησης με τον ενορχηστρωτή σας
4. Εργαλεία κλήσης - Ο παράγοντας καλεί εργαλεία κατά την εκτέλεση για την εκτέλεση λειτουργιών

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

Πριν από τη ρύθμιση παραμέτρων των διακομιστών MCP, βεβαιωθείτε ότι έχετε:

• Εγκατάσταση και ρύθμιση παραμέτρων του παράγοντα 365 CLI
• .NET 8.0 SDK ή νεότερη έκδοση - Λήψη
• Δικαιώματα καθολικού διαχειριστή στον μισθωτή σας Microsoft 365

Ρύθμιση ταυτότητας παράγοντα

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

Ρύθμιση παραμέτρων κύριας υπηρεσίας

Εκτελέστε αυτήν τη δέσμη ενεργειών ρύθμισης ONE-TIME για να δημιουργήσετε την κύρια υπηρεσία για τα Εργαλεία παράγοντα 365 στον μισθωτή σας.

Σημαντικό

Αυτή είναι μια λειτουργία ΜΊΑ ΦΟΡΆ ανά μισθωτή που απαιτεί δικαιώματα καθολικού διαχειριστή.

1. Κάντε λήψη της δέσμης ενεργειών New-Agent365ToolsServicePrincipalProdPublic.ps1

2. Ανοίξτε το PowerShell ως διαχειριστής και μεταβείτε στον κατάλογο δέσμης ενεργειών

3. Εκτελέστε τη δέσμη ενεργειών:

   .\New-Agent365ToolsServicePrincipalProdPublic.ps1
   

4. Εισέλθετε με τα διαπιστευτήριά σας Azure όταν σας ζητηθεί

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

Ρύθμιση παραμέτρων διακομιστών MCP

Χρησιμοποιήστε τον παράγοντα 365 CLI για να ανακαλύψετε, να προσθέσετε και να διαχειριστείτε διακομιστές MCP για τον πράκτορά σας. Για μια πλήρη λίστα των διαθέσιμων διακομιστών MCP και των δυνατοτήτων τους, ανατρέξτε στον κατάλογο διακομιστών MCP.

Εντοπισμός διαθέσιμων διακομιστών

Παράθεση όλων των διακομιστών MCP που μπορούν να ρυθμιστούν:

a365 develop list-available

Προσθήκη διακομιστών MCP

Προσθέστε έναν ή περισσότερους διακομιστές MCP στη ρύθμιση παραμέτρων του παράγοντα:

a365 develop add-mcp-servers mcp_MailTools

Διακομιστές με ρύθμιση παραμέτρων λίστας

Προβολή διακομιστών MCP που έχουν ρυθμιστεί τη συγκεκριμένη στιγμή:

a365 develop list-configured

Κατάργηση διακομιστών MCP

Καταργήστε έναν διακομιστή MCP από τη ρύθμιση παραμέτρων:

a365 develop remove-mcp-servers mcp_MailTools

Για πλήρη αναφορά CLI, ανατρέξτε στην ενότητα μια εντολή ανάπτυξης 365.

Κατανόηση της διακήρυξης εργαλείων

Όταν εκτελείτε a365 develop add-mcp-serversτο , το CLI δημιουργεί ένα ToolingManifest.json αρχείο που περιέχει ρυθμίσεις παραμέτρων για όλους τους διακομιστές MCP. Ο χρόνος εκτέλεσης του παράγοντα χρησιμοποιεί αυτή τη διακήρυξη για να κατανοήσει ποιοι διακομιστές είναι διαθέσιμοι και πώς γίνεται ο έλεγχος ταυτότητας μαζί τους.

Δομή διακήρυξης

Παράδειγμα: ToolingManifest.json

{
  "mcpServers": [
    {
      "mcpServerName": "mcp_MailTools",
      "mcpServerUniqueName": "mcp_MailTools",
      "scope": "McpServers.Mail.All",
      "audience": "api://05879165-0320-489e-b644-f72b33f3edf0"
    }
  ]
}

Παράμετροι διακήρυξης

Κάθε καταχώρηση διακομιστή MCP περιέχει:

Παράμετροι	Περιγραφές
mcpServerName	Το εμφανιζόμενο όνομα του χρήστη
mcpServerUniqueName	Το μοναδικό αναγνωριστικό για την παρουσία του διακομιστή MCP
εμβέλεια	Η εμβέλεια OAuth που απαιτείται για πρόσβαση στις δυνατότητες του διακομιστή MCP (για παράδειγμα: McpServers.Mail.All για λειτουργίες αλληλογραφίας). Αυτή η τιμή ανακτώνται από τον κατάλογο διακομιστών MCP όταν εκτελείτε την add-mcp-servers εντολή.
ακροατήριο	Το URI αναγνωριστικού Microsoft Entra που αναγνωρίζει τον πόρο API προορισμού. Αυτή η τιμή ανακτώνται επίσης από τον κατάλογο διακομιστών MCP.

Σημείωμα

Οι scope τιμές και audience συμπληρώνονται αυτόματα από τον παράγοντα 365 CLI όταν προσθέτετε έναν διακομιστή MCP. Αυτές οι τιμές προέρχονται από τον κατάλογο διακομιστών MCP και ορίζουν τα δικαιώματα που απαιτούνται για την πρόσβαση σε κάθε διακομιστή MCP.

Ενσωμάτωση εργαλείων στον πράκτορά σας

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

Λίστα διακομιστών εργαλείων (Προαιρετικό)

Φιλοδώρημα

Αυτό το βήμα είναι προαιρετικό. Χρησιμοποιήστε την υπηρεσία ρύθμισης παραμέτρων διακομιστή εργαλείων για να ελέγξετε τους διαθέσιμους διακομιστές εργαλείων από τη διακήρυξη εργαλείων πριν από την προσθήκη τους στον ενορχηστρωτή σας.

Χρησιμοποιήστε την υπηρεσία ρύθμισης παραμέτρων διακομιστή εργαλείων για να εντοπίσετε ποιοι διακομιστές εργαλείων είναι διαθέσιμοι στον πράκτορά σας από τη διακήρυξη εργαλείων. Αυτή η μέθοδος σάς επιτρέπει να κάνετε τα εξής:

• Υποβολή ερωτήματος σε όλους τους ρυθμισμένους διακομιστές MCP από την ToolingManifest.json
• Ανάκτηση μετα-δεδομένων και δυνατοτήτων διακομιστή
• Επαλήθευση διαθεσιμότητας διακομιστή πριν από την καταχώρηση

Η μέθοδος για την παράθεση διακομιστών εργαλείων είναι διαθέσιμη στα βασικά πακέτα εργαλείων:

Python

# Use McpToolServerConfigurationService.list_tool_servers
from microsoft.agents.a365.tooling import McpToolServerConfigurationService

config_service = McpToolServerConfigurationService()
tool_servers = await config_service.list_tool_servers(agentic_app_id, auth_token)

Παράμετροι

Παράμετρος	Type	Περιγραφή	Αναμενόμενη τιμή	Απαιτείται/προαιρετικό
agentic_app_id	str	Το μοναδικό αναγνωριστικό για την παρουσία εφαρμογής παράγοντα	Έγκυρη συμβολοσειρά αναγνωριστικού εφαρμογής παράγοντα	Απαραίτητο
auth_token	str	Διακριτικό φορέα για τον έλεγχο ταυτότητας με την πύλη διακομιστή MCP	Έγκυρο διακριτικό φορέα OAuth	Απαραίτητο

Πακέτο: Εργαλεία microsoft-agents-a365

JavaScript

// Use McpToolServerConfigurationService.listToolServers
const { McpToolServerConfigurationService } = require('@microsoft/agents-a365-tooling');

const configService = new McpToolServerConfigurationService();
const toolServers = await configService.listToolServers(agentUserId, authToken);

Παράμετροι

Παράμετρος	Type	Περιγραφή	Αναμενόμενη τιμή	Απαιτείται/προαιρετικό
agentInstanceId	string	Το μοναδικό αναγνωριστικό για την παρουσία του παράγοντα	Συμβολοσειρά αναγνωριστικού παρουσίας έγκυρου παράγοντα	Απαραίτητο
authToken	string	Διακριτικό φορέα για τον έλεγχο ταυτότητας με την πύλη διακομιστή MCP	Έγκυρο διακριτικό φορέα OAuth	Απαραίτητο

Πακέτο: Microsoft.Agents.A365.Tooling

.ΔΊΧΤΥ

// Use IMcpToolServerConfigurationService.ListToolServersAsync
using Microsoft.Agents.A365.Tooling.Services;

var configService = serviceProvider.GetRequiredService<IMcpToolServerConfigurationService>();
var toolServers = await configService.ListToolServersAsync(agentInstanceId, authToken);

Παράμετροι

Παράμετρος	Type	Περιγραφή	Αναμενόμενη τιμή	Απαιτείται/προαιρετικό
agentInstanceId	string	Το μοναδικό αναγνωριστικό για την παρουσία του παράγοντα	Συμβολοσειρά αναγνωριστικού παρουσίας έγκυρου παράγοντα	Απαραίτητο
authToken	string	Διακριτικό φορέα για τον έλεγχο ταυτότητας με την πύλη διακομιστή MCP	Έγκυρο διακριτικό φορέα OAuth	Απαραίτητο

Πακέτο: Microsoft.Agents.A365.Tooling

Καταχώρηση εργαλείων με τον ενορχηστρωτή σας

Χρησιμοποιήστε τη μέθοδο επέκτασης πλαισίου για να καταχωρήσετε όλους τους διακομιστές MCP στο πλαίσιο ενορχήστρωσης:

• AddToolServersToAgentAsync (.NET)
• Python
• addToolServersToAgent (Node.js)

Αυτές οι μέθοδοι:

• Καταχώρηση όλων των εργαλείων από ρυθμισμένους διακομιστές MCP με τον ενορχηστρωτή σας
• Αυτόματη ρύθμιση των λεπτομερειών ελέγχου ταυτότητας και σύνδεσης
• Κάντε τα εργαλεία άμεσα διαθέσιμα για κλήση από τον πράκτορά σας

Επιλέξτε την επέκταση ενορχηστρωτή σας

Η εκπαιδευτική ενότητα Εργαλεία agent 365 παρέχει αποκλειστικά πακέτα επεκτάσεων για διαφορετικά πλαίσια ενορχήστρωσης:

Python

• Microsoft-agents-a365-tooling: Βασικές λειτουργίες εργαλείων
• microsoft-agents-a365-tooling-extensions-agentframework: Ενοποίηση πλαισίου παραγόντων
• microsoft-agents-a365-tooling-extensions-azureaifoundry: Ενοποίηση Azure AI Foundry
• microsoft-agents-a365-tooling-extensions-openai: Ενοποίηση OpenAI
• microsoft-agents-a365-tooling-extensions-semantickernel: Ενοποίηση σημασιολογικού πυρήνα

JavaScript

• @microsoft/agent-a365-tooling: Βασικές λειτουργίες εργαλείων
• @microsoft/agents-a365-tooling-extensions-claude: Ενοποίηση Claude
• @microsoft/agents-a365-tooling-extensions-openai: Ενοποίηση OpenAI
• @microsoft/agents-a365-tooling-extensions-langchain: Ενοποίηση LangChain

.ΔΊΧΤΥ

• Microsoft.Agents.A365.Tooling: Βασικές λειτουργίες εργαλείων
• Microsoft.Agents.A365.Tooling.Extensions.AgentFramework: Ενοποίηση πλαισίου παραγόντων
• Microsoft.Agents.A365.Tooling.Extensions.AzureAIFoundry: Ενοποίηση Azure AI Foundry
• Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel: Ενοποίηση σημασιολογικού πυρήνα

Σημείωμα

Ο έλεγχος ταυτότητας ρυθμίζεται αυτόματα από τον παράγοντα 365 CLI κατά την εκτέλεση a365 develop add-mcp-serversτου . Οι εμβέλειες OAuth και οι τιμές ακροατηρίου ανακτώνται από τον κατάλογο διακομιστών MCP και περιλαμβάνονται στο ToolingManifest.json. Οι μέθοδοι επέκτασης χρησιμοποιούν αυτόματα αυτές τις τιμές για να ρυθμίσουν τον έλεγχο ταυτότητας - δεν απαιτείται μη αυτόματη ρύθμιση παραμέτρων.

Για αναλυτικά παραδείγματα υλοποίησης, ανατρέξτε στο θέμα Δείγματα παράγοντα 365.

Παραδείγματα υλοποίησης

Τα παρακάτω παραδείγματα δείχνουν πώς μπορείτε να ενσωματώσετε τον Παράγοντα 365 Tooling με διαφορετικά πλαίσια ενορχήστρωσης.

Python

Python με OpenAI

Αυτό το παράδειγμα δείχνει πώς μπορείτε να ενσωματώσετε εργαλεία MCP με το OpenAI σε μια εφαρμογή Python.

Προσθήκη δήλωσης εισαγωγής.

Προσθέστε τις απαιτούμενες εισαγωγές για πρόσβαση στη λειτουργική μονάδα εργαλείων και τις επεκτάσεις OpenAI:

from microsoft.agents.a365.tooling import McpToolServerConfigurationService
from microsoft.agents.a365.tooling.extensions.openai import mcp_tool_registration_service

2. Προετοιμασία υπηρεσιών εργαλείων

Δημιουργήστε παρουσίες των υπηρεσιών ρύθμισης παραμέτρων και καταχώρησης εργαλείων:

# Create configuration service and tool service with dependency injection
self.config_service = McpToolServerConfigurationService()
self.tool_service = mcp_tool_registration_service.McpToolRegistrationService()

3. Καταχώρηση εργαλείων MCP με τον παράγοντα OpenAI

Χρησιμοποιήστε τη add_tool_servers_to_agent μέθοδο για να καταχωρήσετε όλα τα ρυθμισμένα εργαλεία MCP στον πράκτορά σας OpenAI. Αυτή η μέθοδος χειρίζεται σενάρια παράγοντα και μηγενικού ελέγχου ταυτότητας:

async def setup_mcp_servers(self, auth: Authorization, context: TurnContext):
    """Set up MCP server connections"""
    try:
        use_agentic_auth = os.getenv("USE_AGENTIC_AUTH", "false").lower() == "true"
        if use_agentic_auth:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
            )
        else:
            self.agent = await self.tool_service.add_tool_servers_to_agent(
                agent=self.agent,
                agentic_app_id=agentic_app_id,
                auth=auth,
                context=context,
                auth_token=self.auth_options.bearer_token,
            )

    except Exception as e:
        logger.error(f"Error setting up MCP servers: {e}")

Παράμετροι μεθόδου

Ο παρακάτω πίνακας περιγράφει τις παραμέτρους που πρέπει να λάβετε υπόψη.

Παράμετροι	Περιγραφές
agent	Η παρουσία του παράγοντα OpenAI με την οποία θα γίνει εγγραφή εργαλείων.
agentic_app_id	Το μοναδικό αναγνωριστικό για τον παράγοντα (αναγνωριστικό εφαρμογής παράγοντα).
auth	Το περιβάλλον εξουσιοδότησης για τον χρήστη.
context	Η τρέχουσα συζήτηση ενεργοποιεί το περιβάλλον από το SDK Agent. Παρέχει ταυτότητα χρήστη, μετα-δεδομένα συνομιλίας και περιβάλλον ελέγχου ταυτότητας για ασφαλή καταχώρηση εργαλείου.
auth_token	(Προαιρετικό) Διακριτικό φορέα για σενάρια μηγενούς ελέγχου ταυτότητας.

4. Κλήση κατά την προετοιμασία

Βεβαιωθείτε ότι καλείτε τη μέθοδο ρύθμισης κατά τη διάρκεια της προετοιμασίας προτού εκτελέσετε τον παράγοντα:

# Setup MCP servers during initialization
await self.setup_mcp_servers(auth, context)

Η add_tool_servers_to_agent μέθοδος αυτόματα:

• Φορτώνει όλους τους διακομιστές MCP από το ToolingManifest.json
• Καταχωρεί τα εργαλεία τους με τον παράγοντα OpenAI
• Ρυθμίζει τον έλεγχο ταυτότητας με βάση τη ρύθμιση παραμέτρων της διακήρυξης
• Καθιστά τα εργαλεία διαθέσιμα για κλήση από τον πράκτορά σας

JavaScript

JavaScript με LangChain

Αυτό το παράδειγμα δείχνει πώς μπορείτε να ενσωματώσετε εργαλεία MCP με το LangChain σε μια εφαρμογή JavaScript/TypeScript.

Προσθήκη δήλωσης εισαγωγής.

Προσθέστε τις απαιτούμενες εισαγωγές για πρόσβαση στη λειτουργική μονάδα εργαλείων και τις επεκτάσεις LangChain:

import { McpToolServerConfigurationService } from '@microsoft/agents-a365-tooling';
import { McpToolRegistrationService } from '@microsoft/agents-a365-tooling-extensions-langchain';

2. Προετοιμασία υπηρεσιών εργαλείων

Δημιουργήστε μια παρουσία της υπηρεσίας καταχώρησης εργαλείου:

const toolService = new McpToolRegistrationService();

3. Καταχώρηση εργαλείων MCP με τον πράκτορα LangChain

Χρησιμοποιήστε τη addToolServersToAgent μέθοδο για να καταχωρήσετε όλα τα ρυθμισμένα εργαλεία MCP με τον παράγοντα LangChain. Αυτή η μέθοδος χειρίζεται σενάρια παράγοντα και μηγενικού ελέγχου ταυτότητας:

// Get MCP Tools
try {
  const agent = await toolService.addToolServersToAgent(
    agent,
    process.env.AGENTIC_USER_ID || '',
    authorization,
    turnContext,
    process.env.MCP_AUTH_TOKEN || "",
  );
} catch (error) {
  console.error('Error adding MCP tool servers:', error);
}

Παράμετροι μεθόδου

Ο παρακάτω πίνακας περιγράφει τις παραμέτρους που θα χρησιμοποιηθούν με τη addToolServersToAgent μέθοδο .

Παράμετροι	Περιγραφές
agent	Η παρουσία του LangChain ReactAgent με την οποία θα γίνει εγγραφή εργαλείων.
agentUserId	Το μοναδικό αναγνωριστικό για την παλέτα. Μπορεί να είναι μια κενή συμβολοσειρά ('') εάν δεν χρησιμοποιείτε έλεγχο ταυτότητας παράγοντα.
authorization	Το περιβάλλον εξουσιοδότησης για τον χρήστη.
turnContext	Η τρέχουσα συζήτηση ενεργοποιεί το περιβάλλον από το SDK Agent. Παρέχει ταυτότητα χρήστη, μετα-δεδομένα συνομιλίας και περιβάλλον ελέγχου ταυτότητας για ασφαλή καταχώρηση εργαλείου.
authToken	(Προαιρετικό) Διακριτικό φορέα για σενάρια μηγενούς ελέγχου ταυτότητας.

4. Κλήση κατά την προετοιμασία

Καλέστε τη μέθοδο κατά την addToolServersToAgent προετοιμασία για να καταχωρήσετε τα εργαλεία MCP στον πράκτορά σας.

Η addToolServersToAgent μέθοδος αυτόματα:

• Φορτώνει όλους τους διακομιστές MCP από το ToolingManifest.json
• Καταχωρεί τα εργαλεία τους με τον παράγοντα LangChain
• Ρυθμίζει τον έλεγχο ταυτότητας με βάση τη ρύθμιση παραμέτρων της διακήρυξης
• Καθιστά τα εργαλεία διαθέσιμα για κλήση από τον πράκτορά σας

.ΔΊΧΤΥ

.NET με σημασιολογικό πυρήνα

Αυτό το παράδειγμα δείχνει πώς μπορείτε να ενσωματώσετε εργαλεία MCP με σημασιολογικό πυρήνα σε μια εφαρμογή .NET.

Προσθήκη δήλωσης εισαγωγής.

Προσθέστε τους απαιτούμενους χώρους ονομάτων για πρόσβαση στη λειτουργική μονάδα Εργαλείων και τις Επεκτάσεις σημασιολογικού πυρήνα:

using Microsoft.Agents.A365.Tooling;
using Microsoft.Agents.A365.Tooling.Extensions.SemanticKernel;

2. Καταχώρηση υπηρεσιών με ένεση εξάρτησης

Προσθέστε τις υπηρεσίες εργαλείων στο κοντέινερ ένεσης εξάρτησης σας, ώστε να μπορούν να εισαχθούν στις σας:

builder.Services.AddSingleton<IMcpToolRegistrationService, McpToolRegistrationService>();
builder.Services.AddSingleton<IMcpToolServerConfigurationService, McpToolServerConfigurationService>();

3. Προσθήκη δήλωσης ιδιωτικού πεδίου

Δηλώστε ένα ιδιωτικό πεδίο ώστε να διατηρεί την αναφορά υπηρεσίας καταχώρησης του εργαλείου:

private readonly IMcpToolRegistrationService _toolsService;

4. Καταχώρηση εργαλείων MCP με σημασιολογικό πυρήνα

Χρησιμοποιήστε τη AddToolServersToAgentAsync μέθοδο επέκτασης για να καταχωρήσετε όλα τα ρυθμισμένα εργαλεία MCP με την παρουσία σημασιολογικού πυρήνα. Αυτή η μέθοδος χειρίζεται σενάρια παράγοντα και μηγενικού ελέγχου ταυτότητας:

// Simplified call (authentication configured automatically)
await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, turnContext);

// Or with explicit authentication parameters:
if (useAgenticAuth)
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext);
}
else
{
    await toolService.AddToolServersToAgentAsync(kernel, userAuthorization, authHandlerName, turnContext, authToken);
}

Σημείωμα

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

Παράμετροι μεθόδου

Ο παρακάτω πίνακας περιγράφει τις παραμέτρους που πρέπει να λάβετε υπόψη.

Παράμετροι	Περιγραφές
kernel	Η παρουσία Σημασιολογικού πυρήνα με την οποία θα καταχωρήσετε εργαλεία. Ο Πυρήνας ενορχηστρώνει τις υπηρεσίες AI, τις προσθήκες και την εκτέλεση συναρτήσεων.
userAuthorization	Το περιβάλλον εξουσιοδότησης για τον χρήστη
authHandlerName	Όνομα χειρισμού ελέγχου ταυτότητας για χρήση με το σύστημα ελέγχου ταυτότητας χρήστη
turnContext	Το τρέχον περιβάλλον στροφής συνομιλίας (ένα μήνυμα χρήστη και ένας κύκλος απόκρισης αντιπροσώπων) από το SDK αντιπροσώπων. Παρέχει ταυτότητα χρήστη, μετα-δεδομένα συνομιλίας και περιβάλλον ελέγχου ταυτότητας για ασφαλή καταχώρηση εργαλείου.
authToken	(Προαιρετικό) Διακριτικό φορέα για σενάρια μηγενικού ελέγχου ταυτότητας

Η AddToolServersToAgentAsync μέθοδος αυτόματα:

• Φορτώνει όλους τους διακομιστές MCP από το ToolingManifest.json
• Καταχωρεί τα εργαλεία τους με τον σημασιολογικό πυρήνα
• Ρυθμίζει τον έλεγχο ταυτότητας με βάση τη ρύθμιση παραμέτρων της διακήρυξης
• Καθιστά τα εργαλεία διαθέσιμα για κλήση από τον πράκτορά σας

Για πλήρη παραδείγματα εργασίας, ανατρέξτε στο αποθετήριο δεδομένων Δείγματα παράγοντα 365.

Δοκιμή και παρακολούθηση

Δοκιμή του παράγοντά σας

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

Προσθήκη παρατηρησιμότητας

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