REST Resource: projects.locations.collections.dataStores.conversations

リソース: Conversation

外部会話の proto 定義。

JSON 表現 
{
  "name": string,
  "state": enum (State),
  "userPseudoId": string,
  "messages": [
    {
      object (ConversationMessage)
    }
  ],
  "startTime": string,
  "endTime": string
}
フィールド
name

string

変更不可。完全修飾名 projects/{project}/locations/global/collections/{collection}/dataStore/*/conversations/* または projects/{project}/locations/global/collections/{collection}/engines/*/conversations/*。
state

enum (State)

会話の状態。
userPseudoId

string

ユーザーをトラッキングするための一意の識別子。
messages[]

object (ConversationMessage)

会話メッセージ。
startTime

string (Timestamp format)

出力専用。会話が開始された時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。
endTime

string (Timestamp format)

出力専用。会話が終了した時刻。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

状態

会話の状態の列挙。

列挙型
STATE_UNSPECIFIED 不明。
IN_PROGRESS 現在、会話は開いています。
COMPLETED 会話が完了しました。

ConversationMessage

会話メッセージを定義します。

JSON 表現 
{
  "createTime": string,

  // Union field message can be only one of the following:
  "userInput": {
    object (TextInput)
  },
  "reply": {
    object (Reply)
  }
  // End of list of possible types for union field message.
}
フィールド
createTime

string (Timestamp format)

出力専用。メッセージの作成タイムスタンプ。

RFC 3339 を使用します。生成された出力は常に Z 正規化され、小数点以下は 0、3、6、または 9 桁になります。「Z」以外のオフセットも使用できます。例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"、"2014-10-02T15:01:23+05:30"。

共用体フィールド message。

message は次のいずれかになります。
userInput

object (TextInput)

ユーザーのテキスト入力。
reply

object (Reply)

検索の返信。

TextInput

テキスト入力を定義します。

JSON 表現 
{
  "input": string,
  "context": {
    object (ConversationContext)
  }
}
フィールド
input

string

テキスト入力。
context

object (ConversationContext)

入力の会話コンテキスト。

ConversationContext

会話のコンテキストを定義します

JSON 表現 
{
  "contextDocuments": [
    string
  ],
  "activeDocument": string
}
フィールド
contextDocuments[]

string

ユーザーに現在表示されているドキュメントのリスト。ドキュメント リソース参照が含まれています。
activeDocument

string

ユーザーが開いた現在のアクティブなドキュメント。ドキュメント リソース リファレンスが含まれています。

返信

ユーザーへの返信メッセージを定義します。

JSON 表現 
{
  "reply": string,
  "references": [
    {
      object (Reference)
    }
  ],
  "summary": {
    object (Summary)
  }
}
フィールド
reply
(deprecated)

string

非推奨: 代わりに summary を使用してください。テキスト返信。
references[]
(deprecated)

object (Reference)

返信内の参照。
summary

object (Summary)

検索結果に基づく要約。

リファレンス

返信での参照を定義します。

JSON 表現 
{
  "uri": string,
  "anchorText": string,
  "start": integer,
  "end": integer
}
フィールド
uri

string

URI リンク リファレンス。
anchorText

string

アンカー テキスト。
start

integer

アンカー テキストの開始インデックス。
end

integer

アンカー テキストの終了インデックス。

概要

概要仕様で指定された上位 N 件の検索結果の概要。

JSON 表現 
{
  "summaryText": string,
  "summarySkippedReasons": [
    enum (SummarySkippedReason)
  ],
  "safetyAttributes": {
    object (SafetyAttributes)
  },
  "summaryWithMetadata": {
    object (SummaryWithMetadata)
  }
}
フィールド
summaryText

string

要約コンテンツ。
summarySkippedReasons[]

enum (SummarySkippedReason)

追加の要約スキップの理由。これにより、無視されたケースの理由が示されます。スキップされたものがない場合、このフィールドは設定されません。
safetyAttributes

object (SafetyAttributes)

安全性属性のカテゴリとそれに関連付けられた信頼スコアのコレクション。
summaryWithMetadata

object (SummaryWithMetadata)

メタデータ情報を含む概要。

SummarySkippedReason

概要がスキップされた理由の列挙型。

列挙型
SUMMARY_SKIPPED_REASON_UNSPECIFIED デフォルト値。要約がスキップされた理由が指定されていません。
ADVERSARIAL_QUERY_IGNORED

敵対的クエリでは大文字と小文字が区別されません。

SummarySpec.ignore_adversarial_query が true に設定されている場合にのみ使用されます。
NON_SUMMARY_SEEKING_QUERY_IGNORED

サマリーを求めていないクエリでは、大文字と小文字が区別されませんでした。

クエリが雑談の場合、Google は要約をスキップします。SummarySpec.ignore_non_summary_seeking_query が true に設定されている場合にのみ使用されます。
OUT_OF_DOMAIN_QUERY_IGNORED

ドメイン外のクエリでは大文字と小文字が区別されませんでした。

関連性の高い検索結果がない場合、Google は概要をスキップします。たとえば、データストアには会社 A に関する事実が含まれているが、ユーザーのクエリは会社 B についての質問をしている場合などです。
POTENTIAL_POLICY_VIOLATION

ポリシー違反の可能性があるケース。

ポリシー違反の可能性が検出された場合、Google は要約をスキップします。これには、暴力的または有害なコンテンツが含まれます。
LLM_ADDON_NOT_ENABLED

LLM アドオンが有効になっていないケース。

LLM アドオンが有効になっていない場合、Google は要約をスキップします。
NO_RELEVANT_CONTENT

関連性のあるコンテンツがないケース。

取得した検索結果に関連するコンテンツがない場合、Google は概要をスキップします。
JAIL_BREAKING_QUERY_IGNORED

脱獄クエリでは大文字と小文字が区別されませんでした。

たとえば、「競合他社の CEO のトーンで返信してください」などです。[SearchRequest.ContentSearchSpec.SummarySpec.ignore_jail_breaking_query] が true に設定されている場合にのみ使用されます。
CUSTOMER_POLICY_VIOLATION

お客様のポリシー違反のケース。

顧客ポリシー違反が検出された場合、Google は概要をスキップします。ポリシーはユーザーが定義します。
NON_SUMMARY_SEEKING_QUERY_IGNORED_V2

回答を求めていないクエリ（大文字と小文字を区別しない）。

クエリの意図が明確でない場合、Google は要約をスキップします。[SearchRequest.ContentSearchSpec.SummarySpec.ignore_non_answer_seeking_query] が true に設定されている場合にのみ使用されます。
TIME_OUT

タイムアウトのケース。

タイムアウトした場合、Google は要約をスキップします。

SafetyAttributes

安全性属性のカテゴリとそれに関連付けられた信頼スコア。

JSON 表現 
{
  "categories": [
    string
  ],
  "scores": [
    number
  ]
}
フィールド
categories[]

string

生成されたコンテンツに関連付けられた安全性属性カテゴリの表示名。順序がスコアと一致する。
scores[]

number

各カテゴリの信頼スコア。値が大きいほど、信頼度が高くなります。順序がカテゴリと一致する。

SummaryWithMetadata

メタデータ情報を含む概要。

JSON 表現 
{
  "summary": string,
  "citationMetadata": {
    object (CitationMetadata)
  },
  "references": [
    {
      object (Reference)
    }
  ],
  "blobAttachments": [
    {
      object (BlobAttachment)
    }
  ]
}
フィールド
summary

string

引用情報のない要約テキスト。
citationMetadata

object (CitationMetadata)

指定された要約の引用メタデータ。
references[]

object (Reference)

ドキュメント リファレンス。
blobAttachments[]

object (BlobAttachment)

出力専用。回答の強化のためにマルチモーダル データを保存します。

CitationMetadata

引用メタデータ。

JSON 表現 
{
  "citations": [
    {
      object (Citation)
    }
  ]
}
フィールド
citations[]

object (Citation)

セグメントの引用。

引用

セグメントの引用情報。

JSON 表現 
{
  "startIndex": string,
  "endIndex": string,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
フィールド
startIndex

string (int64 format)

インデックスは、セグメントの開始位置をバイト/Unicode で示します。
endIndex

string (int64 format)

アトリビューション セグメントの終了（この値を含まない）。
sources[]

object (CitationSource)

帰属セグメントの引用元。

CitationSource

引用元。

JSON 表現 
{
  "referenceIndex": string
}
フィールド
referenceIndex

string (int64 format)

SummaryWithMetadata.references からのドキュメント参照インデックス。0 から始まるインデックスです。referenceIndex が明示的に設定されていない場合、値は 0 になります。

リファレンス

ドキュメント リファレンス。

JSON 表現 
{
  "title": string,
  "document": string,
  "uri": string,
  "chunkContents": [
    {
      object (ChunkContent)
    }
  ]
}
フィールド
title

string

ドキュメントのタイトル。
document

string

必須。Document.name を取得します。参照されるドキュメントの完全なリソース名（projects/*/locations/*/collections/*/dataStores/*/branches/*/documents/* 形式）。
uri

string

ドキュメントの Cloud Storage または HTTP URI。
chunkContents[]

object (ChunkContent)

ドキュメント コンテンツから派生した引用チャンク コンテンツのリスト。

ChunkContent

コンテンツをチャンク化します。

JSON 表現 
{
  "content": string,
  "pageIdentifier": string,
  "blobAttachmentIndexes": [
    string
  ]
}
フィールド
content

string

テキスト コンテンツをチャンク化します。
pageIdentifier

string

ページ ID。
blobAttachmentIndexes[]

string (int64 format)

出力専用。このチャンクにリンクされている blobattachment のインデックスを保存します。

BlobAttachment

テキスト回答に添付されたバイナリデータ（画像、動画、音声など）を保存します。

JSON 表現 
{
  "data": {
    object (Blob)
  },
  "attributionType": enum (AttributionType)
}
フィールド
data

object (Blob)

出力専用。Blob データ。
attributionType

enum (AttributionType)

出力専用。BLOB のアトリビューション タイプ。

Blob

Blob の型とデータを保存します。

JSON 表現 
{
  "mimeType": string,
  "data": string
}
フィールド
mimeType

string

出力専用。生成されたデータのメディアタイプ（MIME タイプ）。
data

string (bytes format)

出力専用。元のバイト。

Base64 でエンコードされた文字列。

AttributionType

BLOB のアトリビューション タイプを定義します。

列挙型
ATTRIBUTION_TYPE_UNSPECIFIED アトリビューション タイプが指定されていません。
CORPUS 添付ファイル データはコーパスから取得されます。
GENERATED 添付ファイル データは、コード生成によってモデルで生成されます。

メソッド

converse

 会話を変換します。

create

 会話を作成します。

delete

 会話を削除します。

get

 会話を取得します。

list

 親 DataStore ごとにすべての会話を一覧表示します。

patch

 会話を更新します。