Aracılığıyla paylaş

ai_generate_text işlevi

  • Makale

Şunlar için geçerlidir: onay işareti evet olarak işaretlenmiş Databricks SQL

Önemli

Bu özellik Genel Önizlemededir.

Uyarı

Yapay zeka işlevi ai_generate_text() kullanım dışıdır. Databricks, dış modellerle ai_query kullanılmasını önerir.

İstemi göz önünde bulundurarak seçilen büyük dil modeli (LLM) tarafından oluşturulan metni döndürür.

Gereksinimler

  • Bu işlev yalnızca Databricks SQL Pro ve Sunucusuz'da kullanılabilir.
  • Bu işlev kullanım dışıdır. Databricks, dış modellerle ai_query önerir.

Söz dizimi

ai_generate_text(prompt, modelName[, param1, value1] [...])

Bağımsız değişkenler

  • prompt: Seçili LLM'ye geçirilen metin istemi olan dize ifadesi.
  • modelName: Yalnızca ve 'azure_openai/gpt-35-turbo' dize değişmez değeri 'openai/gpt-3.5-turbo' desteklenir.
  • paramN ve valueN: seçilen LLM'nin kimliğini doğrulamak ve yapılandırmak için anahtar-değer çiftleri. Anahtarlar dize değişmez değerleri olmalı ve büyük/küçük harfe duyarlı olmalıdır. Değerlerin türleri aşağıdaki anahtarlara bağlıdır:
    • Model 'openai/gpt-3.5-turbo' , Open AI'deki sohbet tamamlama API'sini kullanır. Aşağıdaki parametreleri destekler:
      • 'apiKey':Gerekli. Model uç noktasına erişmek için OpenAI API anahtarı. Belirtilen değer açık bir sabit dize olamaz. Önerilen değer gizli dizi (kapsam, anahtar) işlevini ve SELECT ... skaler alt sorgularını içerir.
      • 'temperature': Kullanılacak örnekleme sıcaklığı. Değeri ile 2arasında 0 sayısal bir değişmez değerdir. Varsayılan değer şudur: 1.0.
      • stop: Dizeleri durdurun. Değeri bir STRING değişmez değer veya ARRAY<STRING> en fazla 4 dize değişmez değeridir. Varsayılan değer boştur.
    • Model 'azure_openai/gpt-35-turbo' , Azure OpenAI Hizmeti'nden sohbet tamamlama API'sini kullanır. Yukarıdaki 'openai/gpt-3.5-turbo' modeldeki tüm parametreleri ve uç nokta URL'sini oluşturmak için ek parametreleri kabul eder. Databricks yalnızca API Anahtarı kimlik doğrulamayı destekler.
      • 'resourceName':Gerekli. Değeri, kaynak adını belirten bir dize değişmez değeridir.
      • 'deploymentName':Gerekli. Değeri, dağıtım adını belirten bir dize değişmez değeridir.
      • 'apiVersion':Gerekli. Değeri, kullanılacak API sürümünü belirten bir dize değişmez değeridir.

Döndürülenler

Seçili LLM'den yeniden oluşturulan metni temsil eden bir dize ifadesi.

Örnekler

İşlevin örnek kullanım örneği için bkz . ai_generate_text() ve OpenAI ile müşteri incelemelerini analiz etme ai_generate_text .


> SELECT ai_generate_text('Hello', 'openai/gpt-3.5-turbo',
    'apiKey', secret('ml', 'key'),
    'temperature', 0.1);

  Hello! How can I assist you today?

> SELECT ai_generate_text('Hello',
    'azure_openai/gpt-35-turbo',
    'apiKey', secret('ml', 'key'),
    'resouceName', 'resource',
    'deploymentName', 'deploy',
    'apiVersion', '2023-03-15-preview',
    'temperature', 0.1);

  Hello! How can I assist you today?

> SELECT ai_generate_text('Hello', 'openai/gpt-3.5-turbo',
    'apiKey', (SELECT secret FROM secrets.open_ai_tokens LIMIT 1),
    'temperature', 0.1);

  Hello! How can I assist you today?

> CREATE FUNCTION summarize(text STRING)
  RETURNS STRING
  RETURN AI_GENERATE_TEXT(
    CONCAT('Summarize the following text: ',
      text),
    'openai/gpt-3.5-turbo',
    'apiKey', (SELECT secret FROM secrets.open_ai_tokens LIMIT 1),
    'temperature', 0.1
  );

  SELECT summarize('This is the text to be summarized.')

  This is the summarization.

> SELECT ai_generate_text('Hello',
    'openai/gpt-3.5-turbo',
    'apiKey', 'sg-xxxxxxxxxxxxxxxxxxxxxx',
    'temperature', 0.1);

 Error: DATATYPE_MISMATCH.INVALID_SECRET
 The parameter value of the "apiKey" argument to the ai_generate_text function can not be a constant 'sg-xxxxxxxxxxxxxxxxxxxxxx'. Recommended usages include `secret(scope, key)` function or a `SELECT ...` subquery.