Update translation replace missing files

Author: leestott

translations/fa/00-course-setup/AzureSearch.md

@@ -2,10 +2,129 @@
 CO_OP_TRANSLATOR_METADATA:
 {
   "original_hash": "932a1f463f0fcf97090b93b5d0255dff",
-  "translation_date": "2025-03-26T18:45:44+00:00",
+  "translation_date": "2025-03-28T09:11:01+00:00",
   "source_file": "00-course-setup\\AzureSearch.md",
   "language_code": "fa"
 }
 -->
+# راهنمای تنظیم Azure AI Search
 
+این راهنما به شما کمک می‌کند Azure AI Search را با استفاده از پورتال Azure تنظیم کنید. مراحل زیر را دنبال کنید تا سرویس جستجوی Azure AI Search خود را ایجاد و پیکربندی کنید.
 
+## پیش‌نیازها
+
+قبل از شروع، مطمئن شوید که موارد زیر را دارید:
+
+- اشتراک Azure. اگر اشتراک Azure ندارید، می‌توانید یک حساب رایگان در [Azure Free Account](https://azure.microsoft.com/free/?wt.mc_id=studentamb_258691) ایجاد کنید.
+
+## مرحله ۱: ایجاد سرویس Azure AI Search
+
+1. وارد [پورتال Azure](https://portal.azure.com/?wt.mc_id=studentamb_258691) شوید.
+2. در پنل ناوبری سمت چپ، روی **Create a resource** کلیک کنید.
+3. در جعبه جستجو عبارت "Azure Cognitive Search" را وارد کرده و **Azure Cognitive Search** را از لیست نتایج انتخاب کنید.
+4. روی دکمه **Create** کلیک کنید.
+5. در تب **Basics** اطلاعات زیر را وارد کنید:
+   - **Subscription**: اشتراک Azure خود را انتخاب کنید.
+   - **Resource group**: یک گروه منبع جدید ایجاد کنید یا یک گروه موجود را انتخاب کنید.
+   - **Resource name**: یک نام منحصر‌به‌فرد برای سرویس جستجوی خود وارد کنید.
+   - **Region**: منطقه‌ای را انتخاب کنید که به کاربران شما نزدیک‌تر باشد.
+   - **Pricing tier**: یک سطح قیمت‌گذاری مناسب نیازهای خود انتخاب کنید. می‌توانید با سطح رایگان برای آزمایش شروع کنید.
+6. روی **Review + create** کلیک کنید.
+7. تنظیمات را بررسی کرده و روی **Create** کلیک کنید تا سرویس جستجو ایجاد شود.
+
+## مرحله ۲: شروع به کار با Azure AI Search
+
+1. پس از اتمام استقرار، به سرویس جستجوی خود در پورتال Azure بروید.
+2. در صفحه نمای کلی سرویس جستجو، روی دکمه **Quickstart** کلیک کنید.
+3. مراحل راهنمای Quickstart را دنبال کنید تا یک ایندکس ایجاد کنید، داده‌ها را بارگذاری کنید و یک جستجوی پرس‌وجو انجام دهید.
+
+### ایجاد ایندکس
+
+1. در راهنمای Quickstart، روی **Create an index** کلیک کنید.
+2. طرح ایندکس را با مشخص کردن فیلدها و ویژگی‌های آنها (مانند نوع داده، قابلیت جستجو، قابلیت فیلتر) تعریف کنید.
+3. روی **Create** کلیک کنید تا ایندکس ایجاد شود.
+
+### بارگذاری داده‌ها
+
+1. در راهنمای Quickstart، روی **Upload data** کلیک کنید.
+2. یک منبع داده انتخاب کنید (مانند Azure Blob Storage، Azure SQL Database) و جزئیات اتصال لازم را ارائه دهید.
+3. فیلدهای منبع داده را به فیلدهای ایندکس تطبیق دهید.
+4. روی **Submit** کلیک کنید تا داده‌ها به ایندکس بارگذاری شوند.
+
+### انجام یک پرس‌وجوی جستجو
+
+1. در راهنمای Quickstart، روی **Search explorer** کلیک کنید.
+2. یک پرس‌وجوی جستجو را در جعبه جستجو وارد کنید تا عملکرد جستجو را آزمایش کنید.
+3. نتایج جستجو را بررسی کنید و در صورت نیاز طرح ایندکس یا داده‌ها را تنظیم کنید.
+
+## مرحله ۳: استفاده از ابزارهای Azure AI Search
+
+Azure AI Search با ابزارهای مختلفی ادغام می‌شود تا قابلیت‌های جستجوی شما را بهبود بخشد. شما می‌توانید از Azure CLI، Python SDK و ابزارهای دیگر برای تنظیمات پیشرفته و عملیات استفاده کنید.
+
+### استفاده از Azure CLI
+
+1. Azure CLI را با دنبال کردن دستورالعمل‌های [Install Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?wt.mc_id=studentamb_258691) نصب کنید.
+2. با استفاده از دستور زیر وارد Azure CLI شوید:
+   ```bash
+   az login
+   ```
+3. یک سرویس جستجوی جدید با استفاده از Azure CLI ایجاد کنید:
+   ```bash
+   az search service create --resource-group <resource-group> --name <service-name> --sku Free
+   ```
+4. یک ایندکس با استفاده از Azure CLI ایجاد کنید:
+   ```bash
+   az search index create --service-name <service-name> --name <index-name> --fields "field1:type, field2:type"
+   ```
+
+### استفاده از Python SDK
+
+1. کتابخانه کلاینت Azure Cognitive Search برای Python را نصب کنید:
+   ```bash
+   pip install azure-search-documents
+   ```
+2. از کد Python زیر برای ایجاد ایندکس و بارگذاری اسناد استفاده کنید:
+   ```python
+   from azure.core.credentials import AzureKeyCredential
+   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 = "https://<service-name>.search.windows.net"
+   api_key = "<api-key>"
+
+   index_client = SearchIndexClient(service_endpoint, AzureKeyCredential(api_key))
+
+   fields = [
+       SimpleField(name="id", type=edm.String, key=True),
+       SimpleField(name="content", type=edm.String, searchable=True),
+   ]
+
+   index = SearchIndex(name="sample-index", fields=fields)
+
+   index_client.create_index(index)
+
+   search_client = SearchClient(service_endpoint, "sample-index", AzureKeyCredential(api_key))
+
+   documents = [
+       {"id": "1", "content": "Hello world"},
+       {"id": "2", "content": "Azure Cognitive Search"}
+   ]
+
+   search_client.upload_documents(documents)
+   ```
+
+برای اطلاعات بیشتر، به مستندات زیر مراجعه کنید:
+
+- [Create an Azure Cognitive Search service](https://learn.microsoft.com/en-us/azure/search/search-create-service-portal?wt.mc_id=studentamb_258691)
+- [Get started with Azure Cognitive Search](https://learn.microsoft.com/en-us/azure/search/search-get-started-portal?wt.mc_id=studentamb_258691)
+- [Azure AI Search Tools](https://learn.microsoft.com/en-us/azure/ai-services/agents/how-to/tools/azure-ai-search?tabs=azurecli%2Cpython&pivots=code-examples?wt.mc_id=studentamb_258691)
+
+## نتیجه‌گیری
+
+شما با موفقیت Azure AI Search را با استفاده از پورتال Azure و ابزارهای یکپارچه تنظیم کرده‌اید. اکنون می‌توانید ویژگی‌ها و قابلیت‌های پیشرفته‌تر Azure AI Search را بررسی کنید تا راه‌حل‌های جستجوی خود را بهبود بخشید.
+
+برای کمک بیشتر، به [مستندات Azure Cognitive Search](https://learn.microsoft.com/en-us/azure/search/?wt.mc_id=studentamb_258691) مراجعه کنید.
+
+**سلب مسئولیت**:  
+این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است حاوی اشتباهات یا نادقتی‌ها باشند. سند اصلی به زبان اصلی آن باید به‌عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حیاتی، ترجمه حرفه‌ای انسانی توصیه می‌شود. ما هیچ مسئولیتی در قبال سوءتفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نمی‌پذیریم.

translations/fa/00-course-setup/README.md

@@ -2,10 +2,122 @@
 CO_OP_TRANSLATOR_METADATA:
 {
   "original_hash": "366bc6709dd95b8a32ec7c705b0f179c",
-  "translation_date": "2025-03-26T18:49:39+00:00",
+  "translation_date": "2025-03-28T09:12:44+00:00",
   "source_file": "00-course-setup\\README.md",
   "language_code": "fa"
 }
 -->
+# راه‌اندازی دوره
 
+## مقدمه
 
+این درس نحوه اجرای نمونه کدهای این دوره را پوشش خواهد داد.
+
+## الزامات
+
+- حساب کاربری GitHub
+- پایتون نسخه 3.12 یا بالاتر
+- اشتراک Azure
+- حساب کاربری Azure AI Foundry
+
+## کلون یا فورک کردن این مخزن
+
+برای شروع، لطفاً مخزن GitHub را کلون یا فورک کنید. این کار نسخه‌ای از محتوای دوره را برای شما ایجاد می‌کند تا بتوانید کدها را اجرا، آزمایش و تغییر دهید!
+
+این کار را می‌توانید با کلیک بر روی لینک زیر انجام دهید:
+
+![مخزن فورک‌شده](../../../translated_images/forked-repo.eea246a73044cc984a1e462349e36e7336204f00785e3187b7399905feeada07.fa.png)
+
+## دریافت توکن دسترسی شخصی GitHub (PAT)
+
+در حال حاضر، این دوره از بازار مدل‌های GitHub استفاده می‌کند تا دسترسی رایگان به مدل‌های زبان بزرگ (LLMs) که برای ایجاد عوامل هوش مصنوعی استفاده می‌شوند، فراهم کند.
+
+برای دسترسی به این سرویس، باید یک توکن دسترسی شخصی GitHub ایجاد کنید.
+
+این کار را می‌توانید با رفتن به حساب کاربری GitHub خود انجام دهید.
+
+گزینه `Fine-grained tokens` را در سمت چپ صفحه انتخاب کنید.
+
+سپس `Generate new token` را انتخاب کنید.
+
+![ایجاد توکن](../../../translated_images/generate-token.361ec40abe59b84ac68d63c23e2b6854d6fad82bd4e41feb98fc0e6f030e8ef7.fa.png)
+
+توکن جدیدی که ایجاد کرده‌اید را کپی کنید. حالا باید این توکن را به فایل `.env` که در این دوره وجود دارد اضافه کنید.
+
+## افزودن به متغیرهای محیطی
+
+برای ایجاد فایل `.env` دستور زیر را در ترمینال اجرا کنید:
+
+```bash
+cp .env.example .env
+```
+
+این دستور فایل نمونه را کپی کرده و یک فایل `.env` در دایرکتوری شما ایجاد می‌کند. مقادیر متغیرهای محیطی را پر کنید. می‌توانید مقادیر هر متغیر محیطی را در مکان‌های زیر در پورتال [Azure AI Foundry](https://ai.azure.com?WT.mc_id=academic-105485-koreyst) پیدا کنید:
+
+فایل را باز کرده و توکنی که ایجاد کرده‌اید را در `GITHUB_TOKEN=` field of the .env file. 
+- `AZURE_SUBSCRIPTION_ID` - On the **Overview** page of your project within **Project details**.
+- `AZURE_AI_PROJECT_NAME` - At the top of the **Overview** page for your project.
+- `AZURE_OPENAI_RESOURCE_GROUP` - On the **Overview** page of the **Management Center** within **Project properties**.
+- `AZURE_OPENAI_SERVICE` - On the **Overview** page of your project in the **Included capabilities** tab for **Azure OpenAI Service**.
+- `AZURE_OPENAI_API_VERSION` - On the [API version lifecycle](https://learn.microsoft.com/azure/ai-services/openai/api-version-deprecation#latest-ga-api-release?WT.mc_id=academic-105485-koreyst) webpage within the **Latest GA API release** section.
+- `AZURE_OPENAI_ENDPOINT` قرار دهید - در تب **Details** در بخش **Endpoint** مدل شما (مثلاً **Target URI**)
+
+## نصب بسته‌های مورد نیاز
+
+برای اطمینان از اینکه تمام بسته‌های مورد نیاز پایتون را برای اجرای کد دارید، دستور زیر را در ترمینال اجرا کنید.
+
+توصیه می‌کنیم یک محیط مجازی پایتون ایجاد کنید تا از هرگونه تعارض و مشکل جلوگیری شود.
+
+```bash
+pip install -r requirements.txt
+```
+
+این دستور باید بسته‌های پایتون مورد نیاز را نصب کند.
+
+# ورود به Azure
+
+به عنوان یک بهترین روش امنیتی، از [احراز هویت بدون کلید](https://learn.microsoft.com/azure/developer/ai/keyless-connections?tabs=csharp%2Cazure-cli?WT.mc_id=academic-105485-koreyst) برای احراز هویت در Azure OpenAI با Microsoft Entra ID استفاده خواهیم کرد. قبل از انجام این کار، ابتدا باید **Azure CLI** را طبق [دستورالعمل نصب](https://learn.microsoft.com/cli/azure/install-azure-cli?WT.mc_id=academic-105485-koreyst) برای سیستم‌عامل خود نصب کنید.
+
+سپس، یک ترمینال باز کرده و دستور `az login` to sign in to your Azure account.
+
+## Sign in to Azure
+
+Login with your Azure AI account used to provision the Azure resources.
+
+Open a new terminal and enter the following command and follow the instructions in the terminal:
+
+`az login --use-device-code`
+
+Once you've logged in, select your subscription in the terminal.
+
+## Access the environment variables.
+
+We'll import `os` and `load_dotenv` را اجرا کنید تا بتوانید به متغیرهای محیطی دسترسی پیدا کنید.
+
+```python
+import os
+from dotenv import load_dotenv
+
+load_dotenv()
+```
+
+## راه‌اندازی احراز هویت بدون کلید
+
+به جای سخت‌کد کردن اطلاعات ورود، از یک اتصال بدون کلید با Azure OpenAI استفاده خواهیم کرد. برای انجام این کار، تابع `DefaultAzureCredential` and later call the `DefaultAzureCredential` را برای دریافت اطلاعات احراز هویت وارد می‌کنیم.
+
+```python
+from azure.identity import DefaultAzureCredential, InteractiveBrowserCredential
+```
+
+اکنون آماده اجرای کدهای این دوره هستید. از یادگیری بیشتر درباره دنیای عوامل هوش مصنوعی لذت ببرید!
+
+اگر در اجرای این تنظیمات مشکلی داشتید، وارد بخش 
+
+یا 
+
+## درس بعدی
+
+[مقدمه‌ای بر عوامل هوش مصنوعی و موارد استفاده از عوامل](../01-intro-to-ai-agents/README.md)
+
+**سلب مسئولیت**:  
+این سند با استفاده از سرویس ترجمه هوش مصنوعی [Co-op Translator](https://github.com/Azure/co-op-translator) ترجمه شده است. در حالی که ما تلاش می‌کنیم دقت ترجمه را حفظ کنیم، لطفاً توجه داشته باشید که ترجمه‌های خودکار ممکن است شامل اشتباهات یا نواقص باشند. سند اصلی به زبان اصلی باید به عنوان منبع معتبر در نظر گرفته شود. برای اطلاعات حساس، توصیه می‌شود از ترجمه حرفه‌ای انسانی استفاده کنید. ما هیچ مسئولیتی در قبال سوء تفاهم‌ها یا تفسیرهای نادرست ناشی از استفاده از این ترجمه نداریم.