@microsoft/agents-a365-runtime package

Sınıflar

AgenticAuthenticationService

Aracı kullanıcı kimlik doğrulamasını işleme hizmeti.

DefaultConfigurationProvider

Ortam tabanlı yapılandırma döndüren varsayılan sağlayıcı.

Çok kiracılı konular: Bu sağlayıcı, bir işlemdeki tüm istekler arasında paylaşılan, inşaat zamanında tek bir yapılandırma örneği oluşturur. Varsayılan modül düzeyindeki sağlayıcılar (örneğin, defaultRuntimeConfigurationProvider) tekillerdir.

Çok kiracılı senaryolar için iki yaklaşım desteklenir:

  1. Dinamik geçersiz kılma işlevleri (önerilen): Çalışma zamanında zaman uyumsuz bağlamdan (örneğin OpenTelemetry bagaj) okunan geçersiz kılma işlevlerini geçirin. Aynı Yapılandırma örneği istek başına farklı değerler döndürür.

    const config = new ToolingConfiguration({
      mcpPlatformEndpoint: () => {
        const tenantConfig = context.active().getValue(TENANT_KEY);
        return tenantConfig?.endpoint ?? 'https://default.endpoint';
      }
    });
    
  2. Kiracı başına sağlayıcılar: Farklı kiracıların tamamen farklı geçersiz kılma işlevlerine ihtiyacı olduğunda her kiracı için ayrı sağlayıcı örnekleri oluşturun.

OperationError

Bir işlemden gelen bir hatayı kapsüller.

OperationResult

bir işlemin sonucunu temsil eder.

PowerPlatformApiDiscovery
RuntimeConfiguration

Agent365 SDK için temel yapılandırma sınıfı. Diğer paketler bunu kendi ayarlarını eklemek için genişletir.

Her özellik erişiminde geçersiz kılma işlevleri çağrılır ve istek başına zaman uyumsuz bağlamdan (örneğin OpenTelemetry bagaj) dinamik çözüm etkinleştirilir.

Utility

Aracı çalışma zamanı işlemleri için yardımcı yöntemler sağlayan yardımcı program sınıfı.

Arabirimler

IConfigurationProvider

Yapılandırma sağlamak için genel arabirim. Her paket kendi yapılandırma türünü tanımlar T.

Tür Diğer Adları

RuntimeConfigurationOptions

Çalışma zamanı yapılandırma seçenekleri - tüm isteğe bağlı işlevler. İşlevler her özellik erişiminde çağrılır ve dinamik çözümlemeyi etkinleştirir. Ayarlanmamış değerler ortam değişkenlerine geri döner.

Numaralandırmalar

ClusterCategory

Power Platform API bulma için küme kategorileri. Dize sabit listesi hem derleme zamanı türü güvenliği hem de çalışma zamanı doğrulaması sağlar.

İşlevler

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)

Ortam değişkenlerinden küme kategorisini alır.

Örnek

// 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 platformu kimlik doğrulama kapsamını alır.

Örnek

// 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()

Gözlemlenebilirlik hizmetinde kimlik doğrulaması için kapsamı döndürür.

Örnek

// 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>)

Geçerli ortam bir geliştirme ortamıysa true döndürür.

Örnek

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

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

Değişkenler

DEVELOPMENT_ENVIRONMENT_NAME
PRODUCTION_ENVIRONMENT_NAME
PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

Üretim MCP platformu kimlik doğrulama kapsamı.

PROD_OBSERVABILITY_CLUSTER_CATEGORY

Üretim ortamları için varsayılan küme kategorisi.

PROD_OBSERVABILITY_SCOPE

Üretim gözlemlenebilirliği kimlik doğrulaması kapsamı.

defaultRuntimeConfigurationProvider

RuntimeConfiguration için paylaşılan varsayılan sağlayıcı. Tek kiracılı dağıtımlar için veya çoklu kiracı için dinamik geçersiz kılma işlevleri kullanılırken geçersiz kılma içermeyen ortam değişkenlerini kullanır.

İşlev Ayrıntıları

getClusterCategory(IConfigurationProvider<RuntimeConfiguration>)

Uyarı

Bu API artık kullanım dışıdır.

Use RuntimeConfiguration.clusterCategory instead.

Ortam değişkenlerinden küme kategorisini alır.

Örnek

// 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

Parametreler

configProvider

IConfigurationProvider<RuntimeConfiguration>

İsteğe bağlı yapılandırma sağlayıcısı. Belirtilmezse defaultRuntimeConfigurationProvider olarak varsayılan değerdir.

Döndürülenler

string

CLUSTER_CATEGORY env var kümesi kategorisi varsayılan olarak 'prod' olarak ayarlanır.

getMcpPlatformAuthenticationScope()

Uyarı

Bu API artık kullanım dışıdır.

Use ToolingConfiguration.mcpPlatformAuthenticationScope instead.

MCP platformu kimlik doğrulama kapsamını alır.

Örnek

// 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

Döndürülenler

string

MCP platformu kimlik doğrulama kapsamı.

getObservabilityAuthenticationScope()

Uyarı

Bu API artık kullanım dışıdır.

Use ObservabilityConfiguration.observabilityAuthenticationScopes instead.

Gözlemlenebilirlik hizmetinde kimlik doğrulaması için kapsamı döndürür.

Örnek

// 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[]

Döndürülenler

string[]

Geçerli ortamın kimlik doğrulama kapsamları.

isDevelopmentEnvironment(IConfigurationProvider<RuntimeConfiguration>)

Uyarı

Bu API artık kullanım dışıdır.

Use RuntimeConfiguration.isDevelopmentEnvironment instead.

Geçerli ortam bir geliştirme ortamıysa true döndürür.

Örnek

// 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

Parametreler

configProvider

IConfigurationProvider<RuntimeConfiguration>

İsteğe bağlı yapılandırma sağlayıcısı. Belirtilmezse defaultRuntimeConfigurationProvider olarak varsayılan değerdir.

Döndürülenler

boolean

Geçerli ortam geliştirme ise true, aksi takdirde false.

Değişken Ayrıntıları

DEVELOPMENT_ENVIRONMENT_NAME

DEVELOPMENT_ENVIRONMENT_NAME: "Development"

Tür

"Development"

PRODUCTION_ENVIRONMENT_NAME

PRODUCTION_ENVIRONMENT_NAME: "production"

Tür

"production"

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

Uyarı

Bu API artık kullanım dışıdır.

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

Üretim MCP platformu kimlik doğrulama kapsamı.

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

Tür

string

PROD_OBSERVABILITY_CLUSTER_CATEGORY

Uyarı

Bu API artık kullanım dışıdır.

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

Üretim ortamları için varsayılan küme kategorisi.

PROD_OBSERVABILITY_CLUSTER_CATEGORY: "prod"

Tür

"prod"

PROD_OBSERVABILITY_SCOPE

Uyarı

Bu API artık kullanım dışıdır.

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

Üretim gözlemlenebilirliği kimlik doğrulaması kapsamı.

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

Tür

string

defaultRuntimeConfigurationProvider

RuntimeConfiguration için paylaşılan varsayılan sağlayıcı. Tek kiracılı dağıtımlar için veya çoklu kiracı için dinamik geçersiz kılma işlevleri kullanılırken geçersiz kılma içermeyen ortam değişkenlerini kullanır.

defaultRuntimeConfigurationProvider: DefaultConfigurationProvider<RuntimeConfiguration>

Tür