McpToolServerConfigurationService Sınıf

MCP araç sunucusu yapılandırma yönetimi için hizmetler sağlar.

Bu hizmet, birden çok kaynaktan MCP (Model Bağlam Protokolü) araç sunucularını bulma ve yapılandırma işlemlerini işler:

Geliştirme: Yerel ToolingManifest.json dosyaları
Üretim: Uzaktan araç ağ geçidi uç noktaları

Oluşturucu

McpToolServerConfigurationService()

Parametreler

Name	Description
logger	Default value: None

Yöntemler

__init__	MCP Aracı Sunucu Yapılandırma Hizmeti'ni başlatın.
__new__
list_tool_servers	Aracı için yapılandırılan MCP Sunucularının listesini alır. , `auth_handler_name`ve `turn_context` tümü sağlandığında`authorization`, bulmadan sonra her sunucu için hedef kitle başına OAuth belirteçleri alınır: V1 sunucuları (alan yok `audience` ) paylaşılan ATG belirtecini (bir değişim) paylaşır. V2 sunucularının her biri kendi hedef kitle GUID'leri kapsamında bir belirteç alır.
send_chat_history	Gerçek zamanlı tehdit koruması için sohbet geçmişini MCP platformuna gönderir. Note chat_history_messages boş olsa bile istek MCP platformu. Bu, turn_context.activity.text'den kullanıcı iletisinin gerçek zamanlı tehdit koruması için doğru şekilde kaydedilir.

init

MCP Aracı Sunucu Yapılandırma 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. Hiçbiri ise, yeni bir günlükçü oluşturur. Default value: None

new

__new__(**kwargs)

list_tool_servers

Aracı için yapılandırılan MCP Sunucularının listesini alır.

, auth_handler_nameve turn_context tümü sağlandığındaauthorization, bulmadan sonra her sunucu için hedef kitle başına OAuth belirteçleri alınır:

V1 sunucuları (alan yok audience ) paylaşılan ATG belirtecini (bir değişim) paylaşır.
V2 sunucularının her biri kendi hedef kitle GUID'leri kapsamında bir belirteç alır.

async list_tool_servers(agentic_app_id: str, auth_token: str | None = None, options: ToolOptions | None = None, authorization: Authorization | None = None, auth_handler_name: str | None = None, turn_context: TurnContext | None = None) -> List[MCPServerConfig]

Parametreler

Name	Description
agentic_app_id Gerekli	str Aracı için aracı uygulama kimliği.
auth_token	str \| None Ağ geçidi bulma için kullanılan kimlik doğrulama belirteci. Default value: None
options	ToolOptions \| None İsteğe bağlı parametreler içeren isteğe bağlı ToolOptions örneği. Default value: None
authorization	Authorization \| None hedef kitle başına belirteç değişimi için isteğe bağlı Yetkilendirme bağlamı. Default value: None
auth_handler_name	str \| None ile `authorization`kullanılan isteğe bağlı kimlik doğrulama işleyicisi adı. Default value: None
turn_context	TurnContext \| None ile `authorization`kullanılan isteğe bağlı TurnContext. Default value: None

Döndürülenler

Tür	Description
List[MCPServerConfig]	Her biri kimlik doğrulama bağlamı sağlandığında bir üst bilgi eklenmiş olarak yapılandırılan `Authorization` MCP Sunucularının listesini döndürür.

Özel durumlar

Tür	Description
ValueError	Gerekli parametreler geçersiz veya boşsa.
Exception	Araç ağ geçidiyle iletişim kurarken bir hata varsa veya hedef kitle başına belirteç değişimi başarısız olursa.

send_chat_history

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

Note

chat_history_messages boş olsa bile istek

MCP platformu. Bu, turn_context.activity.text'den kullanıcı iletisinin

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

async send_chat_history(turn_context: TurnContext, chat_history_messages: List[ChatHistoryMessage], options: ToolOptions | None = None) -> OperationResult

Parametreler

Name	Description
turn_context Gerekli	TurnContext Konuşma bilgilerini içeren Aracılar SDK'sından TurnContext. conversation.id, activity.id ve activity.text içeren geçerli bir etkinliğe sahip olmalıdır.
chat_history_messages Gerekli	List[ChatHistoryMessage] Sohbet geçmişini temsil eden ChatHistoryMessage nesnelerinin listesi. Boş olabilir- Boş bir liste, mcp platformuna boş sohbet geçmişine sahip bir istek göndermeye devam eder.
options	ToolOptions \| None İsteğe bağlı parametreler içeren isteğe bağlı ToolOptions örneği. Default value: None

Döndürülenler

Tür	Description
<xref:OperationResult>	Başarılı veya başarısız olduğunu belirten bir OperationResult. Başarılı olduğunda OperationResult.success() döndürür. Hata durumunda, hata ayrıntılarıyla OperationResult.failed() döndürür.

Özel durumlar

Tür	Description
ValueError	turn_context Hiçbiri ise, chat_history_messages Yok, turn_context.activity Yok veya gerekli alanlardan (conversation.id, activity.id, activity.text) herhangi biri eksik veya boş olabilir.

Örnekler


>>> from datetime import datetime, timezone
>>> from microsoft_agents_a365.tooling.models import ChatHistoryMessage
>>>
>>> history = [
...     ChatHistoryMessage("msg-1", "user", "Hello", datetime.now(timezone.utc)),
...     ChatHistoryMessage("msg-2", "assistant", "Hi!", datetime.now(timezone.utc))
... ]
>>>
>>> service = McpToolServerConfigurationService()
>>> result = await service.send_chat_history(turn_context, history)
>>> if result.succeeded:
...     print("Chat history sent successfully")