Membuat dan mengelola hipernim

Pembatasan

Ada beberapa batasan terkait cara menggunakan hipernim dan sinonim kustom:

  • Ukuran pemetaan terbatas. Misalnya, satu string tidak dapat dipetakan ke lebih dari delapan string lainnya.
  • String yang Anda gunakan dalam pemetaan hanya boleh berupa huruf dan angka dengan panjang antara 2 hingga 50 karakter.

Membuat hipernim penelusuran

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • CORPUS_ID: ID korpus target Anda.
  • HYPERNYM_ID: ID hipernim penelusuran. Jika dihilangkan, UUID acak akan dibuat.

Metode HTTP dan URL: 

POST https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms?search_hypernym_id={HYPERNYM_ID}

Isi JSON permintaan: 

{
  "hypernym": "HYPERNYM",
  "hyponyms": "HYPONYM_1",
  "hyponyms": "HYPONYM_2",
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms?search_hypernym_id={HYPERNYM_ID}"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms?search_hypernym_id={HYPERNYM_ID}" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID",
}

Memperbarui hipernim penelusuran

REST & CMD LINE

Kode berikut memperbarui hipernim penelusuran dari ID hipernim tertentu yang ditentukan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • CORPUS_ID: ID korpus target Anda.
  • HYPERNYM_ID: ID hipernim penelusuran. Jika dihilangkan, UUID acak akan dibuat.

Metode HTTP dan URL: 

PATCH https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID

Isi JSON permintaan: 

{
  "hypernym": "UPDATED_HYPERNYM",
  "hyponyms": "UPDATED_HYPONYM_1",
  "hyponyms": "UPDATED_HYPONYM_2",
  "hyponyms": "UPDATED_HYPONYM_3",
}

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID"

PowerShell

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID",
  "hypernym": "UPDATED_HYPERNYM",
  "hyponyms": "UPDATED_HYPONYM_1",
  "hyponyms": "UPDATED_HYPONYM_2",
  "hyponyms": "UPDATED_HYPONYM_3",
}

Mendapatkan hipernim penelusuran

REST & CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • CORPUS_ID: ID korpus target Anda.
  • HYPERNYM_ID: ID hipernim penelusuran. Jika dihilangkan, UUID acak akan dibuat.

Metode HTTP dan URL: 

GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID"

PowerShell

Jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID",
  "hypernym": "HYPERNYM",
  "hyponyms": "HYPONYM_1",
  "hyponyms": "HYPONYM_2",
}

Mencantumkan hipernim penelusuran

REST & CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • CORPUS_ID: ID korpus target Anda.

Metode HTTP dan URL: 

GET https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms"

PowerShell

Jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms" | Select-Object -Expand Content

Anda akan melihat respons JSON seperti berikut:

{
  {
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID_1",
    "hypernym": "HYPERNYM_1",
    "hyponyms": "HYPONYM_1",
    "hyponyms": "HYPONYM_2",
  }
  {
    "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID_2",
    "hypernym": "HYPERNYM_2",
    "hyponyms": "HYPONYM_3",
    "hyponyms": "HYPONYM_4",
  }
}

Menghapus hipernim penelusuran

REST & CMD LINE

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • REGIONALIZED_ENDPOINT: Endpoint mungkin menyertakan awalan yang cocok dengan LOCATION_ID seperti europe-west4-. Lihat selengkapnya tentang endpoint yang diregionalkan.
  • PROJECT_NUMBER: Nomor project Google CloudAnda.
  • LOCATION_ID: Region tempat Anda menggunakan Vertex AI Vision. Misalnya: us-central1, europe-west4. Lihat region yang tersedia.
  • CORPUS_ID: ID korpus target Anda.
  • HYPERNYM_ID: ID hipernim penelusuran. Jika dihilangkan, UUID acak akan dibuat.

Metode HTTP dan URL: 

DELETE https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID

Untuk mengirim permintaan Anda, pilih salah satu opsi berikut:

curl

Jalankan perintah berikut: 

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID"

PowerShell

Jalankan perintah berikut: 

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://warehouse-visionai.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/corpora/CORPUS_ID/searchHypernyms/HYPERNYM_ID" | Select-Object -Expand Content

Anda akan melihat respons JSON yang mirip seperti berikut:

{ }