McpToolRegistrationService class
OpenAI Agents SDK 用にフォーマットされた MCP サーバーとリスト ツールを検出します。 listToolServers を使用してサーバー構成をフェッチします。
コンストラクター
| Mcp |
McpToolRegistrationService を構築します。 |
メソッド
| add |
MCP ツール サーバーを登録し、検出されたツールとサーバー構成でエージェント オプションを更新します。 これを呼び出して、現在の MCP 環境に基づいて動的な OpenAI ツール アクセスを有効にします。 |
| send |
リアルタイムの脅威保護のために、OpenAI セッションから MCP プラットフォームにチャット履歴を送信します。 このメソッドは、 例
|
| send |
リアルタイムの脅威保護のために、OpenAI メッセージの一覧を MCP プラットフォームに送信します。 このメソッドは、指定された AgentInputItem メッセージを 例
|
コンストラクターの詳細
McpToolRegistrationService(IConfigurationProvider<OpenAIToolingConfiguration>)
McpToolRegistrationService を構築します。
new McpToolRegistrationService(configProvider?: IConfigurationProvider<OpenAIToolingConfiguration>)
パラメーター
- configProvider
オプションの構成プロバイダー。 指定しない場合、既定値は defaultOpenAIToolingConfigurationProvider になります。
メソッドの詳細
addToolServersToAgent(Agent<unknown, "text">, Authorization, string, TurnContext, string)
MCP ツール サーバーを登録し、検出されたツールとサーバー構成でエージェント オプションを更新します。 これを呼び出して、現在の MCP 環境に基づいて動的な OpenAI ツール アクセスを有効にします。
function addToolServersToAgent(agent: Agent<unknown, "text">, authorization: Authorization, authHandlerName: string, turnContext: TurnContext, authToken: string): Promise<Agent<unknown, "text">>
パラメーター
- agent
-
Agent<unknown, "text">
MCP サーバーの追加先となる OpenAI エージェント インスタンス。
- authorization
- Authorization
トークン交換の承認オブジェクト。
- authHandlerName
-
string
トークン交換に使用する認証ハンドラーの名前。
- turnContext
- TurnContext
現在の要求の TurnContext。
- authToken
-
string
MCP サーバー アクセス用のオプションのベアラー トークン。
返品
Promise<Agent<unknown, "text">>
登録済みの MCP サーバーを含む更新されたエージェント インスタンス。
sendChatHistoryAsync(TurnContext, OpenAIConversationsSession, number, ToolOptions)
リアルタイムの脅威保護のために、OpenAI セッションから MCP プラットフォームにチャット履歴を送信します。
このメソッドは、 getItems()を使用して指定された OpenAI セッションからメッセージを抽出し、 ChatHistoryMessage 形式に変換して、MCP プラットフォームに送信します。
例
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>
パラメーター
- turnContext
- TurnContext
会話情報を含むターン コンテキスト。
- session
- OpenAIConversationsSession
メッセージを抽出する OpenAI セッション インスタンス。
- limit
-
number
セッションから取得するメッセージの数に関するオプションの制限。
- toolOptions
- ToolOptions
カスタマイズのためのオプションのツール オプション。
返品
Promise<OperationResult>
成功または失敗を示す OperationResult に解決する Promise。
sendChatHistoryMessagesAsync(TurnContext, AgentInputItem[], ToolOptions)
リアルタイムの脅威保護のために、OpenAI メッセージの一覧を MCP プラットフォームに送信します。
このメソッドは、指定された AgentInputItem メッセージを ChatHistoryMessage 形式に変換し、MCP プラットフォームに送信します。
例
const items = await session.getItems();
const result = await service.sendChatHistoryMessagesAsync(turnContext, items);
function sendChatHistoryMessagesAsync(turnContext: TurnContext, messages: AgentInputItem[], toolOptions?: ToolOptions): Promise<OperationResult>
パラメーター
- turnContext
- TurnContext
会話情報を含むターン コンテキスト。
- messages
-
AgentInputItem[]
送信する AgentInputItem メッセージの配列。
- toolOptions
- ToolOptions
カスタマイズ用の省略可能な ToolOptions。
返品
Promise<OperationResult>
成功または失敗を示す OperationResult に解決する Promise。