Knowledge Agents - List

Referensi

Layanan:: Search Service

Versi API:: 2025-05-01-preview

Mencantumkan semua agen yang tersedia untuk layanan pencarian.

GET {endpoint}/agents?api-version=2025-05-01-preview

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
endpoint	path	True	string	URL titik akhir layanan pencarian.
api-version	query	True	string	Versi Api Klien.

Header Permintaan

Nama	Diperlukan	Jenis	Deskripsi
x-ms-client-request-id		string (uuid)	ID pelacakan yang dikirim dengan permintaan untuk membantu penelusuran kesalahan.

Respons

Nama	Jenis	Deskripsi
200 OK	ListKnowledgeAgentsResult
Other Status Codes	ErrorResponse	Respons kesalahan.

Contoh

SearchServiceListKnowledgeAgents

Permintaan sampel

HTTP

GET https://previewexampleservice.search.windows.net/agents?api-version=2025-05-01-preview

Respon sampel

Kode status:: 200

{
  "value": [
    {
      "@odata.etag": "0x1234568AE7E58A1",
      "name": "agent-preview-test",
      "description": "Description of the agent.",
      "targetIndexes": [
        {
          "indexName": "preview-test",
          "defaultRerankerThreshold": 2.5,
          "defaultIncludeReferenceSourceData": true,
          "defaultMaxDocsForReranker": 100
        }
      ],
      "models": [
        {
          "kind": "azureOpenAI",
          "azureOpenAIParameters": {
            "resourceUri": "https://test-sample.openai.azure.com",
            "deploymentId": "myDeployment",
            "apiKey": "<redacted>",
            "modelName": "gpt-4o-mini"
          }
        }
      ],
      "requestLimits": {
        "maxRuntimeInSeconds": 60,
        "maxOutputSize": 100000
      },
      "encryptionKey": {
        "keyVaultKeyName": "myUserManagedEncryptionKey-createdinAzureKeyVault",
        "keyVaultKeyVersion": "myKeyVersion-32charAlphaNumericString",
        "keyVaultUri": "https://myKeyVault.vault.azure.net",
        "accessCredentials": {
          "applicationId": "00000000-0000-0000-0000-000000000000",
          "applicationSecret": "<applicationSecret>"
        }
      }
    }
  ]
}

Definisi

Nama	Deskripsi
AzureActiveDirectoryApplicationCredentials	Kredensial aplikasi terdaftar yang dibuat untuk layanan pencarian Anda, digunakan untuk akses terautentikasi ke kunci enkripsi yang disimpan di Azure Key Vault.
AzureOpenAIEmbeddingSkill	Memungkinkan Anda membuat penyematan vektor untuk input teks tertentu menggunakan sumber daya Azure OpenAI.
AzureOpenAIModelName	Nama model Azure Open AI yang akan dipanggil.
AzureOpenAIParameters	Menentukan parameter untuk menyambungkan ke sumber daya Azure OpenAI.
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Tanggapan kesalahan
InputFieldMappingEntry	Pemetaan bidang input untuk keterampilan.
KnowledgeAgent
KnowledgeAgentAzureOpenAIModel	Menentukan sumber daya Azure OpenAI yang digunakan untuk melakukan perencanaan kueri.
KnowledgeAgentModelKind	Model AI yang akan digunakan untuk perencanaan kueri.
KnowledgeAgentRequestLimits	Pagar pembatas untuk membatasi berapa banyak sumber daya yang digunakan untuk satu permintaan pengambilan agen.
KnowledgeAgentTargetIndex
ListKnowledgeAgentsResult
OutputFieldMappingEntry	Pemetaan bidang output untuk keterampilan.
SearchIndexerDataNoneIdentity	Menghapus properti identitas sumber data.
SearchIndexerDataUserAssignedIdentity	Menentukan identitas untuk sumber data yang akan digunakan.
SearchResourceEncryptionKey	Kunci enkripsi yang dikelola pelanggan di Azure Key Vault. Kunci yang Anda buat dan kelola dapat digunakan untuk mengenkripsi atau mendekripsi data tidak aktif, seperti indeks dan peta sinonim.

AzureActiveDirectoryApplicationCredentials

Objek

Kredensial aplikasi terdaftar yang dibuat untuk layanan pencarian Anda, digunakan untuk akses terautentikasi ke kunci enkripsi yang disimpan di Azure Key Vault.

Nama	Jenis	Deskripsi
applicationId	string	ID Aplikasi AAD yang diberikan izin akses yang diperlukan ke Azure Key Vault yang akan digunakan saat mengenkripsi data Anda tidak aktif. ID Aplikasi tidak boleh bingung dengan ID Objek untuk Aplikasi AAD Anda.
applicationSecret	string	Kunci autentikasi aplikasi AAD yang ditentukan.

AzureOpenAIEmbeddingSkill

Objek

Memungkinkan Anda membuat penyematan vektor untuk input teks tertentu menggunakan sumber daya Azure OpenAI.

