ai-agents-for-beginners

Gabay sa Pag-setup ng Azure AI Search

Tutulungan ka ng gabay na ito na i-setup ang Azure AI Search gamit ang Azure portal. Sundin ang mga hakbang sa ibaba upang lumikha at i-configure ang iyong Azure AI Search service.

Mga Kinakailangan

Bago ka magsimula, siguraduhing mayroon kang mga sumusunod:

Isang Azure subscription. Kung wala ka pang Azure subscription, maaari kang gumawa ng libreng account sa Azure Free Account.

Hakbang 1: Lumikha ng Azure Storage Account

Sundin ang tagubiling ito, Create an Azure storage account, upang lumikha ng bagong Azure Storage Account. TANDAAN: Siguraduhing ang uri ng Storage Account ay Standard General Purpose V2.

Hakbang 2: Lumikha ng Azure AI Search Service

Mag-sign in sa Azure portal.
Sa kaliwang navigation pane, i-click ang Create a resource.
Sa search box, i-type ang “Azure AI Search” at piliin ang Azure AI Search mula sa listahan ng mga resulta.
I-click ang button na Create.
Sa tab na Basics, ibigay ang mga sumusunod na impormasyon:
- Subscription: Piliin ang iyong Azure subscription.
- Resource group: Gumawa ng bagong resource group o piliin ang isang umiiral na grupo.
- Resource name: Maglagay ng natatanging pangalan para sa iyong search service.
- Region: Piliin ang rehiyon na pinakamalapit sa iyong mga gumagamit.
- Pricing tier: Pumili ng pricing tier na angkop sa iyong mga pangangailangan. Maaari kang magsimula sa Free tier para sa testing.
I-click ang Review + create.
Suriin ang mga setting at i-click ang Create upang likhain ang search service.

Hakbang 3: Magsimula sa Azure AI Search

Kapag kumpleto na ang deployment, pumunta sa iyong search service sa Azure portal.
Sa overview pane ng search service, kopyahin ang URL. Dapat itong magmukhang https://<service-name>.search.windows.net.
(Inirerekomenda) I-enable ang keyless access gamit ang Microsoft Entra ID (RBAC) tulad ng ipinapakita sa Hakbang 4 sa ibaba — hindi na kailangan ng susi. Ang mga sample sa gabay na ito ay lumilikha/nag-uupdate ng mga index at nag-a-upload ng mga dokumento, na nangangailangan ng mga role na Search Service Contributor at Search Index Data Contributor (o, para sa key-based auth, ang primary admin key — hindi ang query key). Kung hindi mo magagamit ang RBAC, buksan ang Settings > Keys pane at kopyahin ang primary admin key.
Sundin ang mga hakbang sa Quickstart guide upang gumawa ng index, mag-upload ng data, at magsagawa ng paghahanap.

Hakbang 4: Gamitin ang Azure AI Search Tools

Ang Azure AI Search ay nag-iintegrate sa iba’t ibang mga tool para pagandahin ang iyong mga kakayahan sa paghahanap. Maaari mong gamitin ang Azure CLI, Python SDK, .NET SDK at iba pang mga tool para sa advanced na mga configuration at operasyon.

Paggamit ng Azure CLI

I-install ang Azure CLI sa pamamagitan ng pagsunod sa mga tagubilin sa Install Azure CLI.
Mag-sign in sa Azure CLI gamit ang command:
```
az login
```

(Inirerekomenda) I-enable ang keyless access gamit ang Microsoft Entra ID (RBAC):

 az search service update --name <service-name> --resource-group <resource-group> --auth-options aadOrApiKey
 az role assignment create --assignee <your-user-or-principal-id> --role "Search Service Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
 az role assignment create --assignee <your-user-or-principal-id> --role "Search Index Data Contributor" --scope $(az search service show -g <resource-group> -n <service-name> --query id -o tsv)
 # ang az search service show ay walang "endpoint" na patlang; buuin ang URL mula sa pangalan ng serbisyo.
 export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"

Sa pag-enable ng RBAC, ang mga sample ng Python at .NET SDK sa ibaba ay nag-a-authenticate gamit ang DefaultAzureCredential, na gumagamit ng iyong az login session habang lokal na binubuo — hindi na kailangan ang admin key. Tingnan ang Connect to Azure AI Search using roles.

(Fallback) Key-based auth — gamitin lang ito kung hindi mo magagamit ang RBAC, i-store ang admin key din:

I-store ang parehong endpoint at API key para sa Azure AI Search instance sa mga environment variable.

```bash
# zsh/bash
# ang az search service show ay walang "endpoint" field; buuin ang URL mula sa pangalan ng service.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
export AZURE_SEARCH_API_KEY=$(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)
```

```powershell
# PowerShell
# ang az search service show ay walang "endpoint" field; buuin ang URL mula sa pangalan ng service.
$env:AZURE_SEARCH_SERVICE_ENDPOINT = "https://<service-name>.search.windows.net"
$env:AZURE_SEARCH_API_KEY = $(az search admin-key show -g <resource-group> --service-name <service-name> --query "primaryKey" -o tsv)
```

