utility โมดูล

มีฟังก์ชันอรรถประโยชน์สําหรับคอมโพเนนต์ Tooling

ฟังก์ชัน

build_mcp_server_url

สร้าง URL เซิร์ฟเวอร์ MCP แบบเต็มโดยใช้ URL พื้นฐานและชื่อเซิร์ฟเวอร์

build_mcp_server_url(server_name: str) -> str

พารามิเตอร์

ชื่อ	คำอธิบาย
server_name จำเป็น	str ชื่อเซิร์ฟเวอร์ MCP

การส่งคืน

พิมพ์	คำอธิบาย
str	URL แบบเต็มของเซิร์ฟเวอร์ MCP

get_chat_history_endpoint

รับ URL จุดสิ้นสุดประวัติการแชทสําหรับการส่งประวัติการแชทไปยังแพลตฟอร์ม MCP

get_chat_history_endpoint() -> str

การส่งคืน

พิมพ์	คำอธิบาย
str	URL จุดสิ้นสุดประวัติการแชท

get_mcp_base_url

รับ URL พื้นฐานสําหรับเซิร์ฟเวอร์ MCP

get_mcp_base_url() -> str

การส่งคืน

พิมพ์	คำอธิบาย
str	URL พื้นฐานสําหรับเซิร์ฟเวอร์ MCP

get_mcp_platform_authentication_scope

รับขอบเขตการรับรองความถูกต้องแพลตฟอร์ม MCP

get_mcp_platform_authentication_scope() -> list[str]

การส่งคืน

พิมพ์	คำอธิบาย
list[str]	รายการที่มีขอบเขตการรับรองความถูกต้องแพลตฟอร์ม MCP ที่เหมาะสม

get_tooling_gateway_for_digital_worker

รับ URL ของเกตเวย์การใช้เครื่องมือสําหรับผู้ปฏิบัติงานดิจิทัลที่ระบุ

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

พารามิเตอร์

ชื่อ	คำอธิบาย
agentic_app_id จำเป็น	str รหัสแอปเชิงตัวแทนของผู้ปฏิบัติงานดิจิทัล

การส่งคืน

พิมพ์	คำอธิบาย
str	URL ของเกตเวย์การใช้เครื่องมือสําหรับผู้ปฏิบัติงานดิจิทัล

is_development_environment

ส่งกลับ True ถ้ามีการกําหนดค่าสภาพแวดล้อมปัจจุบันเป็นการพัฒนา

ลําดับการแก้ปัญหา (ค่าที่ไม่ว่างลําดับแรก):

1. PYTHON_ENVIRONMENT — ตัวแปร Python SDK ที่ชัดเจนที่ใช้ในตัวอย่างปัจจุบัน
2. ENVIRONMENT — ตัวแปร Python SDK แบบดั้งเดิม (ความเข้ากันได้ย้อนหลัง)
3. ASPNETCORE_ENVIRONMENT — แบบแผนการโฮสต์ Azure
4. DOTNET_ENVIRONMENT — แบบแผนโฮสต์ทั่วไป
5. ค่าเริ่มต้น "Development" คือ เมื่อไม่ได้ตั้งค่าใด ๆ ด้านบน

PYTHON_ENVIRONMENT และ ENVIRONMENT จะถูกตรวจสอบก่อน เพื่อให้ตัวแทนที่กําหนดค่า ENVIRONMENT=Production ไว้ไม่ได้รับผลกระทบถ้ากระบวนการโฮสต์ยังตั้งค่า ASPNETCORE_ENVIRONMENTด้วย

is_development_environment() -> bool

การส่งคืน

พิมพ์	คำอธิบาย
bool	จริง เมื่อสภาพแวดล้อมที่แก้ไขแล้วเป็น "การพัฒนา" (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก)

resolve_token_scope_for_server

แก้ไขขอบเขต OAuth เพื่อร้องขอเซิร์ฟเวอร์ MCP ที่ระบุ

เซิร์ฟเวอร์ V2 จะแบกผู้ชมของตัวเองใน audience เขตข้อมูล (รูปแบบ GUID หรือ api:// URI เปล่า) เมื่อมีการระบุอย่างชัดเจน scope (เช่น "Tools.ListInvoke.All") ขอบเขตคือ{audience}/{scope} เมื่อไม่มีขอบเขต {audience}/.default จะถูกใช้ (ขึ้นอยู่กับขอบเขตที่ยินยอมไว้ล่วงหน้า) เซิร์ฟเวอร์ V1 (ไม่มีผู้ชม ผู้ชมเท่ากับ ATG AppId ที่ใช้ร่วมกันในรูปแบบ GUID หรือ api:// URI เปล่า) จะกลับไปใช้ขอบเขต ATG /.default ที่ใช้ร่วมกันเสมอ

resolve_token_scope_for_server(server: MCPServerConfig) -> str

พารามิเตอร์

ชื่อ	คำอธิบาย
server จำเป็น	MCPServerConfig การกําหนดค่าเซิร์ฟเวอร์ MCP เพื่อแก้ไขขอบเขต

การส่งคืน

พิมพ์	คำอธิบาย
str	สตริงขอบเขต OAuth เช่น "<guid>/Tools.ListInvoke.All""api://<guid>/.default"หรือ ATG "<atg-guid>/.default"ที่ใช้ร่วมกัน