McpToolRegistrationService Sınıf

Agent Framework aracıları için MCP araç kayıt hizmetleri sağlar.

Bu hizmet, Aracı Çerçevesi aracılarıyla MCP (Model Bağlam Protokolü) araç sunucularının kaydını ve yönetimini işler.

Oluşturucu

McpToolRegistrationService()

Parametreler

Name	Description
logger	Default value: None

Yöntemler

__init__	Aracı Çerçevesi için MCP Araç Kayıt Hizmeti'ni başlatın.
__new__
add_tool_servers_to_agent	RawAgent'a MCP araç sunucuları ekleyin (.NET uygulamasını yansıtır).
cleanup	Hizmet tarafından kullanılan tüm kaynakları temizleyin.
send_chat_history_from_store	Bir HistoryProvider'dan MCP platformuna sohbet geçmişi gönderin. Bu, depodan iletileri ayıklayan ve send_chat_history_messages() için temsilciler sağlayan bir kolaylık yöntemidir.
send_chat_history_messages	Gerçek zamanlı tehdit koruması için MCP platformuna sohbet geçmişi iletileri gönderin. Bu, ileti dönüştürmeyi ve çekirdek araç hizmetine temsilci seçmeyi işleyen birincil uygulama yöntemidir. Note chat_messages boş olsa veya tüm iletiler dönüştürme işlemi gerçekleştirilse de istek MCP platformuna gönderilmeye devam eder. Bu turn_context.activity.text'den gelen kullanıcı iletisinin kaydedilmesini sağlar gerçek zamanlı tehdit koruması için doğru şekilde.

init

Aracı Çerçevesi için MCP Araç Kayıt Hizmeti'ni başlatın.

__init__(logger: Logger | None = None)

Parametreler

Name	Description
logger	Logger \| None Günlük işlemleri için günlükçü örneği. Default value: None

new

__new__(**kwargs)

add_tool_servers_to_agent

RawAgent'a MCP araç sunucuları ekleyin (.NET uygulamasını yansıtır).

async add_tool_servers_to_agent(chat_client: OpenAIChatClient, agent_instructions: str, initial_tools: List[object], auth: Authorization, auth_handler_name: str, turn_context: TurnContext, auth_token: str | None = None) -> RawAgent

Parametreler

Name	Description
chat_client Gerekli	<xref:OpenAIChatClient> Sohbet istemcisi örneği (OpenAIChatClient hem OpenAI hem de Azure OpenAI'yi destekler)
agent_instructions Gerekli	str Aracı davranışı yönergeleri
initial_tools Gerekli	List[object] Aracıya eklenecek ilk araçların listesi
auth Gerekli	<xref:Authorization> Belirteç değişimi için yetkilendirme bağlamı
auth_handler_name Gerekli	str Yetkilendirme işleyicisinin adı.
turn_context Gerekli	<xref:TurnContext> İşlemin bağlamını açma
auth_token	Optional[str] Kimlik doğrulaması için isteğe bağlı taşıyıcı belirteci Default value: None

Döndürülenler

Tür	Description
<xref:RawAgent>	MCP araçlarının kayıtlı olduğu RawAgent örneği.

Özel durumlar

Tür	Description
Exception	Aracı oluşturma işlemi başarısız olursa.

cleanup

Hizmet tarafından kullanılan tüm kaynakları temizleyin.

async cleanup()

send_chat_history_from_store

Bir HistoryProvider'dan MCP platformuna sohbet geçmişi gönderin.

Bu, depodan iletileri ayıklayan ve send_chat_history_messages() için temsilciler sağlayan bir kolaylık yöntemidir.

async send_chat_history_from_store(chat_message_store: HistoryProvider, turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Parametreler

Name	Description
chat_message_store Gerekli	<xref:agent_framework._sessions.HistoryProvider> Konuşma geçmişini içeren HistoryProvider.
turn_context Gerekli	TurnContext Konuşma bilgilerini içeren Aracılar SDK'sından TurnContext.
tool_options	ToolOptions \| None İstek için isteğe bağlı yapılandırma. Default value: None

Döndürülenler

Tür	Description
OperationResult	İşlemin başarılı veya başarısız olduğunu belirten OperationResult.

Özel durumlar

Tür	Description
ValueError	chat_message_store veya turn_context Hiçbiri ise.

Örnekler


>>> service = McpToolRegistrationService()
>>> result = await service.send_chat_history_from_store(
...     thread.chat_message_store, turn_context
... )

send_chat_history_messages

Gerçek zamanlı tehdit koruması için MCP platformuna sohbet geçmişi iletileri gönderin.

Bu, ileti dönüştürmeyi ve çekirdek araç hizmetine temsilci seçmeyi işleyen birincil uygulama yöntemidir.

Note

chat_messages boş olsa veya tüm iletiler

dönüştürme işlemi gerçekleştirilse de istek MCP platformuna gönderilmeye devam eder. Bu

turn_context.activity.text'den gelen kullanıcı iletisinin kaydedilmesini sağlar

gerçek zamanlı tehdit koruması için doğru şekilde.

async send_chat_history_messages(chat_messages: Sequence[Message], turn_context: TurnContext, tool_options: ToolOptions | None = None) -> OperationResult

Parametreler

Name	Description
chat_messages Gerekli	Sequence[<xref:agent_framework._types.Message>] Gönderilecek Agent Framework İleti nesnelerinin sırası. Boş olabilir- kullanıcı iletisinin turn_context.activity.text'den kaydedilmesi için istek gönderilmeye devam eder.
turn_context Gerekli	TurnContext Konuşma bilgilerini içeren Aracılar SDK'sından TurnContext.
tool_options	ToolOptions \| None İstek için isteğe bağlı yapılandırma. Sağlanmadıysa Varsayılan olarak AgentFramework'e özgü seçenekler kullanılır. Default value: None

Döndürülenler

Tür	Description
OperationResult	İşlemin başarılı veya başarısız olduğunu belirten OperationResult.

Özel durumlar

Tür	Description
ValueError	chat_messages veya turn_context Hiçbiri ise.

Örnekler


>>> service = McpToolRegistrationService()
>>> messages = [Message(role="user", text="Hello")]
>>> result = await service.send_chat_history_messages(messages, turn_context)
>>> if result.succeeded:
...     print("Chat history sent successfully")