Chunks

Metoda: korporat.dokumentet.copa.krijoj

Krijon një Chunk .

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

E detyrueshme. Emri i Document ku do të krijohet kjo Chunk . Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Chunk .

Fushat
string name

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të sapokrijuar të Chunk .

Metoda: korporat.dokumentet.copëzat.lista

Liston të gjitha Chunk në një Document .

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

E detyrueshme. Emri i Document që përmban Chunk s. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Parametrat e pyetjes

integer pageSize

Fakultative. Numri maksimal i Chunk për t'u kthyer (për faqe). Shërbimi mund të kthejë më Chunk s.

Nëse nuk specifikohet, do të kthehen më së shumti Chunk s. Kufiri maksimal i madhësisë është 100 Chunk për faqe.

string pageToken

Fakultative. Një shenjë faqeje, e marrë nga një telefonatë e mëparshme chunks.list .

Jepni nextPageToken të kthyer në përgjigje si një argument për kërkesën tjetër për të marrë faqen tjetër.

Gjatë paginimit, të gjithë parametrat e tjerë të dhënë në chunks.list duhet të përputhen me thirrjen që ka dhënë tokenin e faqes.

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Përgjigje nga chunks.list që përmban një listë të faqezuar të Chunk s. Chunk janë renditur sipas chunk.create_time në rritje.create_time.

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk i kthyer s.

string nextPageToken

Një shenjë, e cila mund të dërgohet si pageToken për të tërhequr faqen tjetër. Nëse kjo fushë hiqet, nuk ka më faqe.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}

Metoda: corpora.documents.chunks.get

