@microsoft/agents-a365-runtime package

الفصول

AgenticAuthenticationService	خدمة لمعالجة مصادقة المستخدم الوكيل.
DefaultConfigurationProvider	الموفر الافتراضي الذي يقوم بإرجاع التكوين المستند إلى البيئة. اعتبارات متعددة المستأجرين: ينشئ هذا الموفر مثيل تكوين واحد في وقت الإنشاء، تتم مشاركته عبر جميع الطلبات في عملية. الموفرون الافتراضيون على مستوى الوحدة النمطية (على سبيل المثال، defaultRuntimeConfigurationProvider) هم مفردون. بالنسبة للسيناريوهات متعددة المستأجرين، يتم دعم نهجين: دالات التجاوز الديناميكي (مستحسن): تمرير وظائف التجاوز التي تقرأ من السياق غير المتزامن (على سبيل المثال، الأمتعة OpenTelemetry) في وقت التشغيل. يقوم مثيل التكوين نفسه بإرجاع قيم مختلفة لكل طلب. const config = new ToolingConfiguration({ mcpPlatformEndpoint: () => { const tenantConfig = context.active().getValue(TENANT_KEY); return tenantConfig?.endpoint ?? 'https://default.endpoint'; } }); موفرو كل مستأجر: إنشاء مثيلات موفر منفصلة لكل مستأجر عندما يحتاج مستأجرون مختلفون إلى وظائف تجاوز مختلفة تماما.
OperationError	تغلف خطأ من عملية.
OperationResult	يمثل نتيجة عملية.
PowerPlatformApiDiscovery
RuntimeConfiguration	فئة التكوين الأساسية ل Agent365 SDK. تقوم الحزم الأخرى بتوسيع هذا لإضافة إعداداتها الخاصة. يتم استدعاء وظائف التجاوز على كل وصول إلى الممتلكات، مما يتيح الدقة الديناميكية من السياق غير المتزامن (على سبيل المثال، أمتعة OpenTelemetry) لكل طلب.
Utility	فئة الأداة المساعدة التي توفر أساليب المساعد لعمليات وقت تشغيل العامل.

الواجهات

IConfigurationProvider

واجهة عامة لتوفير التكوين. تحدد كل حزمة نوع التكوين الخاص بها T.

النوع أسماء مستعارة

RuntimeConfigurationOptions

خيارات تكوين وقت التشغيل - جميع الوظائف الاختيارية. يتم استدعاء الوظائف على كل وصول إلى الخاصية، ما يتيح الدقة الديناميكية. تعود القيم غير المعينة إلى متغيرات البيئة.

التعدادات

ClusterCategory

فئات نظام المجموعة لاكتشاف واجهة برمجة تطبيقات Power Platform. يوفر تعداد السلسلة كلا من أمان نوع وقت التحويل البرمجي والتحقق من صحة وقت التشغيل.

الوظائف

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)	يحصل على فئة نظام المجموعة من متغيرات البيئة. مثال // Before: import { getClusterCategory } from '@microsoft/agents-a365-runtime'; const cluster = getClusterCategory(); // After: import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime'; const cluster = defaultRuntimeConfigurationProvider.getConfiguration().clusterCategory;
getMcpPlatformAuthenticationScope()	الحصول على نطاق مصادقة النظام الأساسي 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;
getObservabilityAuthenticationScope()	إرجاع نطاق المصادقة إلى خدمة إمكانية المراقبة. مثال // Before: import { getObservabilityAuthenticationScope } from '@microsoft/agents-a365-runtime'; const scopes = getObservabilityAuthenticationScope(); // After: import { defaultObservabilityConfigurationProvider } from '@microsoft/agents-a365-observability'; const scopes = [...defaultObservabilityConfigurationProvider.getConfiguration().observabilityAuthenticationScopes];
isDevelopmentEnvironment(IConfigurationProvider<RuntimeConfiguration>)	إرجاع القيمة true إذا كانت البيئة الحالية بيئة تطوير. مثال // Before: import { isDevelopmentEnvironment } from '@microsoft/agents-a365-runtime'; if (isDevelopmentEnvironment()) { ... } // After: import { defaultRuntimeConfigurationProvider } from '@microsoft/agents-a365-runtime'; if (defaultRuntimeConfigurationProvider.getConfiguration().isDevelopmentEnvironment) { ... }

المتغيرات

