McpToolRegistrationService class

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

Find MCP-servere og listeværktøjer, der er formateret til OpenAI Agents SDK. Bruger listToolServers til at hente serverkonfigurationer.

Konstruktører

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Konstruer en McpToolRegistrationService.

Metoder

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

Registrerer MCP-værktøjsservere og opdaterer agentindstillinger med fundne værktøjer og serverkonfigurationer. Kald dette for at aktivere dynamisk openAI-værktøjsadgang baseret på det aktuelle MCP-miljø.
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Sender chathistorik fra en OpenAI-session til MCP-platformen for at beskytte trusler i realtid.

Denne metode udtrækker meddelelser fra den angivne OpenAI-session ved hjælp af getItems(), konverterer dem til ChatHistoryMessage formatet og sender dem til MCP-platformen.

Eksempel

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)

Sender en liste over OpenAI-meddelelser til MCP-platformen for at beskytte trusler i realtid.

Denne metode konverterer de angivne AgentInputItem-meddelelser til ChatHistoryMessage format og sender dem til MCP-platformen.

Eksempel

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

Oplysninger om konstruktør

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Konstruer en McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

Parametre

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

Valgfri konfigurationsprovider. Standardværdier til defaultOpenAIToolingConfigurationProvider, hvis den ikke er angivet.

Oplysninger om metode

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

Registrerer MCP-værktøjsservere og opdaterer agentindstillinger med fundne værktøjer og serverkonfigurationer. Kald dette for at aktivere dynamisk openAI-værktøjsadgang baseret på det aktuelle MCP-miljø.

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

Parametre

agent

Agent<unknown, "text">

Den OpenAI Agent-forekomst, som MCP-servere føjes til.

authorization
Authorization

Autorisationsobjekt for tokenudveksling.

authHandlerName

string

Navnet på den godkendelseshandler, der skal bruges til tokenudveksling.

turnContext
TurnContext

TurnContext for den aktuelle anmodning.

authToken

string

Valgfrit ihændehavertoken til MCP-serveradgang.

Returnerer

Promise<Agent<unknown, "text">>

Den opdaterede Agent-forekomst med registrerede MCP-servere.

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Sender chathistorik fra en OpenAI-session til MCP-platformen for at beskytte trusler i realtid.

Denne metode udtrækker meddelelser fra den angivne OpenAI-session ved hjælp af getItems(), konverterer dem til ChatHistoryMessage formatet og sender dem til MCP-platformen.

Eksempel

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>

Parametre

turnContext
TurnContext

Den turn-kontekst, der indeholder samtaleoplysninger.

session
OpenAIConversationsSession

OpenAI-sessionen, der skal udtrækkes meddelelser fra.

limit

number

Valgfri grænse for antallet af meddelelser, der skal hentes fra sessionen.

toolOptions
ToolOptions

Valgfrie værktøjsindstillinger til tilpasning.

Returnerer

Promise<OperationResult>

En Promise-løsning til en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes.

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Sender en liste over OpenAI-meddelelser til MCP-platformen for at beskytte trusler i realtid.

Denne metode konverterer de angivne AgentInputItem-meddelelser til ChatHistoryMessage format og sender dem til MCP-platformen.

Eksempel

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

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

Parametre

turnContext
TurnContext

Den turn-kontekst, der indeholder samtaleoplysninger.

messages

AgentInputItem[]

Matrix af AgentInputItem-meddelelser, der skal sendes.

toolOptions
ToolOptions

Valgfrie ToolOptions til tilpasning.

Returnerer

Promise<OperationResult>

En Promise-løsning til en OperationResult, der angiver, om handlingen lykkedes eller mislykkedes.