ToolingConfiguration class

แพคเกจ:

@microsoft/agents-a365-tooling

การกําหนดค่าสําหรับแพคเกจการใช้เครื่องมือ สืบทอดการตั้งค่ารันไทม์และเพิ่มการตั้งค่าเฉพาะสําหรับเครื่องมือ

ขยาย

RuntimeConfiguration

ผู้ผลิต

ToolingConfiguration(ToolingConfigurationOptions)

คุณสมบัติ

clusterCategory
isDevelopmentEnvironment	คลัสเตอร์เป็นสภาพแวดล้อมการพัฒนา (ภายในเครื่องหรือพัฒนา) ขึ้นอยู่กับ clusterCategory
isNodeEnvDevelopment	NODE_ENV ระบุโหมดการพัฒนาหรือไม่ ส่งกลับค่า true เมื่อ NODE_ENV เป็น 'การพัฒนา' (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก) นี่คือวิธี Node.js มาตรฐานที่ระบุโหมดการพัฒนา
mcpPlatformAuthenticationScope	รับขอบเขตการรับรองความถูกต้องแพลตฟอร์ม MCP ใช้โดย AgenticAuthenticationService สําหรับการแลกเปลี่ยนโทเค็น ตัดแต่งช่องว่างเพื่อป้องกันความล้มเหลวในการแลกเปลี่ยนโทเค็น
mcpPlatformEndpoint
useToolingManifest	ว่าจะใช้ไฟล์ ToolingManifest.json แทนการค้นพบเกตเวย์หรือไม่ ส่งกลับเป็น true เมื่อ NODE_ENV ถูกตั้งค่าเป็น 'การพัฒนา' (ตรงตามตัวพิมพ์ใหญ่-เล็ก) หรือเมื่อถูกแทนที่อย่างชัดเจนผ่านการกําหนดค่า

วิธีการ

getBearerTokenForServer(string)	ส่งกลับโทเค็นแบบแบเรอร์โหมดพัฒนาสําหรับเซิร์ฟเวอร์ MCP ตามชื่อ ตรวจสอบ BEARER_TOKEN_<SERVERNAME_UPPER> ก่อน แล้วย้อนกลับไปที่ BEARER_TOKEN ส่งกลับที่ไม่ได้กําหนดไว้เมื่อไม่ได้ตั้งค่าตัวแปร (ไม่มีการแนบส่วนหัวสําหรับการรับรองความถูกต้อง)
hasPerServerBearerToken(string)	แสดงค่าเป็น true เมื่อโทเค็น env var (BEARER_TOKEN_<SERVERNAME_UPPER>) ต่อเซิร์ฟเวอร์ถูกตั้งค่าอย่างชัดเจนสําหรับเซิร์ฟเวอร์ที่ระบุ เท็จ เมื่อมีการใช้เฉพาะการแสดงแทน BEARER_TOKEN ที่ใช้ร่วมกันเท่านั้น ใช้เพื่อตรวจสอบเซิร์ฟเวอร์ V2 ที่ล้มอย่างเงียบ ๆ กลับไปยังโทเค็นผู้ชมที่ไม่ถูกต้องในโหมด dev

วิธีการสืบทอด

parseEnvBoolean(undefined | string)	แยกวิเคราะห์ตัวแปรสภาพแวดล้อมเป็นบูลีน รู้จัก 'true', '1', 'yes', 'on' (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก) เป็น true แต่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก ค่าอื่นๆ ทั้งหมดเป็น เท็จ
parseEnvInt(undefined | string, number)	แยกวิเคราะห์ตัวแปรสภาพแวดล้อมเป็นจํานวนเต็ม ส่งกลับ fallback ถ้าไม่ถูกต้องหรือไม่ได้ตั้งค่า

รายละเอียดคอนสตรักเตอร์

ToolingConfiguration(ToolingConfigurationOptions)

new ToolingConfiguration(overrides?: ToolingConfigurationOptions)

พารามิเตอร์

overrides

ToolingConfigurationOptions

รายละเอียดคุณสมบัติ

clusterCategory

ClusterCategory clusterCategory

ค่าคุณสมบัติ

ClusterCategory

isDevelopmentEnvironment

คลัสเตอร์เป็นสภาพแวดล้อมการพัฒนา (ภายในเครื่องหรือพัฒนา) ขึ้นอยู่กับ clusterCategory

