ai-agents-for-beginners

Mwongozo wa Kuanzisha Azure AI Search

Mwongozo huu utakusaidia kuanzisha Azure AI Search ukitumia Azure portal. Fuata hatua zilizo hapa chini kuunda na kusanidi huduma yako ya Azure AI Search.

Mahitaji ya Awali

Kabla hujaanza, hakikisha una yafuatayo:

Hatua ya 1: Unda Akaunti ya Hifadhi ya Azure

  1. Fuata maelekezo haya, Create an Azure storage account, kuunda Akaunti mpya ya Hifadhi ya Azure. NOTE: Hakikisha aina ya Akaunti ya Hifadhi ni Standard General Purpose V2.
  1. Ingia kwenye Azure portal.
  2. Katika sehemu ya urambazaji upande wa kushoto, bofya Create a resource.
  3. Katika kisanduku cha utafutaji, andika “Azure AI Search” na chagua Azure AI Search kutoka kwenye orodha ya matokeo.
  4. Bofya kitufe cha Create.
  5. Katika kichupo cha Basics, toa taarifa zifuatazo:
    • Subscription: Chagua usajili wako wa Azure.
    • Resource group: Unda kundi la rasilimali jipya au chagua lililopo.
    • Resource name: Ingiza jina la kipekee kwa huduma yako ya utafutaji.
    • Region: Chagua eneo lililo karibu zaidi na watumiaji wako.
    • Pricing tier: Chagua kiwango cha bei kinachokufaa mahitaji yako. Unaweza kuanza na kiwango cha Bure kwa majaribio.
  6. Bofya Review + create.
  7. Pitia mipangilio na bofya Create kuunda huduma ya utafutaji.
  1. Mara mchakato wa utekelezaji ukimalizika, nenda kwenye huduma yako ya utafutaji katika Azure portal.
  2. Katika sehemu ya muhtasari wa huduma ya utafutaji, nakili URL. Inapaswa kuonekana kama https://<service-name>.search.windows.net.
  3. (Inapendekezwa) Wezesha ufikiaji bila kitufe ukitumia Microsoft Entra ID (RBAC) kama ilivyoonyeshwa katika Hatua ya 4 hapa chini — hakuna kitufe kinachohitajika. Sampuli katika mwongozo huu huunda/hujenga upya viashiria na kupakia hati, ambavyo vinahitaji majukumu ya Search Service Contributor na Search Index Data Contributor (au, kwa uthibitishaji wa kitufe, kitufe kikuu cha msimamizi — si kitufe cha kuuliza). Ikiwa hutaweza kutumia RBAC, fungua pane ya Settings > Keys na nakili kitufe kikuu cha msimamizi.
  4. Fuata hatua katika ukurasa wa Quickstart guide kuunda kiashiria, kupakia data, na kufanya utafutaji.

Azure AI Search inaunganisha na zana mbalimbali ili kuongeza uwezo wa utafutaji wako. Unaweza kutumia Azure CLI, Python SDK, .NET SDK na zana nyingine kwa usanidi na shughuli za hali ya juu.

Kutumia Azure CLI

  1. Sakinisha Azure CLI kwa kufuata maelekezo katika Install Azure CLI.

  2. Ingia kwenye Azure CLI kwa kutumia amri:

    az login

  3. (Inapendekezwa) Wezesha ufikiaji bila kitufe ukitumia 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)
 # az search service show has no "endpoint" field; build the URL from the service name.
 export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"

    Kwa RBAC kuwezeshwa, sampuli za Python na .NET SDK hapa chini huingia kwa DefaultAzureCredential, ambayo hutumia kikao chako cha az login wakati wa maendeleo ya ndani — hakuna kitufe cha msimamizi kinachohitajika. Angalia Connect to Azure AI Search using roles.

  4. (Kama mbadala) Uthibitishaji unaotegemea kitufe — ni kwamba tu kama huwezi kutumia RBAC, hifadhi pia kitufe cha msimamizi:

Hifadhi mwisho wa huduma na kitufe cha API kwa kifurushi cha Azure AI Search kwenye mabadiliko ya mazingira.

Kutumia Python SDK

  1. Sakinisha maktaba ya mteja wa Azure Cognitive Search na Azure Identity kwa Python:

    pip install azure-search-documents azure-identity

  2. Tumia msimbo wa Python ufuatao kuunda kiashiria na kupakia hati:

     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 (recommended): uses your `az login` identity via Entra ID RBAC.
 # Requires the "Search Service Contributor" and "Search Index Data Contributor" roles.
 credential = DefaultAzureCredential()
 # Fallback (key-based auth):
 # from azure.core.credentials import AzureKeyCredential
 # credential = 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)

Kutumia .NET SDK

  1. Endesha amri ifuatayo kuunda kiashiria na kupakia hati:

     dotnet run ./AzureSearch.cs

    Sampuli ya .NET hapa chini hutumia DefaultAzureCredential, ambayo inaweza kutumia kuingia kwa Azure CLI yako kutoka az login wakati wa maendeleo ya ndani.

  2. Huu ni msimbo wa .NET wa 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}'.");

Kwa maelezo ya kina, rejea nyaraka zifuatazo:

Hitimisho

Umefanikiwa kuanzisha Azure AI Search ukitumia Azure portal na zana zilizojumuishwa. Sasa unaweza kuchunguza vipengele na uwezo wa hali ya juu wa Azure AI Search ili kuimarisha suluhisho zako za utafutaji.

Kwa msaada zaidi, tembelea Azure Cognitive Search documentation.

Kionyozo: Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI Co-op Translator. Ingawa tunajitahidi kupata usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake halisi inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu inayofanywa na binadamu inapendekezwa. Hatutojibu kwa kuelewa vibaya au tafsiri potofu zinazotokea kutokana na matumizi ya tafsiri hii.

This site is open source. Improve this page.