Halaman ini diterjemahkan oleh Cloud Translation API.

Membuat aplikasi penelusuran

Halaman ini menjelaskan cara membuat aplikasi penelusuran.

Buat aplikasi

Konsol

Untuk menggunakan konsol Google Cloud guna membuat aplikasi penelusuran, ikuti langkah-langkah berikut:

Di konsol Google Cloud, buka halaman Agent Builder.

Agent Builder
Di halaman Aplikasi, klik Buat aplikasi.
Di halaman Create App, klik Create di bagian Search for your website.
Tentukan apakah Anda menginginkan fitur Enterprise untuk aplikasi ini, lalu klik tombol untuk mengaktifkan atau menonaktifkannya.

Mengaktifkan fitur edisi Enterprise diperlukan untuk mendapatkan fitur seperti penelusuran situs dan memilih wilayah untuk aplikasi Anda. Fitur edisi Enterprise akan dikenai biaya tambahan. Untuk informasi selengkapnya, lihat Fitur edisi Enterprise.
Tentukan apakah Anda menginginkan fitur LLM Lanjutan untuk aplikasi ini, lalu klik tombol untuk mengaktifkan atau menonaktifkannya.

Mengaktifkan fitur LLM Lanjutan diperlukan untuk mendapatkan fitur seperti ringkasan penelusuran atau penelusuran dengan tindak lanjut. Untuk informasi selengkapnya, lihat Fitur LLM lanjutan.
Di kolom Nama aplikasi Anda, masukkan nama untuk aplikasi Anda.
Di kolom Nama eksternal perusahaan atau organisasi Anda, masukkan nama umum untuk perusahaan atau organisasi Anda. Anda tidak perlu menyertakan akhiran seperti Inc atau LLC. Kolom ini berguna bagi LLM untuk mengidentifikasi perusahaan yang diwakili aplikasi.
Pilih lokasi untuk aplikasi Anda. Fitur Enterprise harus diaktifkan untuk memilih lokasi. Google merekomendasikan agar Anda menggunakan setelan default, global (Global), kecuali jika Anda memiliki alasan untuk membatasi data ke geografi tertentu.
Klik Lanjutkan.
Untuk terhubung ke penyimpanan data, di halaman Data Stores, pilih penyimpanan data yang sebelumnya Anda buat atau buat penyimpanan data baru.

Catatan: Jika Anda berencana untuk melampirkan lebih dari satu penyimpanan data ke aplikasi, tinjau kemampuan dan batasan melakukannya di Tentang penelusuran gabungan. Jika hanya melampirkan satu penyimpanan data, Anda tidak dapat melampirkan lebih banyak nanti.

Lakukan setidaknya salah satu hal berikut:
- Pilih penyimpanan data yang ada.
  
  Jika hanya melampirkan satu penyimpanan data, Anda tidak dapat menghapusnya atau menambahkan penyimpanan data lain ke aplikasi ini nanti. Jika melampirkan beberapa penyimpanan data, Anda dapat mengubah penyimpanan data yang dilampirkan nanti, tetapi aplikasi ini harus selalu memiliki minimal dua penyimpanan data yang dilampirkan.
- Buat penyimpanan data baru dan serap data ke dalamnya.
  
  Lakukan ini dengan mengklik Create data store dan mengikuti langkah-langkah di panel Create a new data store yang terbuka. Kemudian, pilih datastore baru Anda. Untuk mengetahui informasi selengkapnya, lihat Membuat penyimpanan data penelusuran.
Opsional: Untuk melihat daftar penyimpanan data yang tidak tersedia, klik Pelajari alasannya.

Tabel ditampilkan dengan daftar penyimpanan data dan alasan mengapa penyimpanan data tersebut tidak tersedia. Berikut beberapa alasan penyimpanan data mungkin tidak tersedia:
- Jenis penyimpanan data Anda hanya mengizinkan koneksi ke satu aplikasi dan penyimpanan data sudah terhubung.
- Penyimpanan data dan aplikasi Anda berada di region yang berbeda.
- Penyimpanan data dan aplikasi Anda memiliki jenis yang berbeda. Misalnya, Anda tidak dapat menghubungkan penyimpanan data penelusuran layanan kesehatan ke aplikasi penelusuran situs.
- Penampung data Anda memiliki penelusuran situs dasar, sedangkan aplikasi penelusuran situs Anda memerlukan penampung data dengan pengindeksan situs lanjutan.
Klik Create.

REST

Sebelum menggunakan command line untuk membuat aplikasi, Anda harus memiliki penyimpanan data yang sudah ada. Jika Anda tidak memiliki penyimpanan data, buat penyimpanan data dengan mengikuti langkah-langkah di Membuat penyimpanan data dan menyerap data untuk Vertex AI Search.

Untuk menggunakan metode engines.create guna membuat aplikasi penelusuran dari command line, ikuti langkah-langkah berikut:

Temukan ID penyimpanan data Anda. Jika Anda sudah memiliki ID penyimpanan data, lanjutkan ke langkah berikutnya.
1. Di konsol Google Cloud, buka halaman Agent Builder dan di menu navigasi, klik Data Stores.
  
  Buka halaman Data Store
2. Klik nama penyimpanan data Anda.
3. Di halaman Data untuk penyimpanan data Anda, dapatkan ID penyimpanan data.
Buat aplikasi penelusuran dan hubungkan ke penyimpanan data. Penyimpanan data hanya dapat dilampirkan ke satu aplikasi dan tidak dapat dihapus dari aplikasi nanti.

