Pustaka klien Azure AgentPlatform untuk JavaScript - versi 1.0.0-beta.1

Paket ini berisi SDK isomorfik (berjalan baik di Node.js maupun browser) untuk klien AgentPlatform Azure.

Kore.AgentPlatform Penyedia Sumber Daya untuk mengelola Organisasi Platform Agen AI Kore dan Workspace mereka.

Organisasi adalah sumber daya ARM terlacak tingkat atas. Setiap Organisasi disediakan bersama dengan Workspace default. Workspace tambahan dikelola sebagai tipe sumber daya proxy anak di bawah Organization menggunakan kata kerja ARM standar (PUT / DELETE / GET / LIST) pada URL workspace.

Autentikasi service-to-service antara Liftr dan Kore menggunakan kredensial Microsoft Entra federasi dan ditegakkan di lapisan runtime (bukan di permukaan ARM).

Tautan kunci:

Memulai Langkah Pertama

Lingkungan yang didukung saat ini

Lihat kebijakan dukungan kami untuk detail selengkapnya.

Prerequisites

  • Sebuah langganan Azure.

Pasang paket @azure/arm-koreaiartemis

Instal pustaka klien Azure AgentPlatform untuk JavaScript dengan npm:

npm install @azure/arm-koreaiartemis

Membuat dan mengautentikasi AgentPlatformClient

Untuk membuat objek klien guna mengakses API Azure AgentPlatform, Anda memerlukan endpoint sumber daya Azure AgentPlatform Anda dan .credential Klien Azure AgentPlatform dapat menggunakan kredensial Microsoft Entra untuk autentikasi. Anda dapat menemukan endpoint untuk sumber daya Azure AgentPlatform Anda di portal Azure.

Anda dapat mengautentikasi dengan Microsoft Entra ID menggunakan kredensial dari pustaka @azure/identity atau token Microsoft Entra yang ada.

Untuk menggunakan penyedia DefaultAzureCredential yang ditunjukkan di bawah ini, atau penyedia kredensial lain yang disediakan dengan Azure SDK, instal paket :

npm install @azure/identity

Anda juga perlu mendaftarkan aplikasi Microsoft Entra baru dan memberikan akses ke Azure AgentPlatform dengan menetapkan peran yang sesuai kepada principal layanan Anda (catatan: peran seperti tidak "Owner" memberikan izin yang diperlukan).

Untuk informasi lebih lanjut tentang cara membuat aplikasi Microsoft Entra, lihat panduan ini.

Dengan menggunakan lingkungan Node.js dan seperti Node, Anda dapat menggunakan kelas DefaultAzureCredential untuk mengautentikasi klien.

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

Untuk lingkungan browser, gunakan InteractiveBrowserCredential dari paket @azure/identity untuk mengautentikasi.

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

Bundel JavaScript

Untuk menggunakan pustaka klien ini di browser, pertama-tama Anda perlu menggunakan bunder. Untuk detail tentang cara melakukan ini, silakan lihat dokumentasi bundling kami.

Konsep Utama

AgentPlatformClient

AgentPlatformClientadalah antarmuka utama bagi pengembang yang menggunakan pustaka klien Azure AgentPlatform. Jelajahi metode pada objek klien ini untuk memahami berbagai fitur dari layanan Azure AgentPlatform yang dapat Anda akses.

Troubleshooting

Logging

Mengaktifkan pengelogan dapat membantu menemukan informasi yang berguna tentang kegagalan. Untuk melihat log permintaan dan respons HTTP, atur variabel lingkungan AZURE_LOG_LEVEL ke info. Atau, pengelogan dapat diaktifkan saat runtime dengan memanggil setLogLevel di @azure/logger:

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

setLogLevel("info");

Untuk instruksi lebih rinci tentang cara mengaktifkan log, Anda dapat melihat dokumen paket @azure/logger.

Langkah berikutnya

Silakan lihat sampel direktori untuk contoh terperinci tentang cara menggunakan pustaka ini.

Contributing

Jika Anda ingin berkontribusi ke library ini, silakan baca panduan contributor untuk mempelajari lebih lanjut cara membuat dan menguji kode.

  • Terakhir diperbarui pada