Nama	Jenis	Deskripsi
@odata.type	string: #Microsoft.Skills.Text.AzureOpenAIEmbeddingSkill	Fragmen URI yang menentukan jenis keterampilan.
apiKey	string	Kunci API dari sumber daya Azure OpenAI yang ditunjuk.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identitas terkelola yang ditetapkan pengguna yang digunakan untuk koneksi keluar.
context	string	Mewakili tingkat di mana operasi berlangsung, seperti akar dokumen atau konten dokumen (misalnya, /document atau /document/content). Defaultnya adalah /document.
deploymentId	string	ID penyebaran model Azure OpenAI pada sumber daya yang ditunjuk.
description	string	Deskripsi keterampilan yang menjelaskan input, output, dan penggunaan keterampilan.
dimensions	integer (int32)	Jumlah dimensi yang harus dimiliki oleh embedding output yang dihasilkan. Hanya didukung dalam model penyematan teks-3 dan yang lebih baru.
inputs	InputFieldMappingEntry[]	Input keterampilan bisa menjadi kolom dalam himpunan data sumber, atau output keterampilan hulu.
modelName	AzureOpenAIModelName	Nama model penyematan yang disebarkan di jalur deploymentId yang disediakan.
name	string	Nama keterampilan yang secara unik mengidentifikasinya dalam set keterampilan. Keterampilan tanpa nama yang ditentukan akan diberi nama default indeks berbasis 1 dalam array keterampilan, diawali dengan karakter '#'.
outputs	OutputFieldMappingEntry[]	Output keterampilan adalah bidang dalam indeks pencarian, atau nilai yang dapat dikonsumsi sebagai input oleh keterampilan lain.
resourceUri	string (uri)	URI sumber daya sumber daya Azure OpenAI.

AzureOpenAIModelName

Enumeration

Nama model Azure Open AI yang akan dipanggil.

Nilai	Deskripsi
gpt-4.1
gpt-4.1-mini
gpt-4.1-nano
gpt-4o
gpt-4o-mini
text-embedding-3-large
text-embedding-3-small
text-embedding-ada-002

AzureOpenAIParameters

Objek

Menentukan parameter untuk menyambungkan ke sumber daya Azure OpenAI.

Nama	Jenis	Deskripsi
apiKey	string	Kunci API dari sumber daya Azure OpenAI yang ditunjuk.
authIdentity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identitas terkelola yang ditetapkan pengguna yang digunakan untuk koneksi keluar.
deploymentId	string	ID penyebaran model Azure OpenAI pada sumber daya yang ditunjuk.
modelName	AzureOpenAIModelName	Nama model penyematan yang disebarkan di jalur deploymentId yang disediakan.
resourceUri	string (uri)	URI sumber daya sumber daya Azure OpenAI.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Tanggapan kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

InputFieldMappingEntry

Objek

Pemetaan bidang input untuk keterampilan.

Nama	Jenis	Deskripsi
inputs	InputFieldMappingEntry[]	Input rekursif yang digunakan saat membuat jenis kompleks.
name	string	Nama input.
source	string	Sumber input.
sourceContext	string	Konteks sumber yang digunakan untuk memilih input rekursif.

KnowledgeAgent

Objek

Nama	Jenis	Deskripsi
@odata.etag	string	ETag agen.
description	string	Penjabaran dari agen.
encryptionKey	SearchResourceEncryptionKey	Deskripsi kunci enkripsi yang Anda buat di Azure Key Vault. Kunci ini digunakan untuk memberikan tingkat enkripsi tambahan untuk definisi agen Anda ketika Anda menginginkan jaminan penuh bahwa tidak ada seorang pun, bahkan Microsoft, yang dapat mendekripsinya. Setelah Anda mengenkripsi definisi agen Anda, itu akan selalu terenkripsi. Layanan pencarian akan mengabaikan upaya untuk mengatur properti ini ke null. Anda dapat mengubah properti ini sesuai kebutuhan jika Anda ingin memutar kunci enkripsi Anda; Definisi agen Anda tidak akan terpengaruh. Enkripsi dengan kunci yang dikelola pelanggan tidak tersedia untuk layanan pencarian gratis, dan hanya tersedia untuk layanan berbayar yang dibuat pada atau setelah 1 Januari 2019.
models	KnowledgeAgentModel[]: KnowledgeAgentAzureOpenAIModel[]	Berisi opsi konfigurasi tentang cara terhubung ke model AI.
name	string	Nama agen pengetahuan.
requestLimits	KnowledgeAgentRequestLimits	Pagar pembatas untuk membatasi berapa banyak sumber daya yang digunakan untuk satu permintaan pengambilan agen.
targetIndexes	KnowledgeAgentTargetIndex[]

KnowledgeAgentAzureOpenAIModel

Objek

Menentukan sumber daya Azure OpenAI yang digunakan untuk melakukan perencanaan kueri.

Nama	Jenis	Deskripsi
azureOpenAIParameters	AzureOpenAIParameters: AzureOpenAIEmbeddingSkill	Berisi parameter khusus untuk titik akhir model Azure OpenAI.
kind	string: azureOpenAI	Jenis model AI.

