McpToolRegistrationService class

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

Descubra los servidores MCP y las herramientas de lista con formato para el SDK de agentes de OpenAI. Usa listToolServers para capturar configuraciones del servidor.

Constructores

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Construya un McpToolRegistrationService.

Métodos

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

Registra los servidores de herramientas mcP y actualiza las opciones del agente con las herramientas detectadas y las configuraciones del servidor. Llame a esto para habilitar el acceso dinámico a la herramienta OpenAI en función del entorno de MCP actual.
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Envía el historial de chat desde una sesión de OpenAI a la plataforma MCP para la protección contra amenazas en tiempo real.

Este método extrae mensajes de la sesión de OpenAI proporcionada mediante getItems(), los convierte en el ChatHistoryMessage formato y los envía a la plataforma MCP.

Ejemplo

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)

Envía una lista de mensajes de OpenAI a la plataforma MCP para la protección contra amenazas en tiempo real.

Este método convierte los mensajes AgentInputItem proporcionados en formato ChatHistoryMessage y los envía a la plataforma MCP.

Ejemplo

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

Detalles del constructor

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Construya un McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

Parámetros

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

Proveedor de configuración opcional. El valor predeterminado es defaultOpenAIToolingConfigurationProvider si no se especifica.

Detalles del método

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

Registra los servidores de herramientas mcP y actualiza las opciones del agente con las herramientas detectadas y las configuraciones del servidor. Llame a esto para habilitar el acceso dinámico a la herramienta OpenAI en función del entorno de MCP actual.

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

Parámetros

agent

Agent<unknown, "text">

Instancia del agente de OpenAI a la que se agregarán los servidores MCP.

authorization
Authorization

Objeto de autorización para el intercambio de tokens.

authHandlerName

string

Nombre del controlador de autenticación que se va a usar para el intercambio de tokens.

turnContext
TurnContext

TurnContext de la solicitud actual.

authToken

string

Token de portador opcional para el acceso al servidor MCP.

Devoluciones

Promise<Agent<unknown, "text">>

Instancia del agente actualizada con servidores MCP registrados.

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Envía el historial de chat desde una sesión de OpenAI a la plataforma MCP para la protección contra amenazas en tiempo real.

Este método extrae mensajes de la sesión de OpenAI proporcionada mediante getItems(), los convierte en el ChatHistoryMessage formato y los envía a la plataforma MCP.

Ejemplo

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>

Parámetros

turnContext
TurnContext

Contexto de turno que contiene información de conversación.

session
OpenAIConversationsSession

Instancia de sesión de OpenAI de la que se van a extraer mensajes.

limit

number

Límite opcional en el número de mensajes que se van a recuperar de la sesión.

toolOptions
ToolOptions

Opciones de herramientas opcionales para la personalización.

Devoluciones

Promise<OperationResult>

Una promesa que se resuelve en un OperationResult que indica que se ha realizado correctamente o no.

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Envía una lista de mensajes de OpenAI a la plataforma MCP para la protección contra amenazas en tiempo real.

Este método convierte los mensajes AgentInputItem proporcionados en formato ChatHistoryMessage y los envía a la plataforma MCP.

Ejemplo

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

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

Parámetros

turnContext
TurnContext

Contexto de turno que contiene información de conversación.

messages

AgentInputItem[]

Matriz de mensajes AgentInputItem que se van a enviar.

toolOptions
ToolOptions

ToolOptions opcional para la personalización.

Devoluciones

Promise<OperationResult>

Una promesa que se resuelve en un OperationResult que indica que se ha realizado correctamente o no.