Aracılığıyla paylaş

ai_generate_text işlevi

Ş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 kullanımını önerir.

Söz dizimi

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

Argümanlar

  • prompt: Seçili LLM'ye geçirilen metin komutu olan dize ifadesi.
  • modelName: Yalnızca 'openai/gpt-3.5-turbo' ve 'azure_openai/gpt-35-turbo' dize değişmez değerleri desteklenir.
  • paramN ve valueN: seçilen LLM'nin kimliğini doğrulamak ve yapılandırmak için anahtar-değer çiftleri. Anahtarlar dize sabitleri 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 secret(scope, key) işlevini ve SELECT ... skaler alt sorguyu içerir.
      • 'temperature': Kullanılacak örnekleme sıcaklığı. Değeri, 0 ile 2 arasında olan sayısal bir literaaldir. Varsayılan değer şudur: 1.0.
      • stop: Dizeleri durdurun. Değeri bir STRING literal veya en fazla dört dize literal içeren bir ARRAY<STRING> olabilir. 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ı tanımlayan bir dize sabitidir.
      • 'deploymentName': Gerekli. Değeri, dağıtım adını belirten bir dize sabitidir.
      • 'apiVersion': Gerekli. Değeri, kullanılacak API sürümünü belirten bir dize sabitidir.

İade Ürünler

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

Örnekler

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


> 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.