KnowledgeAgentModelKind

Enumeration

Model AI yang akan digunakan untuk perencanaan kueri.

Nilai	Deskripsi
azureOpenAI	Gunakan model Azure Open AI untuk perencanaan kueri.

KnowledgeAgentRequestLimits

Objek

Pagar pembatas untuk membatasi berapa banyak sumber daya yang digunakan untuk satu permintaan pengambilan agen.

Nama	Jenis	Deskripsi
maxOutputSize	integer (int32)	Membatasi ukuran maksimum konten dalam output.
maxRuntimeInSeconds	integer (int32)	Runtime maksimum dalam hitungan detik.

KnowledgeAgentTargetIndex

Objek

Nama	Jenis	Deskripsi
defaultIncludeReferenceSourceData	boolean	Menunjukkan apakah data sumber referensi harus disertakan.
defaultMaxDocsForReranker	integer (int32)	Membatasi jumlah dokumen yang dipertimbangkan untuk peringkat.
defaultRerankerThreshold	number (float) minimum: 0 maximum: 4	Ambang batas untuk menentukan ulang hasil (rentang: 0-4).
indexName	string	Nama indeks target.

ListKnowledgeAgentsResult

Objek

Nama	Jenis	Deskripsi
value	KnowledgeAgent[]

OutputFieldMappingEntry

Objek

Pemetaan bidang output untuk keterampilan.

Nama	Jenis	Deskripsi
name	string	Nama output yang ditentukan oleh keterampilan.
targetName	string	Nama target output. Ini opsional dan default ke nama.

SearchIndexerDataNoneIdentity

Objek

Menghapus properti identitas sumber data.

Nama	Jenis	Deskripsi
@odata.type	string: #Microsoft.Azure.Search.DataNoneIdentity	Fragmen URI yang menentukan jenis identitas.

SearchIndexerDataUserAssignedIdentity

Objek

Menentukan identitas untuk sumber data yang akan digunakan.

Nama	Jenis	Deskripsi
@odata.type	string: #Microsoft.Azure.Search.DataUserAssignedIdentity	Fragmen URI yang menentukan jenis identitas.
userAssignedIdentity	string	Id sumber daya Azure yang sepenuhnya memenuhi syarat dari identitas terkelola yang ditetapkan pengguna biasanya dalam formulir "/subscriptions/12345678-1234-1234-1234567890ab/resourceGroups/rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myId" yang seharusnya ditetapkan ke layanan pencarian.

SearchResourceEncryptionKey

Objek

Kunci enkripsi yang dikelola pelanggan di Azure Key Vault. Kunci yang Anda buat dan kelola dapat digunakan untuk mengenkripsi atau mendekripsi data tidak aktif, seperti indeks dan peta sinonim.

Nama	Jenis	Deskripsi
accessCredentials	AzureActiveDirectoryApplicationCredentials	Kredensial Azure Active Directory opsional yang digunakan untuk mengakses Azure Key Vault Anda. Tidak diperlukan jika menggunakan identitas terkelola sebagai gantinya.
identity	SearchIndexerDataIdentity: SearchIndexerDataNoneIdentity SearchIndexerDataUserAssignedIdentity	Identitas terkelola eksplisit yang digunakan untuk kunci enkripsi ini. Jika tidak ditentukan dan properti kredensial akses null, identitas terkelola yang ditetapkan sistem akan digunakan. Pada pembaruan ke sumber daya, jika identitas eksplisit tidak ditentukan, identitas tersebut tetap tidak berubah. Jika "tidak ada" ditentukan, nilai properti ini akan dihapus.
keyVaultKeyName	string	Nama kunci Azure Key Vault Anda yang akan digunakan untuk mengenkripsi data Anda saat tidak aktif.
keyVaultKeyVersion	string	Versi kunci Azure Key Vault Anda yang akan digunakan untuk mengenkripsi data Anda saat tidak aktif.
keyVaultUri	string	URI Azure Key Vault Anda, juga disebut sebagai nama DNS, yang berisi kunci yang akan digunakan untuk mengenkripsi data Anda saat tidak aktif. Contoh URI mungkin `https://my-keyvault-name.vault.azure.net`.

Bagikan melalui

Knowledge Agents - List

Parameter URI

Header Permintaan

Respons

Contoh

SearchServiceListKnowledgeAgents

Permintaan sampel

Respon sampel

Definisi

AzureActiveDirectoryApplicationCredentials

AzureOpenAIEmbeddingSkill

AzureOpenAIModelName

AzureOpenAIParameters

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InputFieldMappingEntry

KnowledgeAgent

KnowledgeAgentAzureOpenAIModel

KnowledgeAgentModelKind

KnowledgeAgentRequestLimits

KnowledgeAgentTargetIndex

ListKnowledgeAgentsResult

OutputFieldMappingEntry

SearchIndexerDataNoneIdentity

SearchIndexerDataUserAssignedIdentity

SearchResourceEncryptionKey