JavaScript için Azure VectorDb istemci kitaplığı - sürüm 1.0.0-beta.1

Bu paket, Azure VectorDb istemcisi için bir izomorfik SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.

Önemli bağlantılar:

• Kaynak kodu
• Paketi (NPM)
• API başvuru belgeleri
• Örnekleri

Başlarken

Şu anda desteklenen ortamlar

• Node.js LTS sürümleri
• Safari, Chrome, Edge ve Firefox'un en son sürümleri.

Daha fazla bilgi için bkz. destek ilkesi.

Önkoşullar

• Azure aboneliği.

@azure/arm-pineconevectordb paketini yükleme

npmile JavaScript için Azure VectorDb istemci kitaplığını yükleyin:

npm install @azure/arm-pineconevectordb

VectorDbClient oluşturma ve kimlik doğrulaması

Azure VectorDb API'sine erişmek üzere bir istemci nesnesi oluşturmak için Azure VectorDb kaynağınızın endpoint ve bir credentialgerekir. Azure VectorDb istemcisi kimlik doğrulaması için Azure Active Directory kimlik bilgilerini kullanabilir. Azure VectorDb kaynağınızın uç noktasını Azure Portalbulabilirsiniz.

@azure/identity kitaplığından bir kimlik bilgisi kullanarak veya mevcut AAD Belirteci Azure Active Directory ile kimlik doğrulaması yapabilirsiniz.

Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgisi sağlayıcılarını kullanmak için lütfen @azure/identity paketini yükleyin:

npm install @azure/identity

Ayrıca, hizmet sorumlunuza uygun rolü atayarak yeni bir AAD uygulaması kaydetmeniz ve Azure VectorDb erişimi vermeniz gerekir (not: "Owner" gibi roller gerekli izinleri vermez).

Azure AD Uygulaması oluşturma hakkında daha fazla bilgi için bu kılavuzugöz atın.

Node.js ve Node benzeri ortamları kullanarak istemcinin kimliğini doğrulamak için DefaultAzureCredential sınıfını kullanabilirsiniz.

import { VectorDbClient } from "../src/index.js";
import { DefaultAzureCredential } from "@azure/identity";

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

Tarayıcı ortamlarında kimlik doğrulaması yapmak için @azure/identity paketindeki InteractiveBrowserCredential kullanın.

import { InteractiveBrowserCredential } from "@azure/identity";
import { VectorDbClient } from "../src/index.js";

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

JavaScript Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Temel kavramlar

VectorDbClient

VectorDbClient, Azure VectorDb istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Erişebileceğiniz Azure VectorDb hizmetinin farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.

Sorun giderme

Günlük tutmak

Günlüğe kaydetmeyi etkinleştirmek, hatalarla ilgili yararlı bilgilerin ortaya çıkmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için AZURE_LOG_LEVEL ortam değişkenini infoolarak ayarlayın. Alternatif olarak, @azure/loggersetLogLevel çağrılarak günlükler çalışma zamanında etkinleştirilebilir:

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

setLogLevel("info");

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen örnekleri dizinine göz atın.

Katkıda

Bu kitaplığa katkıda bulunmak istiyorsanız kodu oluşturma ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzu okuyun.

İlgili projeler

• JavaScript için Microsoft Azure SDK