@microsoft/agents-a365-runtime package

클래스

AgenticAuthenticationService

에이전트 사용자 인증을 처리하기 위한 서비스입니다.
DefaultConfigurationProvider

환경 기반 구성을 반환하는 기본 공급자입니다.

다중 테넌트 고려 사항: 이 공급자는 생성 시 프로세스의 모든 요청에서 공유되는 단일 구성 인스턴스를 만듭니다. 기본 모듈 수준 공급자(예: defaultRuntimeConfigurationProvider)는 싱글톤입니다.

다중 테넌트 시나리오의 경우 두 가지 방법이 지원됩니다.

  1. 동적 재정의 함수(권장): 런타임에 비동기 컨텍스트(예: OpenTelemetry 수하물)에서 읽은 재정의 함수를 전달합니다. 동일한 구성 인스턴스는 요청당 다른 값을 반환합니다.

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

  2. 테넌트별 공급자: 서로 다른 테넌트에 완전히 다른 재정의 함수가 필요한 경우 각 테넌트에 대해 별도의 공급자 인스턴스를 만듭니다.
OperationError

작업의 오류를 캡슐화합니다.
OperationResult

작업의 결과를 나타냅니다.
PowerPlatformApiDiscovery
RuntimeConfiguration

Agent365 SDK에 대한 기본 구성 클래스입니다. 다른 패키지는 이를 확장하여 자체 설정을 추가합니다.

요청당 비동기 컨텍스트(예: OpenTelemetry 수하물)에서 동적 확인을 사용하도록 설정하여 각 속성 액세스에서 재정의 함수가 호출됩니다.
Utility

에이전트 런타임 작업에 대한 도우미 메서드를 제공하는 유틸리티 클래스입니다.

인터페이스

IConfigurationProvider

구성을 제공하기 위한 제네릭 인터페이스입니다. 각 패키지는 자체 구성 유형 T를 정의합니다.

형식 별칭

RuntimeConfigurationOptions

런타임 구성 옵션 - 모든 선택적 함수. 함수는 각 속성 액세스에서 호출되어 동적 확인을 사용하도록 설정합니다. 설정되지 않은 값은 환경 변수로 대체됩니다.

열거형

ClusterCategory

Power Platform API 검색을 위한 클러스터 범주입니다. 문자열 열거형은 컴파일 시간 형식 안전성과 런타임 유효성 검사를 모두 제공합니다.

함수

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

경고

이 API는 이제 사용되지 않습니다.

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>

선택적 구성 공급자입니다. 지정하지 않으면 defaultRuntimeConfigurationProvider로 기본값이 지정됩니다.

반품

string

CLUSTER_CATEGORY env var의 클러스터 범주는 기본적으로 'prod'입니다.

getMcpPlatformAuthenticationScope()

경고

이 API는 이제 사용되지 않습니다.

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

경고

이 API는 이제 사용되지 않습니다.

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

경고

이 API는 이제 사용되지 않습니다.

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>

선택적 구성 공급자입니다. 지정하지 않으면 defaultRuntimeConfigurationProvider로 기본값이 지정됩니다.

반품

boolean

현재 환경이 개발 중이면 true이고, 그렇지 않으면 false입니다.

변수 세부 정보

DEVELOPMENT_ENVIRONMENT_NAME 

DEVELOPMENT_ENVIRONMENT_NAME: "Development"

형식

"Development"

PRODUCTION_ENVIRONMENT_NAME 

PRODUCTION_ENVIRONMENT_NAME: "production"

형식

"production"

PROD_MCP_PLATFORM_AUTHENTICATION_SCOPE

경고

이 API는 이제 사용되지 않습니다.

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

경고

이 API는 이제 사용되지 않습니다.

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

프로덕션 환경의 기본 클러스터 범주입니다.

PROD_OBSERVABILITY_CLUSTER_CATEGORY: "prod"

형식

"prod"

PROD_OBSERVABILITY_SCOPE

경고

이 API는 이제 사용되지 않습니다.

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>