ai_chat_completion eklentisi (önizleme)

Sürüm açılan listesini kullanarak hizmetler arasında geçiş yapın. Gezinti hakkında daha fazla bilgi edinin.
Şunlar için geçerlidir: ✅ Microsoft Fabric ✅ Azure Veri Gezgini

Eklenti, ai_chat_completion konuşma yapay zekası ve etkileşimli sistemler gibi yapay zekayla ilgili senaryoları destekleyen dil modellerini kullanarak sohbet tamamlamaları oluşturulmasını sağlar. Eklenti, Azure OpenAI Hizmeti sohbet uç noktasını kullanır ve yönetilen kimlik veya kullanıcının kimliği (kimliğe bürünme) kullanılarak erişilebilir.

Eklenti, ai_chat_completion konuşma yapay zekası ve etkileşimli sistemler gibi yapay zekayla ilgili senaryoları destekleyen dil modellerini kullanarak sohbet tamamlamaları oluşturulmasını sağlar. Eklenti, Azure OpenAI Hizmeti sohbet uç noktasını kullanır ve kullanıcının kimliği (kimliğe bürünme) kullanılarak erişilebilir.

Önkoşullar

  • Azure OpenAI Hizmeti'ne erişmek için yönetilen kimlik kullanırken, Yönetilen Kimlik İlkesi'ni hizmetle iletişime izin verecek şekilde yapılandırın.

Sözdizimi

evaluate ai_chat_completion ( Sohbet, ConnectionString [,Seçenekler [,IncludeErrorMessages]])

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

İsim Türü Gerekli Açıklama
sohbet dynamic ✔️ Şu ana kadarki konuşmayı içeren bir dizi ileti. Değer bir sütun başvurusu veya sabit skaler olabilir.
ConnectionString string ✔️ Dil modelinin biçimindeki <ModelDeploymentUri>;<AuthenticationMethod>bağlantı dizesi ; yerine yapay zeka modeli dağıtım URI'sini ve kimlik doğrulama yöntemini ekleyin <ModelDeploymentUri><AuthenticationMethod>.
Seçenekleri dynamic Sohbet modeli uç noktasına yapılan çağrıları denetleyebilen seçenekler. Bkz. Seçenekler.
IncludeErrorMessages bool Çıkış tablosundaki yeni bir sütunda hata çıkışı yapılıp yapılmayacağını gösterir. Varsayılan değer: false.

Seçenekler

Aşağıdaki tabloda, isteklerin sohbet modeli uç noktasına nasıl yapıldığı denetlenen seçenekler açıklanmaktadır.

İsim Türü Açıklama
RetriesOnThrottling int Azaltma gerçekleştiğinde yeniden deneme denemelerinin sayısını belirtir. Varsayılan değer: 0.
GlobalTimeout timespan Yapay zeka sohbet modelinden yanıt bekleme süresi üst sınırını belirtir. Varsayılan değer: null.
ModelParameters dynamic Yapay zeka sohbet modeline özgü parametreler. Olası değerler: , , , , temperature, top_p, stop, max_tokens, max_completion_tokenspresence_penalty. frequency_penaltyuserseed Belirtilen diğer model parametreleri yoksayılır. Varsayılan değer: null.
ReturnSuccessfulOnly bool Yalnızca başarıyla işlenen öğelerin döndürülip döndürülmeyeceğini gösterir. Varsayılan değer: false. IncludeErrorMessages parametresi olarak ayarlandıysatrue, bu seçenek her zaman olarak falseayarlanır.

Belirtme Çizgisi İlkesini Yapılandırma

Açıklama azure_openaibalonu ilkesi , Azure AI hizmetlerine dış çağrılar sağlar.

Açıklama balonu ilkesini yapay zeka modeli uç noktası etki alanını yetkilendirilecek şekilde yapılandırmak için:

.alter-merge cluster policy callout
```
[
  {
    "CalloutType": "azure_openai",
    "CalloutUriRegex": "https://[A-Za-z0-9-]{3,63}\.(?:openai\\.azure\\.com|cognitiveservices\\.azure\\.com|cognitive\\.microsoft\\.com|services\\.ai\\.azure\\.com)(?:/.*)?",
    "CanCall": true
  }
]
```

Yönetilen Kimliği Yapılandırma

Azure OpenAI Hizmeti'ne erişmek için yönetilen kimlik kullanırken, sistem tarafından atanan yönetilen kimliğin Azure OpenAI Hizmetinde kimlik doğrulamasına izin verecek şekilde Yönetilen Kimlik ilkesini yapılandırmanız gerekir.

Yönetilen kimliği yapılandırmak için:

.alter-merge cluster policy managed_identity
```
[
  {
    "ObjectId": "system",
    "AllowedUsages": "AzureAI"
  }
]
```

İade

Aşağıdaki yeni sohbet tamamlama sütunlarını döndürür:

  • Sohbet tamamlama değerlerini içeren _chat_completion soneki içeren bir sütun.
  • Hata döndürecek şekilde yapılandırılmışsa, hata dizelerini içeren veya işlem başarılı olursa boş bırakılan _chat_completion_error soneki olan bir sütun.

Giriş türüne bağlı olarak eklenti farklı sonuçlar döndürür:

  • Sütun başvurusu: Başvuru sütunu adına ek sütun ekli bir veya daha fazla kayıt döndürür. Örneğin, giriş sütunu PromptData olarak adlandırılırsa, çıkış sütunları PromptData_chat_completion olarak adlandırılır ve hata döndürecek şekilde yapılandırılmışsa PromptData_chat_completion_error.
  • Sabit skaler: Ön eki olmayan ek sütunlar içeren tek bir kayıt döndürür. Sütun adları _chat_completion ve hata döndürecek şekilde yapılandırılmışsa _chat_completion_error.

Örnekler

Aşağıdaki örnek, Azure OpenAI sohbet tamamlama modeline girişteki sonraki tüm sohbet iletilerinin bağlamını ayarlamak için sistem istemini kullanır.

let connectionString = 'https://myaccount.openai.azure.com/openai/deployments/gpt4o/chat/completions?api-version=2024-06-01;managed_identity=system';
let messages = dynamic([{'role':'system', 'content': 'You are a KQL writing assistant'},{'role':'user', 'content': 'How can I restrict results to just 10 records?'}]);
evaluate ai_chat_completion(messages, connectionString);

let connectionString = 'https://myaccount.openai.azure.com/openai/deployments/gpt4o/chat/completions?api-version=2024-06-01;impersonate';
let messages = dynamic([{'role':'system', 'content': 'You are a KQL writing assistant'},{'role':'user', 'content': 'How can I restrict results to just 10 records?'}]);
evaluate ai_chat_completion(messages, connectionString);

İlgili içerik

  • Last updated on