@microsoft/agents-a365-runtime package

บริการสําหรับการจัดการการรับรองความถูกต้องผู้ใช้ที่เป็นตัวแทน

ตัวให้บริการเริ่มต้นที่ส่งกลับการกําหนดค่าตามสภาพแวดล้อม

ข้อควรพิจารณาแบบหลายผู้เช่า: ตัวให้บริการนี้สร้างอินสแตนซ์การกําหนดค่าเดียวในขณะก่อสร้าง ซึ่งใช้ร่วมกันทั่วทั้งคําขอทั้งหมดในกระบวนการ ตัวให้บริการระดับโมดูลเริ่มต้น (เช่น defaultRuntimeConfigurationProvider) คือ singletons

สําหรับสถานการณ์แบบหลายผู้เช่า ได้รับการสนับสนุนสองวิธี:

1. ฟังก์ชันการแทนที่แบบไดนามิก (แนะนํา): ส่งผ่านฟังก์ชันแทนที่ที่อ่านจากบริบท async (เช่น OpenTelemetry baggage) ที่รันไทม์ อินสแตนซ์การกําหนดค่าเดียวกันจะส่งกลับค่าที่แตกต่างกันต่อคําขอ

   const config = new ToolingConfiguration({
     mcpPlatformEndpoint: () => {
       const tenantConfig = context.active().getValue(TENANT_KEY);
       return tenantConfig?.endpoint ?? 'https://default.endpoint';
     }
   });
   

2. ผู้ให้บริการต่อผู้เช่า: สร้างอินสแตนซ์ของผู้ให้บริการแยกต่างหากสําหรับผู้เช่าแต่ละรายเมื่อผู้เช่าที่แตกต่างกันต้องการฟังก์ชันการแทนที่ที่แตกต่างกันทั้งหมด

ย่อส่วนข้อผิดพลาดจากการดําเนินการ

แสดงผลลัพธ์ของการดําเนินการ

ระดับการกําหนดค่าพื้นฐานสําหรับ Agent365 SDK แพคเกจอื่นๆ จะขยายการตั้งค่านี้เพื่อเพิ่มการตั้งค่าของพวกเขาเอง

ฟังก์ชันการแทนที่จะถูกเรียกใช้ในแต่ละการเข้าถึงคุณสมบัติ การเปิดใช้งานการแก้ปัญหาแบบไดนามิกจากบริบทต่างเวลา (เช่น สัมภาระ OpenTelemetry) ต่อคําขอ

คลาสยูทิลิตี้ที่มีวิธีการช่วยเหลือสําหรับการดําเนินการรันไทม์ตัวแทน

อินเทอร์เฟซทั่วไปสําหรับการจัดโครงแบบ แต่ละแพคเกจจะกําหนดประเภทการกําหนดค่า T ของตัวเอง

ตัวเลือกการกําหนดค่ารันไทม์ - ฟังก์ชันตัวเลือกทั้งหมด ฟังก์ชันถูกเรียกใช้ในแต่ละการเข้าถึงคุณสมบัติ เปิดใช้งานความละเอียดแบบไดนามิก ค่าที่ไม่ตั้งค่าจะกลับสู่ตัวแปรสภาพแวดล้อม

ประเภทคลัสเตอร์สําหรับการค้นพบ Power Platform API Enum สตริงมีทั้งความปลอดภัยประเภทเวลาการคอมไพล์และการตรวจสอบรันไทม์

รับประเภทคลัสเตอร์จากตัวแปรสภาพแวดล้อม

ตัวอย่าง

// Before:
import { getClusterCategory } from '@microsoft/agents-a365-runtime';
const cluster = getClusterCategory();

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
const cluster = defaultRuntimeConfigurationProvider.getConfiguration().clusterCategory;

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

ตัวอย่าง

// Before:
import { getMcpPlatformAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scope = getMcpPlatformAuthenticationScope();

// After:
import { defaultToolingConfigurationProvider } from '@microsoft/agents-a365-tooling';
const scope = defaultToolingConfigurationProvider.getConfiguration().mcpPlatformAuthenticationScope;

แสดงขอบเขตสําหรับการรับรองความถูกต้องไปยังบริการที่ต้องสังเกตได้

ตัวอย่าง

// Before:
import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime';
const scopes = getObservabilityAuthenticationScope();

// After:
import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability';
const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];

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

ตัวอย่าง

// Before:
import { isDevelopmentEnvironment } from '@microsoft/agents-a365-runtime';
if (isDevelopmentEnvironment()) { ... }

// After:
import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime';
if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }

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

ประเภทคลัสเตอร์เริ่มต้นสําหรับสภาพแวดล้อมการผลิต

ขอบเขตการรับรองความถูกต้องความสามารถในการสังเกตการณ์การผลิต

ผู้ให้บริการค่าเริ่มต้นที่ใช้ร่วมกันสําหรับ RuntimeConfiguration ใช้ตัวแปรสภาพแวดล้อมโดยไม่มีการแทนที่ - เหมาะสําหรับการปรับใช้แบบผู้เช่ารายเดียวหรือเมื่อใช้ฟังก์ชันการแทนที่แบบไดนามิกสําหรับหลายผู้เช่า