McpToolRegistrationService class

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

Individuare i server MCP ed elencare gli strumenti formattati per OpenAI Agents SDK. Usa listToolServers per recuperare le configurazioni del server.

Costruttori

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Costruire un McpToolRegistrationService.

Metodi

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

Registra i server degli strumenti MCP e aggiorna le opzioni dell'agente con gli strumenti individuati e le configurazioni del server. Chiamare questa opzione per abilitare l'accesso dinamico allo strumento OpenAI in base all'ambiente MCP corrente.
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Invia la cronologia delle chat da una sessione OpenAI alla piattaforma MCP per la protezione dalle minacce in tempo reale.

Questo metodo estrae i messaggi dalla sessione OpenAI fornita usando getItems(), li converte nel ChatHistoryMessage formato e li invia alla piattaforma MCP.

Esempio

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)

Invia un elenco di messaggi OpenAI alla piattaforma MCP per la protezione dalle minacce in tempo reale.

Questo metodo converte i messaggi AgentInputItem forniti in ChatHistoryMessage formato e li invia alla piattaforma MCP.

Esempio

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

Dettagli costruttore

McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)

Costruire un McpToolRegistrationService.

new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)

Parametri

configProvider

IConfigurationProvider<OpenAIToolingConfiguration>

Provider di configurazione facoltativo. Il valore predefinito è defaultOpenAIToolingConfigurationProvider, se non specificato.

Dettagli metodo

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

Registra i server degli strumenti MCP e aggiorna le opzioni dell'agente con gli strumenti individuati e le configurazioni del server. Chiamare questa opzione per abilitare l'accesso dinamico allo strumento OpenAI in base all'ambiente MCP corrente.

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

Parametri

agent

Agent<unknown, "text">

Istanza dell'agente OpenAI a cui verranno aggiunti i server MCP.

authorization
Authorization

Oggetto di autorizzazione per lo scambio di token.

authHandlerName

string

Nome del gestore di autenticazione da usare per lo scambio di token.

turnContext
TurnContext

TurnContext della richiesta corrente.

authToken

string

Token di connessione facoltativo per l'accesso al server MCP.

Valori restituiti

Promise<Agent<unknown, "text">>

Istanza aggiornata di Agent con server MCP registrati.

sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)

Invia la cronologia delle chat da una sessione OpenAI alla piattaforma MCP per la protezione dalle minacce in tempo reale.

Questo metodo estrae i messaggi dalla sessione OpenAI fornita usando getItems(), li converte nel ChatHistoryMessage formato e li invia alla piattaforma MCP.

Esempio

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>

Parametri

turnContext
TurnContext

Contesto del turno contenente informazioni sulla conversazione.

session
OpenAIConversationsSession

Istanza della sessione OpenAI da cui estrarre i messaggi.

limit

number

Limite facoltativo per il numero di messaggi da recuperare dalla sessione.

toolOptions
ToolOptions

Opzioni facoltative dello strumento per la personalizzazione.

Valori restituiti

Promise<OperationResult>

Promessa che viene risolta in un oggetto OperationResult che indica l'esito positivo o negativo.

sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)

Invia un elenco di messaggi OpenAI alla piattaforma MCP per la protezione dalle minacce in tempo reale.

Questo metodo converte i messaggi AgentInputItem forniti in ChatHistoryMessage formato e li invia alla piattaforma MCP.

Esempio

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

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

Parametri

turnContext
TurnContext

Contesto del turno contenente informazioni sulla conversazione.

messages

AgentInputItem[]

Matrice di messaggi AgentInputItem da inviare.

toolOptions
ToolOptions

Facoltativo ToolOptions per la personalizzazione.

Valori restituiti

Promise<OperationResult>

Promessa che viene risolta in un oggetto OperationResult che indica l'esito positivo o negativo.