Question answering

Yöntem: model.generateAnswer

GenerateAnswerRequest girişi verilen modelden kesin bir yanıt oluşturur.

Uç nokta

yayınlayacağım https://generativelanguage.googleapis.com/v1beta/{model=models/*}:generateAnswer

Yol parametreleri

model string

Zorunlu. Temelli yanıt oluşturmak için kullanılacak Model öğesinin adı.

Biçim: model=models/{model}. models/{model} biçimindedir.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

Alanlar
contents[] object (Content)

Zorunlu. Modelle olan mevcut görüşmenin içeriği. Tek dönüşlü sorgular için bu yanıtlanacak tek bir sorudur. Çok dönüşlü sorgularda bu, sohbet geçmişini ve soruyu içeren listedeki son Content bölümünü içeren tekrarlanan bir alandır.

Not: model.generateAnswer şu anda yalnızca İngilizce sorguları desteklemektedir.

answerStyle enum (AnswerStyle)

Zorunlu. Yanıtların döndürülmesi gereken stil.

safetySettings[] object (SafetySetting)

İsteğe bağlı. Güvenli olmayan içeriği engellemek için benzersiz SafetySetting örneklerinin listesi.

Bu değişiklik GenerateAnswerRequest.contents ve GenerateAnswerResponse.candidate web sitesinde zorunlu kılınacaktır. Her SafetyCategory türü için birden fazla ayar olmamalıdır. API, bu ayarlarla belirlenen eşikleri karşılamayan tüm içerik ve yanıtları engeller. Bu liste, SafetySettings'te belirtilen her bir SafetyCategory için varsayılan ayarları geçersiz kılar. Listede sağlanan belirli bir SafetyCategory için SafetySetting yoksa API, söz konusu kategori için varsayılan güvenlik ayarını kullanır. HARM_CATEGORY_HATE_SPEECH, HARM_CATEGORY_SEXUALLY_EXPLICIT, HARM_CATEGORY_DANGEROUS_CONTENT, HARM_CATEGORY_HARASSMENT zarar kategorileri desteklenir.

Birleştirme alanı grounding_source. Yanıtı temel alacak kaynaklar. grounding_source şunlardan yalnızca biri olabilir:
inlinePassages object (GroundingPassages)

İstekle birlikte sağlanan pasajlar.

semanticRetriever object (SemanticRetrieverConfig)

Semantic Retriever API ile oluşturulan kaynaklardan alınan içerik.

temperature number

İsteğe bağlı. Çıkışın rastgeleliğini kontrol eder.

Değerler [0,0,1,0] dahil olmak üzere bu değerler arasında değişebilir. 1,0'a yakın bir değer, daha çeşitli ve yaratıcı yanıtlar sunarken 0,0'a yakın bir değer genellikle modelin daha doğrudan yanıt vermesini sağlar. İlişkilendirilmiş Soru-Cevap özelliğinin kullanım alanlarında genellikle düşük bir sıcaklığın (~0,2) olması önerilir.

Yanıt gövdesi

Geçerli bir yanıt için modelin yanıtı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

Alanlar
answer object (Candidate)

Modelden Aday yanıt.

Not: Model, belirtilen pasajlardan yola çıkılarak yanıtlanma olasılığı düşük olsa bile her zaman sağlam bir yanıt vermeye çalışır. Bu durumda, düşük answerableProbability değeriyle birlikte düşük kaliteli veya temelsiz bir yanıt verilebilir.

answerableProbability number

Yalnızca çıkış. Modelin, yanıtının doğru olma olasılığına ilişkin tahmini. Bu tahmin, giriş metinlerini temel alır.

Düşük answerableProbability , yanıtın kaynaklara dayandırılmamış olabileceğini gösterir.

answerableProbability düşük olduğunda bazı müşteriler:

  • "Bu soruyu yanıtlayamadık" şeklinde bir mesaj görüntüle kullanıcıya gösterir.
  • Dünyayla ilgili bilgilerden yola çıkarak bu soruyu yanıtlayan genel amaçlı bir LLM'ye geri dönün. Bu tür yedeklerin eşiği ve niteliği, her bir müşterinin kullanım alanına bağlıdır. 0,5 iyi bir başlangıç eşiğidir.
