Freigeben über

McpToolRegistrationService class

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

Entdecken Sie MCP-Server und Listentools, die für das OpenAI Agents SDK formatiert sind. Verwendet listToolServers zum Abrufen von Serverkonfigurationen.

Konstruktoren

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Erstellen Sie einen McpToolRegistrationService.

Methoden

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

Registriert MCP-Toolserver und aktualisiert Agent-Optionen mit ermittelten Tools und Serverkonfigurationen. Rufen Sie dies auf, um den dynamischen OpenAI-Toolzugriff basierend auf der aktuellen MCP-Umgebung zu aktivieren.
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Sendet den Chatverlauf von einer OpenAI-Sitzung an die MCP-Plattform für den Echtzeit-Bedrohungsschutz.

Mit dieser Methode werden Nachrichten aus der bereitgestellten OpenAI-Sitzung extrahiert getItems(), in das ChatHistoryMessage Format konvertiert und an die MCP-Plattform gesendet.

Beispiel

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)

Sendet eine Liste von OpenAI-Nachrichten an die MCP-Plattform für den Echtzeit-Bedrohungsschutz.

Diese Methode konvertiert die bereitgestellten AgentInputItem-Nachrichten in ChatHistoryMessage das Format und sendet sie an die MCP-Plattform.

Beispiel

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

Details zum Konstruktor

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Erstellen Sie einen McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

Parameter

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

Optionaler Konfigurationsanbieter. Standardwert ist "defaultOpenAIToolingConfigurationProvider", falls nicht angegeben.

Details zur Methode

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

Registriert MCP-Toolserver und aktualisiert Agent-Optionen mit ermittelten Tools und Serverkonfigurationen. Rufen Sie dies auf, um den dynamischen OpenAI-Toolzugriff basierend auf der aktuellen MCP-Umgebung zu aktivieren.

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

Parameter

agent

Agent<unknown, "text">

Die OpenAI-Agent-Instanz, zu der MCP-Server hinzugefügt werden.

authorization
Authorization

Autorisierungsobjekt für den Tokenaustausch.

authHandlerName

string

Der Name des Authentifizierungshandlers, der für den Tokenaustausch verwendet werden soll.

turnContext
TurnContext

Der TurnContext der aktuellen Anforderung.

authToken

string

Optionales Bearertoken für DEN MCP-Serverzugriff.

Gibt zurück

Promise<Agent<unknown, "text">>

Die aktualisierte Agent-Instanz mit registrierten MCP-Servern.

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Sendet den Chatverlauf von einer OpenAI-Sitzung an die MCP-Plattform für den Echtzeit-Bedrohungsschutz.

Mit dieser Methode werden Nachrichten aus der bereitgestellten OpenAI-Sitzung extrahiert getItems(), in das ChatHistoryMessage Format konvertiert und an die MCP-Plattform gesendet.

Beispiel

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>

Parameter

turnContext
TurnContext

Der Turnkontext, der Unterhaltungsinformationen enthält.

session
OpenAIConversationsSession

Die OpenAI-Sitzungsinstanz zum Extrahieren von Nachrichten aus.

limit

number

Optionaler Grenzwert für die Anzahl der Nachrichten, die aus der Sitzung abgerufen werden sollen.

toolOptions
ToolOptions

Optionale Tooloptionen für die Anpassung.

Gibt zurück

Promise<OperationResult>

Eine Zusage, die in ein OperationResult aufgelöst wird, das den Erfolg oder Fehler angibt.

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Sendet eine Liste von OpenAI-Nachrichten an die MCP-Plattform für den Echtzeit-Bedrohungsschutz.

Diese Methode konvertiert die bereitgestellten AgentInputItem-Nachrichten in ChatHistoryMessage das Format und sendet sie an die MCP-Plattform.

Beispiel

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

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

Parameter

turnContext
TurnContext

Der Turnkontext, der Unterhaltungsinformationen enthält.

messages

AgentInputItem[]

Array von zu sendenden AgentInputItem-Nachrichten.

toolOptions
ToolOptions

Optionale ToolOptions zum Anpassen.

Gibt zurück

Promise<OperationResult>

Eine Zusage, die in ein OperationResult aufgelöst wird, das den Erfolg oder Fehler angibt.