@microsoft/agents-a365-runtime package

Usługa do obsługi uwierzytelniania użytkownika agenta.

Domyślny dostawca, który zwraca konfigurację opartą na środowisku.

Zagadnienia dotyczące wielu dzierżaw: Ten dostawca tworzy pojedyncze wystąpienie konfiguracji w czasie budowy, współużytkowane we wszystkich żądaniach w procesie. Domyślni dostawcy na poziomie modułu (np defaultRuntimeConfigurationProvider. ) to singletons.

W przypadku scenariuszy obejmujących wiele dzierżaw obsługiwane są dwa podejścia:

1. Funkcje zastąpienia dynamicznego (zalecane): Funkcje przesłonięcia przekazywane odczytywane z kontekstu asynchronicznego (np. bagażu OpenTelemetry) w czasie wykonywania. To samo wystąpienie konfiguracji zwraca różne wartości na żądanie.

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

2. Dostawcy poszczególnych dzierżaw: Utwórz oddzielne wystąpienia dostawcy dla każdej dzierżawy, gdy różne dzierżawy potrzebują całkowicie różnych funkcji zastąpienia.

Hermetyzuje błąd operacji.

Reprezentuje wynik operacji.

Podstawowa klasa konfiguracji dla zestawu SDK Agent365. Inne pakiety rozszerzają tę opcję, aby dodać własne ustawienia.

Funkcje zastąpienia są wywoływane dla każdego dostępu do właściwości, co umożliwia dynamiczne rozpoznawanie z kontekstu asynchronicznego (np. bagażu OpenTelemetry) na żądanie.

Klasa narzędzi zapewniająca metody pomocnicze dla operacji środowiska uruchomieniowego agenta.

Interfejs ogólny zapewniający konfigurację. Każdy pakiet definiuje własny typ konfiguracji T.

Opcje konfiguracji środowiska uruchomieniowego — wszystkie funkcje opcjonalne. Funkcje są wywoływane dla każdego dostępu do właściwości, co umożliwia rozpoznawanie dynamiczne. Nieustawionych wartości wracają do zmiennych środowiskowych.

Kategorie klastrów na potrzeby odnajdywania interfejsu API platformy Power Platform. Wyliczenie ciągów zapewnia zarówno bezpieczeństwo typu kompilowania, jak i walidację środowiska uruchomieniowego.

Pobiera kategorię klastra ze zmiennych środowiskowych.

Przykład

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

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

Pobiera zakres uwierzytelniania platformy MCP.

Przykład

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

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

Zwraca zakres uwierzytelniania w usłudze obserwacji.

Przykład

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

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

Zwraca wartość true, jeśli bieżące środowisko jest środowiskiem projektowym.

Przykład

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

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

Zakres uwierzytelniania platformy MCP w środowisku produkcyjnym.

Domyślna kategoria klastra dla środowisk produkcyjnych.

Zakres uwierzytelniania możliwości obserwowania w środowisku produkcyjnym.

Udostępniony domyślny dostawca środowiska RuntimeConfiguration. Używa zmiennych środowiskowych bez przesłonięć — odpowiednich dla wdrożeń z jedną dzierżawą lub w przypadku używania funkcji zastąpienia dynamicznego dla wielu dzierżaw.