boolean isDevelopmentEnvironment

ค่าคุณสมบัติ

boolean

isNodeEnvDevelopment

NODE_ENV ระบุโหมดการพัฒนาหรือไม่ ส่งกลับค่า true เมื่อ NODE_ENV เป็น 'การพัฒนา' (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก) นี่คือวิธี Node.js มาตรฐานที่ระบุโหมดการพัฒนา

boolean isNodeEnvDevelopment

ค่าคุณสมบัติ

boolean

mcpPlatformAuthenticationScope

รับขอบเขตการรับรองความถูกต้องแพลตฟอร์ม MCP ใช้โดย AgenticAuthenticationService สําหรับการแลกเปลี่ยนโทเค็น ตัดแต่งช่องว่างเพื่อป้องกันความล้มเหลวในการแลกเปลี่ยนโทเค็น

string mcpPlatformAuthenticationScope

ค่าคุณสมบัติ

string

mcpPlatformEndpoint

string mcpPlatformEndpoint

ค่าคุณสมบัติ

string

useToolingManifest

ว่าจะใช้ไฟล์ ToolingManifest.json แทนการค้นพบเกตเวย์หรือไม่ ส่งกลับเป็น true เมื่อ NODE_ENV ถูกตั้งค่าเป็น 'การพัฒนา' (ตรงตามตัวพิมพ์ใหญ่-เล็ก) หรือเมื่อถูกแทนที่อย่างชัดเจนผ่านการกําหนดค่า

boolean useToolingManifest

ค่าคุณสมบัติ

boolean

รายละเอียดวิธีการ

getBearerTokenForServer(string)

ส่งกลับโทเค็นแบบแบเรอร์โหมดพัฒนาสําหรับเซิร์ฟเวอร์ MCP ตามชื่อ ตรวจสอบ BEARER_TOKEN_<SERVERNAME_UPPER> ก่อน แล้วย้อนกลับไปที่ BEARER_TOKEN ส่งกลับที่ไม่ได้กําหนดไว้เมื่อไม่ได้ตั้งค่าตัวแปร (ไม่มีการแนบส่วนหัวสําหรับการรับรองความถูกต้อง)

function getBearerTokenForServer(mcpServerName: string): undefined | string

พารามิเตอร์

mcpServerName

string

การส่งคืน

undefined | string

hasPerServerBearerToken(string)

แสดงค่าเป็น true เมื่อโทเค็น env var (BEARER_TOKEN_<SERVERNAME_UPPER>) ต่อเซิร์ฟเวอร์ถูกตั้งค่าอย่างชัดเจนสําหรับเซิร์ฟเวอร์ที่ระบุ เท็จ เมื่อมีการใช้เฉพาะการแสดงแทน BEARER_TOKEN ที่ใช้ร่วมกันเท่านั้น ใช้เพื่อตรวจสอบเซิร์ฟเวอร์ V2 ที่ล้มอย่างเงียบ ๆ กลับไปยังโทเค็นผู้ชมที่ไม่ถูกต้องในโหมด dev

function hasPerServerBearerToken(mcpServerName: string): boolean

พารามิเตอร์

mcpServerName

string

การส่งคืน

boolean

รายละเอียดวิธีการสืบทอด

parseEnvBoolean(undefined | string)

แยกวิเคราะห์ตัวแปรสภาพแวดล้อมเป็นบูลีน รู้จัก 'true', '1', 'yes', 'on' (ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก) เป็น true แต่ไม่ตรงตามตัวพิมพ์ใหญ่-เล็ก ค่าอื่นๆ ทั้งหมดเป็น เท็จ

static function parseEnvBoolean(envValue: undefined | string): boolean

พารามิเตอร์

envValue

undefined | string

การส่งคืน

boolean

สืบทอดมาจาก RuntimeConfiguration.parseEnvBoolean

parseEnvInt(undefined | string, number)

แยกวิเคราะห์ตัวแปรสภาพแวดล้อมเป็นจํานวนเต็ม ส่งกลับ fallback ถ้าไม่ถูกต้องหรือไม่ได้ตั้งค่า

static function parseEnvInt(envValue: undefined | string, fallback: number): number

พารามิเตอร์

envValue

undefined | string

fallback

number

การส่งคืน

number

สืบทอดมาจาก RuntimeConfiguration.parseEnvInt