מדריך זה יעזור לך להגדיר את Azure AI Search באמצעות פורטל Azure. עקוב אחר השלבים שלמטה כדי ליצור ולהגדיר את שירות Azure AI Search שלך.
לפני שתתחיל, וודא שיש לך את הדברים הבאים:
https://<service-name>.search.windows.net.Azure AI Search משתלב עם כלים שונים לשיפור יכולות החיפוש שלך. תוכל להשתמש ב-Azure CLI, Python SDK, .NET SDK וכלים נוספים להגדרות ופעולות מתקדמות.
התחבר ל-Azure CLI באמצעות הפקודה:
az login
(מומלץ) הפעל גישה ללא מפתח עם 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 show אינו מכיל שדה "endpoint"; יש להרכיב את כתובת ה-URL משם השירות.
export AZURE_SEARCH_SERVICE_ENDPOINT="https://<service-name>.search.windows.net"
עם RBAC מופעל, הדוגמאות של Python ו-.NET SDK מטה מתבצעות אימות עם DefaultAzureCredential, המשתמש במפגש az login שלך במהלך הפיתוח המקומי — אין צורך במפתח מנהל. ראה Connect to Azure AI Search using roles.
```bash
# zsh/bash
# ל-az search service show אין שדה "endpoint"; הרכב את כתובת ה-URL משם השירות.
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
# ל-az search service show אין שדה "endpoint"; הרכב את כתובת ה-URL משם השירות.
$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)
```
התקן את ספריית הלקוח של Azure Cognitive Search ואת Azure Identity עבור Python:
pip install azure-search-documents azure-identity
השתמש בקוד Python הבא כדי ליצור אינדקס ולהעלות מסמכים:
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"
# ללא מפתח (מומלץ): משתמש בזהות שלך `az login` דרך RBAC של Entra ID.
# דורש את התפקידים "תורם שירות חיפוש" ו"תורם נתוני אינדקס חיפוש".
credential = DefaultAzureCredential()
# גישה חלופית (אימות מבוסס מפתח):
# מייבא את AzureKeyCredential מ-azure.core.credentials
# 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)
הפעל את הפקודה הבאה כדי ליצור אינדקס ולהעלות מסמכים:
dotnet run ./AzureSearch.cs
דוגמת ה-.NET למטה משתמשת ב-DefaultAzureCredential, שיכולה להשתמש בכניסת Azure CLI שלך מ-az login במהלך הפיתוח המקומי.
הנה קוד ה-.NET של 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}'.");
למידע מפורט יותר, עיין בתיעוד הבא:
הצלחת להגדיר את Azure AI Search באמצעות פורטל Azure והכלים המשולבים. כעת תוכל לחקור תכונות ויכולות מתקדמות יותר של Azure AI Search לשיפור פתרונות החיפוש שלך.
לעזרה נוספת, בקר ב-תיעוד Azure Cognitive Search.
כתב ויתור: מסמך זה תורגם באמצעות שירות תרגום אוטומטי Co-op Translator. למרות שאנו שואפים לדיוק, יש לקחת בחשבון שתרגומים אוטומטיים עלולים להכיל שגיאות או אי-דיוקים. יש להחשיב את המסמך המקורי בשפתו הטבעית כמקור הסמכות. למידע קריטי מומלץ להשתמש בתרגום מקצועי על ידי מתרגם אדם. אנו לא אחראים לכל אי-הבנה או פירוש שגוי הנובע מהשימוש בתרגום זה.