Azure AgentPlatform client library for JavaScript - version 1.0.0-beta.1

Ten pakiet zawiera izomorficzne SDK (działające zarówno w Node.js, jak i w przeglądarkach) dla klienta AgentPlatform Azure.

Kore.AgentPlatform Dostawca zasobów do zarządzania organizacjami Kore AI Agent Platform i ich przestrzeniami roboczymi.

Organizacje to najwyższe poziomy monitorowane zasoby ARM. Każda organizacja jest udostępniana razem z domyślnym Workspace. Dodatkowe przestrzenie robocze są zarządzane jako podrzędny typ zasobu zasobu w ramach Organizacji, używając standardowych czasowników ARM (PUT / DELETE / GET / LIST) na adresie URL przestrzeni roboczej.

Uwierzytelnianie serwis-usługa między Liftr a Kore wykorzystuje federowane poświadczenia Microsoft Entra i jest wymuszane na warstwie wykonawczej (nie na powierzchni ARM).

Kluczowe linki:

Rozpoczęcie pracy

Obecnie obsługiwane środowiska

  • Wersje LTS systemu Node.js
  • Najnowsze wersje przeglądarek Safari, Chrome, Edge i Firefox.

Aby uzyskać więcej informacji, zobacz nasze zasad pomocy technicznej.

Prerequisites

Instalowanie pakietu @azure/arm-koreaiartemis

Zainstaluj bibliotekę klienta Azure AgentPlatform dla JavaScript za pomocą npm:

npm install @azure/arm-koreaiartemis

Twórz i uwierzytelnij AgentPlatformClient

Aby utworzyć obiekt klienta do dostępu do API Azure AgentPlatform, będziesz potrzebować zasobu endpoint Azure AgentPlatform oraz .credential Klient Azure AgentPlatform może używać poświadczeń Microsoft Entra do uwierzytelniania. Punkt końcowy dla swojego zasobu Azure AgentPlatform znajdziesz w Azure Portal.

Możesz uwierzytelnić się za pomocą Microsoft Entra ID, używając poświadczenia z biblioteki @azure/identity lub istniejącego tokena Microsoft Entra.

Aby użyć dostawcy DefaultAzureCredential pokazanego poniżej lub innych dostawców poświadczeń dostarczonych z zestawem Azure SDK, zainstaluj pakiet @azure/identity:

npm install @azure/identity

Będziesz także musiał zarejestrować nową aplikację Microsoft Entra i przyznać dostęp do Azure AgentPlatform, przypisując odpowiednią rolę swojemu podmiotowi usługowemu (uwaga: role takie jak nie "Owner" przyznają niezbędnych uprawnień).

Aby dowiedzieć się więcej o tym, jak stworzyć aplikację Microsoft Entra, sprawdź ten przewodnik.

Korzystając ze środowisk podobnych do Node.js i węzłów, można użyć DefaultAzureCredential klasy do uwierzytelnienia klienta.

import { AgentPlatformClient } from "@azure/arm-koreaiartemis";
import { DefaultAzureCredential } from "@azure/identity";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AgentPlatformClient(new DefaultAzureCredential(), subscriptionId);

W przypadku środowisk przeglądarki użyj polecenia z InteractiveBrowserCredential@azure/identity pakietu do uwierzytelnienia.

import { InteractiveBrowserCredential } from "@azure/identity";
import { AgentPlatformClient } from "@azure/arm-koreaiartemis";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AgentPlatformClient(credential, subscriptionId);

Pakiet JavaScript

Aby użyć tej biblioteki klienta w przeglądarce, najpierw należy użyć pakietu. Aby uzyskać szczegółowe informacje o tym, jak to zrobić, zapoznaj się z naszą dokumentacją dotyczącą tworzenia pakietów .

Podstawowe pojęcia

AgentPlatformClient

AgentPlatformClientjest głównym interfejsem dla programistów korzystających z biblioteki klienta Azure AgentPlatform. Poznaj metody tego obiektu klienta, aby zrozumieć różne funkcje usługi Azure AgentPlatform, do których masz dostęp.

Troubleshooting

Logging

Włączenie rejestrowania może pomóc odkryć przydatne informacje o błędach. Aby wyświetlić dziennik żądań i odpowiedzi HTTP, ustaw zmienną środowiskową AZURE_LOG_LEVEL na info. Alternatywnie rejestrowanie można włączyć w czasie wykonywania, wywołując setLogLevel w @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Aby uzyskać bardziej szczegółowe instrukcje dotyczące włączania dzienników, zapoznaj się z dokumentacją pakietu @azure/logger.

Następne kroki

Zapoznaj się z przykładami katalogu, aby zapoznać się ze szczegółowymi przykładami dotyczącymi korzystania z tej biblioteki.

Contributing

Jeśli chcesz przyczynić się do tej biblioteki, przeczytaj przewodnik wkład aby dowiedzieć się więcej o budowaniu i testowaniu kodu.

  • Ostatnia aktualizacja o