@microsoft/agents-a365-runtime package

Palvelu agenttikäyttäjän todentamisen käsittelyyn.

Oletuspalvelu, joka palauttaa ympäristöpohjaisen määrityksen.

Huomioitavaa useasta vuokraajasta: Tämä palvelu luo rakennusaikana yksittäisen määritysesiintymän, joka on jaettu prosessin kaikissa pyynnöissä. Moduulitason oletuspalvelut (esim. defaultRuntimeConfigurationProvider) ovat yksittäisiä paketteja.

Usean vuokraajan skenaarioissa tuetaan kahta lähestymistapaa:

1. Dynaamiset ohitusfunktiot (suositus): Ohita funktiot, jotka luetaan asynkronisesta kontekstista (esimerkiksi OpenTelemetry-matkatavarat) ajon aikana. Sama määritysesiintymä palauttaa eri arvot pyyntöä kohden.

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

2. Vuokraajakohtaiset palveluntarjoajat: Luo kullekin vuokraajalle erilliset palveluesiintymät, kun eri vuokraajat tarvitsevat erilaisten ohitusfunktioiden kokonaan.

Kiteyttää toiminnon virheen.

Edustaa toiminnon tulosta.

Agent365 SDK:n perusmääritysluokka. Muut paketit laajentavat tätä ja lisäävät omat asetuksensa.

Ohitustoimintoja kutsutaan kunkin ominaisuuden käyttöoikeudessa, mikä mahdollistaa dynaamisen tarkkuuden asynkronisessa kontekstissa (esimerkiksi OpenTelemetry-matkatavarat) pyyntökohtaisenä.

Utility-luokka, joka tarjoaa apumenetelmiä agentin suorituksenaikaisia toimintoja varten.

Yleinen liittymä määrityksen antamiseen. Kukin paketti määrittää oman määritystyyppinsä T.

Suorituksenaikaiset määritysasetukset – kaikki valinnaiset funktiot. Funktioita kutsutaan kunkin ominaisuuden käyttöoikeudessa, mikä ottaa käyttöön dynaamisen tarkkuuden. Unset-arvot palataan ympäristömuuttujiin.

Klusteriluokat Power Platform -ohjelmointirajapinnan etsimistä varten. Merkkijonon luettelointi tarjoaa sekä kääntäjä-aikatyypin suojauksen että suorituksenaikaisen vahvistuksen.

Hakee klusteriluokan ympäristömuuttujista.

Esimerkki

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

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

Hakee MCP-ympäristön todennusalueen.

Esimerkki

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

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

Palauttaa todentamisen laajuuden havaittavuuspalvelussa.

Esimerkki

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

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

Palauttaa arvon true, jos nykyinen ympäristö on kehitysympäristö.

Esimerkki

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

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

Tuotannon MCP-ympäristön todennusalue.

Oletusklusteriluokka tuotantoympäristöissä.

Tuotannon havainnoitavuuden todentamisen laajuus.

Jaettu oletuspalvelu RuntimeConfiguration-toiminnolle. Käyttää ympäristömuuttujia ilman ohituksia– sopii yhden vuokraajan käyttöönottoihin tai käytettäessä dynaamisia ohitusfunktioita useassa vuokraajassa.