Istilah Penting: Di Vertex AI Search, istilah aplikasi dapat digunakan secara bergantian dengan istilah mesin dalam konteks API.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines?engineId=APP_ID" \
-d '{
  "displayName": "APP_DISPLAY_NAME",
  "dataStoreIds": ["DATA_STORE_ID"],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
     "searchTier": "SEARCH_TIER",
     "searchAddOns": ["SEARCH_ADD_ON"]
   }
}'
```
Ganti kode berikut:
- PROJECT_ID: ID project Google Cloud Anda.
- APP_ID: ID aplikasi Vertex AI Search yang ingin Anda buat.
- APP_DISPLAY_NAME: nama tampilan aplikasi Vertex AI Search yang ingin Anda buat.
- DATA_STORE_ID: ID penyimpanan data Vertex AI Search yang ada yang ingin Anda tambahkan ke aplikasi Vertex AI Search.
- SEARCH_TIER: tingkat penelusuran dapat berupa SEARCH_TIER_STANDARD atau SEARCH_TIER_ENTERPRISE. SEARCH_TIER_ENTERPRISE diperlukan untuk mendapatkan fitur seperti penelusuran situs dan memilih wilayah untuk aplikasi Anda. Fitur edisi Enterprise akan dikenai biaya tambahan. Untuk mengetahui informasi selengkapnya, lihat Fitur edisi Enterprise.
- SEARCH_ADD_ON: Jika Anda menginginkan fitur LLM Lanjutan untuk aplikasi ini, tentukan SEARCH_ADD_ON_LLM. Fitur LLM lanjutan mencakup ringkasan penelusuran dan penelusuran dengan tindak lanjut.
  
  Jika Anda tidak menginginkan fitur LLM Lanjutan, tentukan SEARCH_ADD_ON_UNSPECIFIED atau hapus kolom searchAddOns.
  
  Untuk informasi selengkapnya, lihat Fitur LLM lanjutan.

Python

Untuk mengetahui informasi selengkapnya, lihat Dokumentasi referensi API Python Vertex AI Agent Builder.

Untuk melakukan autentikasi ke Vertex AI Agent Builder, siapkan Kredensial Default Aplikasi. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan autentikasi untuk lingkungan pengembangan lokal.

from typing import List

from google.api_core.client_options import ClientOptions
from google.cloud import discoveryengine_v1 as discoveryengine

# TODO(developer): Uncomment these variables before running the sample.
# project_id = "YOUR_PROJECT_ID"
# location = "YOUR_LOCATION" # Values: "global"
# engine_id = "YOUR_ENGINE_ID"
# data_store_ids = ["YOUR_DATA_STORE_ID"]


def create_engine_sample(
    project_id: str, location: str, engine_id: str, data_store_ids: List[str]
) -> str:
    #  For more information, refer to:
    # https://cloud.google.com/generative-ai-app-builder/docs/locations#specify_a_multi-region_for_your_data_store
    client_options = (
        ClientOptions(api_endpoint=f"{location}-discoveryengine.googleapis.com")
        if location != "global"
        else None
    )

    # Create a client
    client = discoveryengine.EngineServiceClient(client_options=client_options)

    # The full resource name of the collection
    # e.g. projects/{project}/locations/{location}/collections/default_collection
    parent = client.collection_path(
        project=project_id,
        location=location,
        collection="default_collection",
    )

    engine = discoveryengine.Engine(
        display_name="Test Engine",
        # Options: GENERIC, MEDIA, HEALTHCARE_FHIR
        industry_vertical=discoveryengine.IndustryVertical.GENERIC,
        # Options: SOLUTION_TYPE_RECOMMENDATION, SOLUTION_TYPE_SEARCH, SOLUTION_TYPE_CHAT, SOLUTION_TYPE_GENERATIVE_CHAT
        solution_type=discoveryengine.SolutionType.SOLUTION_TYPE_SEARCH,
        # For search apps only
        search_engine_config=discoveryengine.Engine.SearchEngineConfig(
            # Options: SEARCH_TIER_STANDARD, SEARCH_TIER_ENTERPRISE
            search_tier=discoveryengine.SearchTier.SEARCH_TIER_ENTERPRISE,
            # Options: SEARCH_ADD_ON_LLM, SEARCH_ADD_ON_UNSPECIFIED
            search_add_ons=[discoveryengine.SearchAddOn.SEARCH_ADD_ON_LLM],
        ),
        # For generic recommendation apps only
        # similar_documents_config=discoveryengine.Engine.SimilarDocumentsEngineConfig,
        data_store_ids=data_store_ids,
    )

    request = discoveryengine.CreateEngineRequest(
        parent=parent,
        engine=engine,
        engine_id=engine_id,
    )

    # Make the request
    operation = client.create_engine(request=request)

    print(f"Waiting for operation to complete: {operation.operation.name}")
    response = operation.result()

    # After the operation is complete,
    # get information from operation metadata
    metadata = discoveryengine.CreateEngineMetadata(operation.metadata)

    # Handle the response
    print(response)
    print(metadata)

    return operation.operation.name

Terraform

Untuk mempelajari cara menerapkan atau menghapus konfigurasi Terraform, lihat Perintah dasar Terraform. Untuk mengetahui informasi selengkapnya, lihat dokumentasi referensi penyedia Terraform.

Untuk membuat aplikasi penelusuran menggunakan Terraform, lihat discovery_engine_search_engine.