OpenSearch:Model kustom

Create a model

Navigasi ke Model Management > Custom Models, lalu klik Create Model.

Pada kotak dialog yang muncul, gunakan editor JSON untuk mengisi templat konfigurasi. Bidang utama meliputi modelName, request (yang berisi header, parameters, dan method), response, modelType, dan url. Setelah selesai mengonfigurasi model, klik OK.

Custom model format

{
  "modelName": "custom_model",
  "modelType": "text_embedding",
  "dimension": 1536,
  "url": "http://xxx/api/v2/services/embeddings",
  "method": "POST",
  "request": {
    "header": {
      "Authorization": "fj42091fjlgnlsvu023nva",
      "Content-Type": "application/json"
    },
    "urlParams": {
      "build": {},
      "search": {}
    },
    "requestBody": "{\"input\": [\"%{input}\"], \"input_type\": \"${input_type}\"}",
    "parameters": {
      "build": {
        "input_type": "document"
      },
      "search": {
        "input_type": "query"
      }
    }
  },
  "response": {
    "embeddings": "$.result.embeddings[*].embedding"
  }
}

Parameters

Parameter	Description
modelName	Nama model.
modelType	Jenis model. Anda dapat mengatur parameter ini ke salah satu nilai berikut: text_embedding: Model teks padat. text_sparse_embedding: Model teks sparse. image_embedding: Model vektor gambar. image_analyze: Model analisis konten gambar.
dimension	Dimensi vektor yang dihasilkan oleh model. Parameter ini wajib diisi ketika modelType diatur ke text_embedding atau image_embedding.
url	Titik akhir layanan model.
method	Metode HTTP untuk mengakses layanan model. Metode yang didukung adalah POST dan PUT.
request	Menentukan permintaan yang dikirim ke layanan model.
request.header	Header permintaan HTTP. Header ini diteruskan ke layanan model tanpa perubahan.
request.urlParams	Parameter yang disertakan dalam URL. Beberapa layanan model memerlukan parameter yang dilewatkan melalui URL, seperti ?abc=123.
request.urlParams.build	Parameter yang dilewatkan selama fase pembuatan indeks.
request.urlParams.search	Parameter yang dilewatkan selama fase kueri.
request.requestBody	String templat untuk badan permintaan. Format variabel templat: %{parameter_name}. Contoh: {"input": "%{input}"} Variabel bawaan: %{input}: Mewakili teks input. %{modal}: Mewakili modalitas. Gunakan variabel ini dengan model multimodal untuk menentukan modalitas dalam kueri Anda.
request.parameters	Menentukan parameter badan permintaan spesifik fase. Gunakan ini jika Anda memerlukan parameter berbeda untuk fase pembuatan indeks dan fase kueri. build: Parameter untuk fase pembuatan indeks. search: Parameter untuk fase kueri.
response	Menentukan cara mengurai tanggapan layanan model menggunakan ekspresi JSONPath.

JSONPath

Operators

Operator	Description
$	Mewakili elemen root. Jalur harus dimulai dengan $.
*	Karakter wildcard yang cocok dengan nilai apa pun. Dapat digunakan sebagai pengganti nama properti atau indeks array.
.<name>	Memilih properti objek.
[<number>]	Memilih elemen array berdasarkan indeksnya.

Example

{
  "store": {
    "books": [
      {
        "title": "java",
        "price": 56
      },
      {
        "title": "c++",
        "price": 99
      }
    ]
  }
}

• Untuk mengekstraksi judul semua buku:

  • JSONPath: $.store.books[*].title

  • Hasil: ["java", "c++"]

• Untuk mengekstraksi judul buku pertama:

  • JSONPath: $.store.books[0].title

  • Hasil: ["java"]

Model management

• Debug: Di halaman Models > Custom Models, klik Debug pada kolom Actions untuk menguji model Anda.

• Disable: Menonaktifkan model mencegah tabel yang menggunakannya dari memproses data dan kueri. Lakukan dengan hati-hati.

• Delete: Anda hanya dapat menghapus model yang telah dinonaktifkan.

• Restore: Anda dapat memulihkan model yang dinonaktifkan.

Calling models

Saat mengonfigurasi tabel, klik Configure untuk bidang yang memerlukan pra-pemrosesan data. Anda kemudian dapat memilih model kustom Anda dari daftar Model.

Dalam daftar drop-down Model, model bawaan tercantum di bagian atas. Model kustom Anda muncul di bagian bawah daftar dan diawali dengan Custom, misalnya, "Custom test1".