McpToolRegistrationService class

Construya un McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<LangChainToolingConfiguration>)

Parámetros

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

function addToolServersToAgent(agent: ReactAgent<AgentTypeConfig<Record<string, any>, undefined, AnyAnnotationRoot, readonly AgentMiddleware<any, any, any, readonly (ClientTool | ServerTool)[]>[], readonly (ClientTool | ServerTool)[]>>, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<ReactAgent<AgentTypeConfig<Record<string, any>, undefined, AnyAnnotationRoot, readonly AgentMiddleware<any, any, any, readonly (ClientTool | ServerTool)[]>[], readonly (ClientTool | ServerTool)[]>>>

Parámetros

Devoluciones

Instancia del agente actualizada con servidores MCP registrados.

Envía el historial de chat de un LangGraph CompiledStateGraph a la plataforma MCP.

Esta es la API de nivel más alto y más fácil de usar. Recupera el estado actual del gráfico, extrae mensajes, los convierte en formato ChatHistoryMessage y los envía a la plataforma MCP para la protección contra amenazas en tiempo real.

Ejemplo

const config = { configurable: { thread_id: '1' } };
const result = await service.sendChatHistoryAsync(turnContext, graph, config);
if (result.succeeded) {
  console.log('Chat history sent successfully');
}

function sendChatHistoryAsync(turnContext: TurnContext, graph: CompiledStateGraph<unknown, unknown, string, StateDefinition, StateDefinition, StateDefinition, unknown, unknown, unknown>, config: RunnableConfig<Record<string, any>>, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

Parámetros

Devoluciones

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

Recupera mensajes de una instancia de BaseChatMessageHistory y los envía a la plataforma MCP.

Use esta API al trabajar con abstracciones de memoria de LangChain (por ejemplo, InMemoryChatMessageHistory, RedisChatMessageHistory, etc.).

Ejemplo

const chatHistory = new InMemoryChatMessageHistory();
// ... add messages to history ...
const result = await service.sendChatHistoryFromChatHistoryAsync(turnContext, chatHistory);

function sendChatHistoryFromChatHistoryAsync(turnContext: TurnContext, chatHistory: BaseChatMessageHistory, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

Parámetros

Devoluciones

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

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

Esta es la API de nivel más bajo que acepta matrices BaseMessage sin procesar. Úselo cuando ya haya extraído mensajes o tenga un origen de mensajes personalizado no cubierto por las API de nivel superior.

Este método convierte la matriz BaseMessage proporcionada en formato ChatHistoryMessage y las envía a la plataforma MCP. Las matrices vacías se envían as-is para registrar el mensaje de usuario con la plataforma.

Ejemplo

const messages = await messageHistory.getMessages();
const result = await service.sendChatHistoryFromMessagesAsync(turnContext, messages, 50);
if (result.succeeded) {
  console.log('Chat history sent successfully');
} else {
  console.error('Failed to send chat history:', result.errors);
}

function sendChatHistoryFromMessagesAsync(turnContext: TurnContext, messages: BaseMessage<MessageStructure<MessageToolSet>, MessageType>[], limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

Parámetros

Devoluciones

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

Extrae mensajes de un objeto StateSnapshot de LangGraph y los envía a la plataforma MCP.

Use esta API cuando ya tenga stateSnapshot (por ejemplo, desde una llamada anterior graph.getState() ) y quiera evitar volver a capturar el estado.

Ejemplo

const config = { configurable: { thread_id: '1' } };
const stateSnapshot = await graph.getState(config);
const result = await service.sendChatHistoryFromStateAsync(turnContext, stateSnapshot);

function sendChatHistoryFromStateAsync(turnContext: TurnContext, stateSnapshot: StateSnapshot, limit?: number, toolOptions?: ToolOptions): Promise<OperationResult>

Parámetros

Devoluciones

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