inputFeedback object (InputFeedback)

Yalnızca çıkış. Soru için model tarafından oluşturulan yanıtın aksine, soruyu cevaplamak için kullanılan giriş verileriyle ilgili geri bildirim.

"Giriş verileri" aşağıdakilerden biri veya daha fazlası olabilir:

  • Soru, GenerateAnswerRequest.content alanındaki son girişte belirtildi
  • GenerateAnswerRequest.content içindeki diğer girişler tarafından belirtilen görüşme geçmişi
  • Topraklama kaynakları (GenerateAnswerRequest.semantic_retriever veya GenerateAnswerRequest.inline_passages)
JSON gösterimi 
{
  "answer": {
    object (Candidate)
  },
  "answerableProbability": number,
  "inputFeedback": {
    object (InputFeedback)
  }
}

GroundingPassages

Tekrarlanan pasaj listesi.

JSON gösterimi 
{
  "passages": [
    {
      object (GroundingPassage)
    }
  ]
}
Alanlar
passages[] object (GroundingPassage)

Pasaj listesi.

GroundingPassage

Topraklama yapılandırmasına satır içi olarak dahil edilen geçit.

JSON gösterimi 
{
  "id": string,
  "content": {
    object (Content)
  }
}
Alanlar
id string

Bu pasajı sağlam yanıtlarla ilişkilendirmek için kullanılan pasajın tanımlayıcısı.

content object (Content)

Pasajın içeriği.

SemanticRetrieverConfig

Semantic Retriever API kullanılarak oluşturulmuş bir Corpus veya Document cihazından topraklama içeriği almak için yapılandırma.

JSON gösterimi 
{
  "source": string,
  "query": {
    object (Content)
  },
  "metadataFilters": [
    {
      object (MetadataFilter)
    }
  ],
  "maxChunksCount": integer,
  "minimumRelevanceScore": number
}
Alanlar
source string

Zorunlu. Alınacak kaynağın adı, ör. colora/123 veya Corpora/123/documents/abc.

query object (Content)

Zorunlu. Belirli bir kaynaktaki Chunk'ler ile benzerlik eşleştirmesi için kullanılacak sorgu.

metadataFilters[] object (MetadataFilter)

İsteğe bağlı. Kaynaktan Document ve/veya Chunk seçimi için filtreler.

maxChunksCount integer

İsteğe bağlı. Alınabilecek maksimum ilgili Chunk sayısı.

minimumRelevanceScore number

İsteğe bağlı. Alınan alakalı Chunk için minimum alaka düzeyi puanı.

AnswerStyle

Güvenilir yanıtlar için stil.

Sıralamalar
ANSWER_STYLE_UNSPECIFIED Belirtilmemiş yanıt stili.
ABSTRACTIVE Kısa ancak soyut bir tarz.
EXTRACTIVE Çok kısa ve dışa dönük bir stil.
VERBOSE Ekstra ayrıntılar içeren ayrıntılı stil. Yanıt bir cümle, paragraf, birden fazla paragraf veya madde işareti vb. biçiminde olabilir.

InputFeedback

Soru için model tarafından oluşturulan yanıtın aksine, soruyu cevaplamak için kullanılan giriş verileriyle ilgili geri bildirim.

JSON gösterimi 
{
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "blockReason": enum (BlockReason)
}
Alanlar
safetyRatings[] object (SafetyRating)

Girişin güvenliğiyle ilgili derecelendirmeler. Kategori başına en fazla bir derecelendirme vardır.

blockReason enum (BlockReason)

İsteğe bağlı. Ayarlanırsa giriş engellenir ve hiçbir öneri döndürülmez. Girişinizi farklı bir şekilde ifade edin.

BlockReason

Girişin engellenmesinin nedenini belirtir.

Sıralamalar
BLOCK_REASON_UNSPECIFIED Varsayılan değer. Bu değer kullanılmıyor.
SAFETY Güvenlik nedeniyle giriş engellendi. safetyRatings uygulamasını inceleyerek hangi güvenlik kategorisinin engellediğini öğrenebilirsiniz.
OTHER Giriş, başka nedenlerden dolayı engellendi.