McpToolRegistrationService class

Construa um McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<LangChainToolingConfiguration>)

Parâmetros

Registra os servidores de ferramentas MCP e atualiza as opções do agente com ferramentas descobertas e configurações de servidor. Chame isso para habilitar o acesso dinâmico à ferramenta LangChain com base no ambiente MCP atual.

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

Retornos

A instância do Agente atualizada com servidores MCP registrados.

Envia o histórico de chat de um LangGraph CompiledStateGraph para a plataforma MCP.

Esta é a API de nível mais alto e mais fácil de usar. Ele recupera o estado atual do grafo, extrai mensagens, as converte no formato ChatHistoryMessage e as envia para a plataforma MCP para proteção contra ameaças em tempo real.

Exemplo

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

Retornos

Uma promessa de resolução para um OperationResult que indica êxito ou falha.

Recupera mensagens de uma instância do BaseChatMessageHistory e as envia para a plataforma MCP.

Use essa API ao trabalhar com abstrações de memória de LangChain (por exemplo, InMemoryChatMessageHistory, RedisChatMessageHistory etc.).

Exemplo

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

Retornos

Uma promessa de resolução para um OperationResult que indica êxito ou falha.

Envia uma matriz de mensagens LangChain para a plataforma MCP para proteção contra ameaças em tempo real.

Esta é a API de nível mais baixo que aceita matrizes BaseMessage brutas. Use isso quando você já tiver extraído mensagens ou tiver uma fonte de mensagem personalizada não coberta pelas APIs de nível superior.

Esse método converte a matriz BaseMessage fornecida em formato ChatHistoryMessage e os envia para a plataforma MCP. Matrizes vazias são enviadas as-is para registrar a mensagem do usuário na plataforma.

Exemplo

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

Retornos

Uma promessa de resolução para um OperationResult que indica êxito ou falha.

Extrai mensagens de um LangGraph StateSnapshot e as envia para a plataforma MCP.

Use essa API quando você já tiver um StateSnapshot (por exemplo, de uma chamada anterior graph.getState() ) e quiser evitar buscar o estado novamente.

Exemplo

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

Retornos

Uma promessa de resolução para um OperationResult que indica êxito ou falha.