McpToolRegistrationService クラス

OpenAI の MCP ツール登録サービスを初期化します。

__init__(logger: Logger | None = None)

パラメーター

__new__(**kwargs)

新しいエージェント インスタンスを作成して、新しい MCP サーバーをエージェントに追加します。

注: OpenAI Agents SDK の制限により、エージェントの作成時に MCP サーバーを設定する必要があります。 新しいサーバーが見つかった場合、このメソッドは、すべての MCP サーバー (既存の + 新規) が適切に初期化された新しいエージェント インスタンスを作成します。

async add_tool_servers_to_agent(agent: Agent, auth: Authorization, auth_handler_name: str, context: TurnContext, auth_token: str | None = None) -> Agent

パラメーター

返品

接続されているすべての MCP サーバーをクリーンアップする

async cleanup_all_servers() -> None

返品

OpenAI セッションからチャット履歴を抽出し、MCP プラットフォームに送信します。

このメソッドは、get_items() を使用して OpenAI セッション オブジェクトからメッセージを抽出し、リアルタイムの脅威保護のために MCP プラットフォームに送信します。

async send_chat_history(turn_context: TurnContext, session: Session, limit: int | None = None, options: ToolOptions | None = None) -> OperationResult

パラメーター

返品

例外

例

>>> from agents import Agent, Runner
>>> from microsoft_agents_a365.tooling.extensions.openai import (
...     McpToolRegistrationService
... )
>>>
>>> service = McpToolRegistrationService()
>>> agent = Agent(name="my-agent", model="gpt-4")
>>>
>>> # In your agent handler:
>>> async with Runner.run(agent, messages) as result:
...     session = result.session
...     op_result = await service.send_chat_history(
...         turn_context, session
...     )
...     if op_result.succeeded:
...         print("Chat history sent successfully")

脅威を保護するために、OpenAI チャット履歴メッセージを MCP プラットフォームに送信します。

このメソッドは、OpenAI TResponseInputItem メッセージの一覧を受け入れ、それらを ChatHistoryMessage 形式に変換して、MCP プラットフォームに送信します。

async send_chat_history_messages(turn_context: TurnContext, messages: List[EasyInputMessageParam | Message | ResponseOutputMessageParam | ResponseFileSearchToolCallParam | ResponseComputerToolCallParam | ComputerCallOutput | ResponseFunctionWebSearchParam | ResponseFunctionToolCallParam | FunctionCallOutput | ToolSearchCall | ResponseToolSearchOutputItemParamParam | ResponseReasoningItemParam | ResponseCompactionItemParamParam | ImageGenerationCall | ResponseCodeInterpreterToolCallParam | LocalShellCall | LocalShellCallOutput | ShellCall | ShellCallOutput | ApplyPatchCall | ApplyPatchCallOutput | McpListTools | McpApprovalRequest | McpApprovalResponse | McpCall | ResponseCustomToolCallOutputParam | ResponseCustomToolCallParam | ItemReference], options: ToolOptions | None = None) -> OperationResult

パラメーター

返品

例外

例

>>> from microsoft_agents_a365.tooling.extensions.openai import (
...     McpToolRegistrationService
... )
>>>
>>> service = McpToolRegistrationService()
>>> messages = [
...     {"role": "user", "content": "Hello"},
...     {"role": "assistant", "content": "Hi there!"},
... ]
>>>
>>> result = await service.send_chat_history_messages(
...     turn_context, messages
... )
>>> if result.succeeded:
...     print("Chat history sent successfully")