Paggamit ng Python SDK

I-install ang Azure Cognitive Search client library at Azure Identity para sa Python:
```
pip install azure-search-documents azure-identity
```

Gamitin ang sumusunod na Python code upang gumawa ng index at mag-upload ng mga dokumento:

 import os
 from azure.identity import DefaultAzureCredential
 from azure.search.documents import SearchClient
 from azure.search.documents.indexes import SearchIndexClient
 from azure.search.documents.indexes.models import SearchIndex, SimpleField, edm

 service_endpoint = os.getenv("AZURE_SEARCH_SERVICE_ENDPOINT")
 index_name = "sample-index"

 # Keyless (inirerekomenda): gumagamit ng iyong pagkakakilanlan sa `az login` sa pamamagitan ng Entra ID RBAC.
 # Nangangailangan ng mga role na "Search Service Contributor" at "Search Index Data Contributor".
 credential = DefaultAzureCredential()
 # Fallback (key-based auth):
 # mula sa azure.core.credentials import AzureKeyCredential
 # kredensyal = AzureKeyCredential(os.getenv("AZURE_SEARCH_API_KEY"))
 index_client = SearchIndexClient(service_endpoint, credential)

 fields = [
     SimpleField(name="id", type=edm.String, key=True),
     SimpleField(name="content", type=edm.String, searchable=True),
 ]

 index = SearchIndex(name=index_name, fields=fields)

 index_client.create_index(index)

 search_client = SearchClient(service_endpoint, index_name, credential)

 documents = [
     {"id": "1", "content": "Hello world"},
     {"id": "2", "content": "Azure Cognitive Search"}
 ]

 search_client.upload_documents(documents)

Paggamit ng .NET SDK

Patakbuhin ang sumusunod na command upang gumawa ng index at mag-upload ng mga dokumento:
```
 dotnet run ./AzureSearch.cs
```
Ang .NET sample sa ibaba ay gumagamit ng DefaultAzureCredential, na maaaring gumamit ng iyong Azure CLI sign-in mula sa az login habang lokal na binubuo.

Narito ang .NET code ng AzureSearch.cs:

 #:package Azure.Search.Documents@11.*
 #:package Azure.Identity@1.21.0
 #:property PublishAot=false

 using Azure;
 using Azure.Identity;
 using Azure.Search.Documents;
 using Azure.Search.Documents.Indexes;
 using Azure.Search.Documents.Indexes.Models;

 var serviceEndpoint = new Uri(Environment.GetEnvironmentVariable("AZURE_SEARCH_SERVICE_ENDPOINT")!);
 var indexName = "sample-index";

 // Keyless (recommended): uses your `az login` identity via Entra ID RBAC.
 // Requires the "Search Service Contributor" and "Search Index Data Contributor" roles.
 var credential = new DefaultAzureCredential();
 // Fallback (key-based auth): the `using Azure;` directive above already imports
 // AzureKeyCredential; replace the credential line above with:
 // var credential = new AzureKeyCredential(Environment.GetEnvironmentVariable("AZURE_SEARCH_API_KEY")!);
 var indexClient = new SearchIndexClient(serviceEndpoint, credential);

 var fields = new List<SearchField>()
 {
     new SimpleField("id", SearchFieldDataType.String) { IsKey = true },
     new SearchableField("content")
 };

 var index = new SearchIndex(name: indexName, fields: fields);

 var response = await indexClient.CreateOrUpdateIndexAsync(index);
 Console.WriteLine($"Index '{response.Value.Name}' ready.");

 var searchClient = new SearchClient(serviceEndpoint, indexName, credential);

 var documents = new[]
 {
     new { id = "1", content = "Hello world" },
     new { id = "2", content = "Azure Cognitive Search" }
 };

 var result = await searchClient.UploadDocumentsAsync(documents);
 Console.WriteLine($"Uploaded {result.Value.Results.Count} documents to index '{response.Value.Name}'.");

Para sa mas detalyadong impormasyon, sumangguni sa mga sumusunod na dokumentasyon:

Konklusyon

Matagumpay mong na-setup ang Azure AI Search gamit ang Azure portal at mga integrated na tools. Maaari mo nang tuklasin ang mas advanced na mga tampok at kakayahan ng Azure AI Search upang pagandahin ang iyong mga solusyon sa paghahanap.

Para sa karagdagang tulong, bisitahin ang Azure Cognitive Search documentation.

Pagtatanggi: Ang dokumentong ito ay isinalin gamit ang serbisyo ng AI translation na Co-op Translator. Bagama’t nagsusumikap kami para sa katumpakan, pakatandaan na ang awtomatikong pagsasalin ay maaaring maglaman ng mga pagkakamali o hindi pagkakatugma. Ang orihinal na dokumento sa orihinal nitong wika ang dapat ituring na pangunahing sanggunian. Para sa mahahalagang impormasyon, inirerekomenda ang propesyonal na pagsasalin ng tao. Hindi kami mananagot sa anumang maling pagkakaintindi o maling interpretasyon na nagmula sa paggamit ng pagsasaling ito.

This site is open source. Improve this page.