@microsoft/agents-a365-runtime package

Υπηρεσία για τον χειρισμό του ελέγχου ταυτότητας agentic user.

Προεπιλεγμένη υπηρεσία παροχής που επιστρέφει ρυθμίσεις παραμέτρων βάσει περιβάλλοντος.

Ζητήματα πολλαπλών μισθωτών: Αυτή η υπηρεσία παροχής δημιουργεί μια μοναδική παρουσία ρύθμισης παραμέτρων κατά τον χρόνο κατασκευής, κοινόχρηστη σε όλες τις αιτήσεις σε μια διαδικασία. Οι προεπιλεγμένες υπηρεσίες παροχής επιπέδου μονάδας (π.χ., defaultRuntimeConfigurationProvider) είναι μονές.

Για σενάρια πολλαπλών μισθωτών, υποστηρίζονται δύο προσεγγίσεις:

1. Δυναμικές συναρτήσεις παράκαμψης (προτείνεται): Μεταβιβάστε συναρτήσεις παράκαμψης που διαβάζονται από ασύγχρονο περιβάλλον (π.χ. αποσκευές OpenTelemetry) κατά τον χρόνο εκτέλεσης. Η ίδια παρουσία ρύθμισης παραμέτρων επιστρέφει διαφορετικές τιμές ανά αίτηση.

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

2. Υπηρεσίες παροχής ανά μισθωτή: Δημιουργήστε ξεχωριστές παρουσίες υπηρεσίας παροχής για κάθε μισθωτή όταν διαφορετικοί μισθωτές χρειάζονται εντελώς διαφορετικές συναρτήσεις παράκαμψης.

Συμπυκνώνει ένα σφάλμα από μια λειτουργία.

Αντιπροσωπεύει το αποτέλεσμα μιας λειτουργίας.

Βασική κλάση ρύθμισης παραμέτρων για το Agent365 SDK. Άλλα πακέτα επεκτείνουν αυτήν την επιλογή για να προσθέσουν τις δικές τους ρυθμίσεις.

Οι συναρτήσεις παράκαμψης καλούνται σε κάθε πρόσβαση ιδιοκτησίας, ενεργοποιώντας δυναμική ανάλυση από ασύγχρονο περιβάλλον (π.χ. αποσκευές OpenTelemetry) ανά αίτημα.

Κλάση βοηθητικού προγράμματος που παρέχει μεθόδους βοηθητικών στοιχείων για λειτουργίες χρόνου εκτέλεσης παράγοντα.

Γενική διασύνδεση για την παροχή ρύθμισης παραμέτρων. Κάθε πακέτο ορίζει τον δικό του τύπο ρύθμισης παραμέτρων T.

Επιλογές ρύθμισης παραμέτρων χρόνου εκτέλεσης - όλες οι προαιρετικές συναρτήσεις. Οι συναρτήσεις καλούνται σε κάθε πρόσβαση ιδιότητας, ενεργοποιώντας δυναμική ανάλυση. Οι μη σύνολες τιμών επιστρέφουν στις μεταβλητές περιβάλλοντος.

Κατηγορίες συμπλέγματος για τον εντοπισμό του API Power Platform. Η απαρίθμηση συμβολοσειράς παρέχει τόσο ασφάλεια τύπου μεταγλώττισης όσο και επικύρωση χρόνου εκτέλεσης.

Λαμβάνει την κατηγορία συμπλέγματος από μεταβλητές περιβάλλοντος.

Παράδειγμα

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

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

Λαμβάνει την εμβέλεια ελέγχου ταυτότητας της πλατφόρμας 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;

Επιστρέφει την εμβέλεια για τον έλεγχο ταυτότητας στην υπηρεσία παρατηρησιμότητας.

Παράδειγμα

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

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

Επιστρέφει την τιμή true εάν το τρέχον περιβάλλον είναι περιβάλλον ανάπτυξης.

Παράδειγμα

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

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

Εμβέλεια ελέγχου ταυτότητας πλατφόρμας MCP παραγωγής.

Προεπιλεγμένη κατηγορία συμπλέγματος για περιβάλλοντα παραγωγής.

Εμβέλεια ελέγχου ταυτότητας παρατηρησιμότητας παραγωγής.

Κοινόχρηστη προεπιλεγμένη υπηρεσία παροχής για RuntimeConfiguration. Χρησιμοποιεί μεταβλητές περιβάλλοντος χωρίς παρακάμψεις - κατάλληλες για αναπτύξεις ενός μισθωτή ή κατά τη χρήση δυναμικών συναρτήσεων παράκαμψης για πολλαπλή μίσθωση.