McpToolRegistrationService class

Paquet:
@microsoft/agents-a365-tooling-extensions-openai

Découvrez les serveurs MCP et les outils de liste mis en forme pour le Kit de développement logiciel (SDK) Des agents OpenAI. Utilise listToolServers pour récupérer des configurations de serveur.

Constructeurs

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Construisez un McpToolRegistrationService.

Méthodes

addToolServersToAgent(Agent<unknown, "text">, Authorization, string, TurnContext, string)

Inscrit les serveurs d’outils MCP et met à jour les options de l’agent avec les outils découverts et les configurations de serveur. Appelez-le pour activer l’accès dynamique aux outils OpenAI en fonction de l’environnement MCP actuel.
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Envoie l’historique des conversations d’une session OpenAI à la plateforme MCP pour la protection contre les menaces en temps réel.

Cette méthode extrait les messages de la session OpenAI fournie à l’aide getItems()de , les convertit au ChatHistoryMessage format et les envoie à la plateforme MCP.

Exemple

const session = new OpenAIConversationsSession(sessionOptions);
const result = await service.sendChatHistoryAsync(turnContext, session, 50);
if (result.succeeded) {
  console.log('Chat history sent successfully');
} else {
  console.error('Failed to send chat history:', result.errors);
}
sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Envoie une liste de messages OpenAI à la plateforme MCP pour la protection contre les menaces en temps réel.

Cette méthode convertit les messages AgentInputItem fournis en format ChatHistoryMessage et les envoie à la plateforme MCP.

Exemple

const items = await session.getItems();
const result = await service.sendChatHistoryMessagesAsync(turnContext, items);

Détails du constructeur

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Construisez un McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

Paramètres

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

Fournisseur de configuration facultatif. La valeur par défaut est defaultOpenAIToolingConfigurationProvider si elle n’est pas spécifiée.

Détails de la méthode

addToolServersToAgent(Agent<unknown, "text">, Authorization, string, TurnContext, string)

Inscrit les serveurs d’outils MCP et met à jour les options de l’agent avec les outils découverts et les configurations de serveur. Appelez-le pour activer l’accès dynamique aux outils OpenAI en fonction de l’environnement MCP actuel.

function addToolServersToAgent(agent: Agent<unknown, "text">, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<Agent<unknown, "text">>

Paramètres

agent

Agent<unknown, "text">

Instance de l’agent OpenAI à laquelle les serveurs MCP seront ajoutés.

authorization
Authorization

Objet d’autorisation pour l’échange de jetons.

authHandlerName

string

Nom du gestionnaire d’authentification à utiliser pour l’échange de jetons.

turnContext
TurnContext

TurnContext de la requête actuelle.

authToken

string

Jeton du porteur facultatif pour l’accès au serveur MCP.

Retours

Promise<Agent<unknown, "text">>

Instance de l’agent mise à jour avec des serveurs MCP inscrits.

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Envoie l’historique des conversations d’une session OpenAI à la plateforme MCP pour la protection contre les menaces en temps réel.

Cette méthode extrait les messages de la session OpenAI fournie à l’aide getItems()de , les convertit au ChatHistoryMessage format et les envoie à la plateforme MCP.

Exemple

const session = new OpenAIConversationsSession(sessionOptions);
const result = await service.sendChatHistoryAsync(turnContext, session, 50);
if (result.succeeded) {
  console.log('Chat history sent successfully');
} else {
  console.error('Failed to send chat history:', result.errors);
}

function sendChatHistoryAsync(turnContext: TurnContext, session: OpenAIConversationsSession, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

Paramètres

turnContext
TurnContext

Contexte de tour contenant des informations de conversation.

session
OpenAIConversationsSession

Instance de session OpenAI à partir de laquelle extraire les messages.

limit

number

Limite facultative du nombre de messages à récupérer à partir de la session.

toolOptions
ToolOptions

Options d’outil facultatives pour la personnalisation.

Retours

Promise<OperationResult>

Résolution d’une promesse sur une opérationResult indiquant la réussite ou l’échec.

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Envoie une liste de messages OpenAI à la plateforme MCP pour la protection contre les menaces en temps réel.

Cette méthode convertit les messages AgentInputItem fournis en format ChatHistoryMessage et les envoie à la plateforme MCP.

Exemple

const items = await session.getItems();
const result = await service.sendChatHistoryMessagesAsync(turnContext, items);

function sendChatHistoryMessagesAsync(turnContext: TurnContext, messages: AgentInputItem[], toolOptions?: ToolOptions): Promise<OperationResult>

Paramètres

turnContext
TurnContext

Contexte de tour contenant des informations de conversation.

messages

AgentInputItem[]

Tableau de messages AgentInputItem à envoyer.

toolOptions
ToolOptions

ToolOptions facultatifs pour la personnalisation.

Retours

Promise<OperationResult>

Résolution d’une promesse sur une opérationResult indiquant la réussite ou l’échec.