Merr informacion në lidhje me një Chunk të veçantë.

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /* /chunks /*}
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

string name

E detyrueshme. Emri i Chunk për t'u marrë. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Chunk .

Metoda: corpora.documents.chunks.patch

Përditëson një Chunk .

Pika përfundimtare

patch https: / /generativelanguage.googleapis.com /v1beta /{chunk.name=corpora /* /documents /* /chunks /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}

URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

chunk.name string

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Parametrat e pyetjes

vargu updateMask string ( FieldMask format)

E detyrueshme. Lista e fushave për të përditësuar. Aktualisht, kjo mbështet vetëm përditësimin e Meta të dhënave dhe data customMetadata .

Kjo është një listë e ndarë me presje e emrave plotësisht të kualifikuar të fushave. Shembull: "user.displayName,photo" .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Chunk .

Fushat
objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Chunk .

Metoda: corpora.documents.copëza.fshij

Fshin një Chunk .

Pika përfundimtare

fshi https: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /* /chunks /*}
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të Chunk për fshirje. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Nëse ka sukses, trupi i përgjigjes është bosh.

Metoda: corpora.documents.chunks.batchCreate

Krijimi i grupit Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchCreate
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document ku do të krijohet kjo grumbull i Chunk . Fusha mëmë në çdo CreateChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( CreateChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk për t'u krijuar. Mund të krijohen maksimumi 100 Chunk s në një grup.

Trupi i reagimit

Përgjigje nga chunks.batchCreate që përmban një listë të Chunk .

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk është krijuar.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

CreateChunkRequest

Kërkesë për të krijuar një Chunk .

Fushat
parent string

E detyrueshme. Emri i Document ku do të krijohet kjo Chunk . Shembull: corpora/my-corpus-123/documents/the-doc-abc

objekt chunk object ( Chunk )

E detyrueshme. Chunk për të krijuar.

Përfaqësimi JSON
{
  "parent": string,
  "chunk": {
    object (Chunk)
  }
}

Metoda: corpora.documents.chunks.batchUpdate

Përditësimi i grupit Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchUpdate
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document që përmban Chunk që duhen përditësuar. Fusha mëmë në çdo UpdateChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( UpdateChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk që duhen përditësuar. Një maksimum prej 100 Chunk s mund të përditësohen në një grup.

Trupi i reagimit

Përgjigje nga chunks.batchUpdate që përmban një listë të pjesëve të përditësuara Chunk .

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk është përditësuar.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

UpdateChunkRequest

Kërkesë për të përditësuar një Chunk .

Fushat
objekt chunk object ( Chunk )

E detyrueshme. Chunk për përditësim.

vargu updateMask string ( FieldMask format)

E detyrueshme. Lista e fushave për të përditësuar. Aktualisht, kjo mbështet vetëm përditësimin e Meta të dhënave dhe data customMetadata .

Kjo është një listë e ndarë me presje e emrave plotësisht të kualifikuar të fushave. Shembull: "user.displayName,photo" .

Përfaqësimi JSON
{
  "chunk": {
    object (Chunk)
  },
  "updateMask": string
}

Metoda: corpora.documents.chunks.batchDelete

Fshij në grup Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchDelete
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document që përmban Chunk që duhen fshirë. Fusha mëmë në çdo DeleteChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( DeleteChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk që duhen fshirë.

Trupi i reagimit

Nëse ka sukses, trupi i përgjigjes është bosh.

DeleteChunkRequest

Kërkesë për të fshirë një Chunk .

Fushat
string name

E detyrueshme. Emri i burimit të Chunk për fshirje. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk

Përfaqësimi JSON
{
  "name": string
}

Burimi REST: corpora.documents.chunks

Burimi: copë

Një Chunk është një nënpjesë e një Document që trajtohet si një njësi e pavarur për qëllime të paraqitjes dhe ruajtjes së vektorit. Një Corpus mund të ketë një maksimum prej 1 milion Chunk s.

Fushat
string name

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

createTime string ( Timestamp format)

Vetëm dalje. Vula kohore e kohës kur u krijua Chunk .

Një vulë kohore në formatin RFC3339 UTC "Zulu", me rezolucion nanosekonda dhe deri në nëntë shifra të pjesshme. Shembuj: "2014-10-02T15:01:23Z" dhe "2014-10-02T15:01:23.045123456Z" .

Vargu updateTime string ( Timestamp format)

Vetëm dalje. Vula kohore e përditësimit të fundit të Chunk .

Një vulë kohore në formatin RFC3339 UTC "Zulu", me rezolucion nanosekonda dhe deri në nëntë shifra të pjesshme. Shembuj: "2014-10-02T15:01:23Z" dhe "2014-10-02T15:01:23.045123456Z" .

numri i state enum ( State )

Vetëm dalje. Gjendja aktuale e Chunk .

Përfaqësimi JSON
{
  "name": string,
  "data": {
    object (ChunkData)
  },
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State)
}

ÇunkData

Të dhëna të nxjerra që përfaqësojnë përmbajtjen Chunk .

Fushat
data Union type
data mund të jenë vetëm një nga të mëposhtmet:
stringValue string

Përmbajtja Chunk si varg. Numri maksimal i argumenteve për copë është 2043.

Përfaqësimi JSON
{

  // data
  "stringValue": string
  // Union type
}

Shteti

Gjendjet për ciklin e jetës së një Chunk .

Enums
STATE_UNSPECIFIED Vlera e paracaktuar. Kjo vlerë përdoret nëse gjendja hiqet.
STATE_PENDING_PROCESSING Chunk është duke u përpunuar (ngulitje dhe ruajtja vektoriale).
STATE_ACTIVE Chunk është përpunuar dhe e disponueshme për pyetje.
STATE_FAILED Përpunimi Chunk dështoi.
,

Metoda: korporat.dokumentet.copa.krijoj

Krijon një Chunk .

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

E detyrueshme. Emri i Document ku do të krijohet kjo Chunk . Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Chunk .

Fushat
string name

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të sapokrijuar të Chunk .

Metoda: korporat.dokumentet.copëzat.lista

Liston të gjitha Chunk në një Document .

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

E detyrueshme. Emri i Document që përmban Chunk s. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Parametrat e pyetjes

integer pageSize

Fakultative. Numri maksimal i Chunk për t'u kthyer (për faqe). Shërbimi mund të kthejë më Chunk s.

Nëse nuk specifikohet, do të kthehen më së shumti Chunk s. Kufiri maksimal i madhësisë është 100 Chunk për faqe.

string pageToken

Fakultative. Një shenjë faqeje, e marrë nga një telefonatë e mëparshme chunks.list .

Jepni nextPageToken të kthyer në përgjigje si një argument për kërkesën tjetër për të marrë faqen tjetër.

Gjatë paginimit, të gjithë parametrat e tjerë të dhënë në chunks.list duhet të përputhen me thirrjen që ka dhënë tokenin e faqes.

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Përgjigje nga chunks.list që përmban një listë të faqezuar të Chunk s. Chunk janë renditur sipas chunk.create_time në rritje.create_time.

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk i kthyer s.

string nextPageToken

Një shenjë, e cila mund të dërgohet si pageToken për të tërhequr faqen tjetër. Nëse kjo fushë hiqet, nuk ka më faqe.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ],
  "nextPageToken": string
}

Metoda: corpora.documents.chunks.get

Merr informacion për një Chunk të caktuar.

Pika përfundimtare

merrni https: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /* /chunks /*}
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

string name

E detyrueshme. Emri i Chunk për t'u marrë. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Chunk .

Metoda: corpora.documents.chunks.patch

Përditëson një Chunk .

Pika përfundimtare

patch https: / /generativelanguage.googleapis.com /v1beta /{chunk.name=corpora /* /documents /* /chunks /*}
PATCH https://generativelanguage.googleapis.com/v1beta/{chunk.name=corpora/*/documents/*/chunks/*}

URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

chunk.name string

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Parametrat e pyetjes

vargu updateMask string ( FieldMask format)

E detyrueshme. Lista e fushave për të përditësuar. Aktualisht, kjo mbështet vetëm përditësimin e Meta të dhënave dhe data customMetadata .

Kjo është një listë e ndarë me presje e emrave plotësisht të kualifikuar të fushave. Shembull: "user.displayName,photo" .

Trupi i kërkesës

Trupi i kërkesës përmban një shembull të Chunk .

Fushat
objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

Trupi i reagimit

Nëse është i suksesshëm, trupi i përgjigjes përmban një shembull të Chunk .

Metoda: corpora.documents.copëza.fshij

Fshin një Chunk .

Pika përfundimtare

fshi https: / /generativelanguage.googleapis.com /v1beta /{name=corpora /* /documents /* /chunks /*}
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

string name

E detyrueshme. Emri i burimit të Chunk për fshirje. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk Merr formën corpora/{corpora}/documents/{document}/chunks/{chunk} .

Trupi i kërkesës

Trupi i kërkesës duhet të jetë bosh.

Trupi i reagimit

Nëse ka sukses, trupi i përgjigjes është bosh.

Metoda: corpora.documents.chunks.batchCreate

Krijimi i grupit Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchCreate
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document ku do të krijohet kjo grumbull i Chunk . Fusha mëmë në çdo CreateChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( CreateChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk për t'u krijuar. Mund të krijohen maksimumi 100 Chunk s në një grup.

Trupi i reagimit

Përgjigje nga chunks.batchCreate që përmban një listë të Chunk .

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk është krijuar.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

CreateChunkRequest

Kërkesë për të krijuar një Chunk .

Fushat
parent string

E detyrueshme. Emri i Document ku do të krijohet kjo Chunk . Shembull: corpora/my-corpus-123/documents/the-doc-abc

objekt chunk object ( Chunk )

E detyrueshme. Chunk për të krijuar.

Përfaqësimi JSON
{
  "parent": string,
  "chunk": {
    object (Chunk)
  }
}

Metoda: corpora.documents.chunks.batchUpdate

Përditësimi i grupit Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchUpdate
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document që përmban Chunk që duhen përditësuar. Fusha mëmë në çdo UpdateChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( UpdateChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk që duhen përditësuar. Një maksimum prej 100 Chunk s mund të përditësohen në një grup.

Trupi i reagimit

Përgjigje nga chunks.batchUpdate që përmban një listë të pjesëve të përditësuara Chunk .

Nëse është i suksesshëm, trupi i përgjigjes përmban të dhëna me strukturën e mëposhtme:

Fushat
chunks[] object ( Chunk )

Chunk është përditësuar.

Përfaqësimi JSON
{
  "chunks": [
    {
      object (Chunk)
    }
  ]
}

UpdateChunkRequest

Kërkesë për të përditësuar një Chunk .

Fushat
objekt chunk object ( Chunk )

E detyrueshme. Chunk për përditësim.

vargu updateMask string ( FieldMask format)

E detyrueshme. Lista e fushave për të përditësuar. Aktualisht, kjo mbështet vetëm përditësimin e Meta të dhënave dhe data customMetadata .

Kjo është një listë e ndarë me presje e emrave plotësisht të kualifikuar të fushave. Shembull: "user.displayName,photo" .

Përfaqësimi JSON
{
  "chunk": {
    object (Chunk)
  },
  "updateMask": string
}

Metoda: corpora.documents.chunks.batchDelete

Fshij në grup Chunk s.

Pika përfundimtare

postoni https: / /generativelanguage.googleapis.com /v1beta /{parent=corpora /* /documents /*} /chunks:batchDelete
URL-ja përdor sintaksën e transkodimit të gRPC .

Parametrat e rrugës

parent string

Fakultative. Emri i Document që përmban Chunk që duhen fshirë. Fusha mëmë në çdo DeleteChunkRequest duhet të përputhet me këtë vlerë. Shembull: corpora/my-corpus-123/documents/the-doc-abc Merr formën corpora/{corpora}/documents/{document} .

Trupi i kërkesës

Trupi i kërkesës përmban të dhëna me strukturën e mëposhtme:

Fushat
requests[] object ( DeleteChunkRequest )

E detyrueshme. Mesazhet e kërkesës që specifikojnë Chunk që duhen fshirë.

Trupi i reagimit

Nëse ka sukses, trupi i përgjigjes është bosh.

DeleteChunkRequest

Kërkesë për të fshirë një Chunk .

Fushat
string name

E detyrueshme. Emri i burimit të Chunk për fshirje. Shembull: corpora/my-corpus-123/documents/the-doc-abc/chunks/some-chunk

Përfaqësimi JSON
{
  "name": string
}

Burimi REST: corpora.documents.chunks

Burimi: copë

Një Chunk është një nënpjesë e një Document që trajtohet si një njësi e pavarur për qëllime të paraqitjes dhe ruajtjes së vektorit. Një Corpus mund të ketë një maksimum prej 1 milion Chunk s.

Fushat
string name

E pandryshueshme. Identifikues. Emri i burimit Chunk . ID-ja (emri duke përjashtuar prefiksin "corpora/*/documents/*/chunks/") mund të përmbajë deri në 40 karaktere që janë alfanumerike të vogla ose viza (-). ID-ja nuk mund të fillojë ose të përfundojë me një vizë. Nëse emri është bosh gjatë krijimit, do të krijohet një ID unike e rastësishme me 12 karaktere. Shembull: corpora/{corpus_id}/documents/{document_id}/chunks/123a456b789c

objekti data object ( ChunkData )

E detyrueshme. Përmbajtja për Chunk , siç është vargu i tekstit. Numri maksimal i argumenteve për copë është 2043.

object ( CustomMetadata ) customMetadata[] (Metadata e personalizuar)

Fakultative. Përdoruesi ka dhënë meta të dhëna të personalizuara të ruajtura si çifte çelës-vlerë. Numri maksimal i meta CustomMetadata për copë është 20.

createTime string ( Timestamp format)

Vetëm dalje. Vula kohore e kohës kur u krijua Chunk .

Një vulë kohore në formatin RFC3339 UTC "Zulu", me rezolucion nanosekonda dhe deri në nëntë shifra të pjesshme. Shembuj: "2014-10-02T15:01:23Z" dhe "2014-10-02T15:01:23.045123456Z" .

Vargu updateTime string ( Timestamp format)

Vetëm dalje. Vula kohore e përditësimit të fundit të Chunk .

Një vulë kohore në formatin RFC3339 UTC "Zulu", me rezolucion nanosekonda dhe deri në nëntë shifra të pjesshme. Shembuj: "2014-10-02T15:01:23Z" dhe "2014-10-02T15:01:23.045123456Z" .

numri i state enum ( State )

Vetëm dalje. Gjendja aktuale e Chunk .

Përfaqësimi JSON
{
  "name": string,
  "data": {
    object (ChunkData)
  },
  "customMetadata": [
    {
      object (CustomMetadata)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State)
}

ÇunkData

Të dhëna të nxjerra që përfaqësojnë përmbajtjen Chunk .

Fushat
data Union type
data mund të jenë vetëm një nga të mëposhtmet:
stringValue string

Përmbajtja Chunk si varg. Numri maksimal i argumenteve për copë është 2043.

Përfaqësimi JSON
{

  // data
  "stringValue": string
  // Union type
}

Shteti

Gjendjet për ciklin e jetës së një Chunk .

Enums
STATE_UNSPECIFIED Vlera e paracaktuar. Kjo vlerë përdoret nëse gjendja hiqet.
STATE_PENDING_PROCESSING Chunk është duke u përpunuar (ngulitje dhe ruajtja vektoriale).
STATE_ACTIVE Chunk është përpunuar dhe e disponueshme për pyetje.
STATE_FAILED Përpunimi Chunk dështoi.