DEVELOPMENT_ENVIRONMENT_NAME
PRODUCTION_ENVIRONMENT_NAME
PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE	نطاق مصادقة نظام MCP الأساسي للإنتاج.
PROD_OBSERVABILITY_CLUSTER_CATEGORY	فئة نظام المجموعة الافتراضية لبيئات الإنتاج.
PROD_OBSERVABILITY_SCOPE	نطاق مصادقة مراقبة الإنتاج.
defaultRuntimeConfigurationProvider	الموفر الافتراضي المشترك ل RuntimeConfiguration. يستخدم متغيرات البيئة بدون تجاوزات - مناسبة لتوزيع المستأجر الفردي أو عند استخدام دالات التجاوز الديناميكية للإيجار المتعدد.

تفاصيل الوظيفة

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

Use RuntimeConfiguration.clusterCategory instead.

يحصل على فئة نظام المجموعة من متغيرات البيئة.

مثال

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

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

function getClusterCategory(configProvider?: IConfigurationProvider<RuntimeConfiguration>): string

المعلمات

configProvider

IConfigurationProvider<RuntimeConfiguration>

موفر التكوين الاختياري. الإعدادات الافتراضية لRuntimeConfigurationProvider إذا لم يتم تحديدها.

المرتجعات

string

فئة نظام المجموعة من CLUSTER_CATEGORY env var، افتراضيا إلى "prod".

getMcpPlatformAuthenticationScope()

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

Use ToolingConfiguration.mcpPlatformAuthenticationScope instead.

الحصول على نطاق مصادقة النظام الأساسي 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;

function getMcpPlatformAuthenticationScope(): string

المرتجعات

string

نطاق مصادقة النظام الأساسي MCP.

getObservabilityAuthenticationScope()

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.

إرجاع نطاق المصادقة إلى خدمة إمكانية المراقبة.

مثال

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

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

function getObservabilityAuthenticationScope(): string[]

المرتجعات

string[]

نطاقات المصادقة للبيئة الحالية.

isDevelopmentEnvironment(IConfigurationProvider<RuntimeConfiguration>)

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

Use RuntimeConfiguration.isDevelopmentEnvironment instead.

إرجاع القيمة true إذا كانت البيئة الحالية بيئة تطوير.

مثال

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

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

function isDevelopmentEnvironment(configProvider?: IConfigurationProvider<RuntimeConfiguration>): boolean

المعلمات

configProvider

IConfigurationProvider<RuntimeConfiguration>

موفر التكوين الاختياري. الإعدادات الافتراضية لRuntimeConfigurationProvider إذا لم يتم تحديدها.

المرتجعات

boolean

صحيح إذا كانت البيئة الحالية هي التطوير، خطأ خلاف ذلك.

تفاصيل المُتغيّر

DEVELOPMENT_ENVIRONMENT_NAME

DEVELOPMENT_ENVIRONMENT_NAME: "Development"

النوع

"Development"

PRODUCTION_ENVIRONMENT_NAME

PRODUCTION_ENVIRONMENT_NAME: "production"

النوع

"production"

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

This constant is exported for backward compatibility only. For new code, use ToolingConfiguration.mcpPlatformAuthenticationScope instead.

نطاق مصادقة نظام MCP الأساسي للإنتاج.

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE: "ea9ffc3e-8a23-4a7d-836d-234d7c7565c1/.default"

النوع

string

PROD_OBSERVABILITY_CLUSTER_CATEGORY

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

This constant is exported for backward compatibility only. For new code, use RuntimeConfiguration.clusterCategory instead.

فئة نظام المجموعة الافتراضية لبيئات الإنتاج.

PROD_OBSERVABILITY_CLUSTER_CATEGORY: "prod"

النوع

"prod"

PROD_OBSERVABILITY_SCOPE

تحذير

واجهة برمجة التطبيقات هذه مهملة الآن.

This constant is exported for backward compatibility only. For new code, use ObservabilityConfiguration.observabilityAuthenticationScopes instead.

نطاق مصادقة مراقبة الإنتاج.

PROD_OBSERVABILITY_SCOPE: "api://9b975845-388f-4429-889e-eab1ef63949c/.default"

النوع

string

defaultRuntimeConfigurationProvider

الموفر الافتراضي المشترك ل RuntimeConfiguration. يستخدم متغيرات البيئة بدون تجاوزات - مناسبة لتوزيع المستأجر الفردي أو عند استخدام دالات التجاوز الديناميكية للإيجار المتعدد.

defaultRuntimeConfigurationProvider: DefaultConfigurationProvider<RuntimeConfiguration>

النوع

DefaultConfigurationProvider<RuntimeConfiguration>