generative-ai-for-beginners / pa

# ਏਜੰਟਸ.md

## ਪ੍ਰੋਜੈਕਟ ਝਲਕ

ਇਹ ਭੰਡਾਰ ਇੱਕ ਵਿਸ਼ਤ੍ਰਿਤ 21-ਬੋੜ੍ਹਾ ਕੋਰਸ ਸ਼ਾਮਲ ਕਰਦਾ ਹੈ ਜੋ ਜਨੇਰੇਟਿਵ ਏਆਈ ਦੀਆਂ ਬੁਨਿਆਦੀ ਸਿੱਧਾਂਤਾਂ ਅਤੇ ਐਪਲੀਕੇਸ਼ਨ ਵਿਕਾਸ ਸਿਖਾਉਂਦਾ ਹੈ। ਇਹ ਕੋਰਸ ਸ਼ੁਰੂਆਤੀ ਲਈ ਤਿਆਰ ਕੀਤਾ ਗਿਆ ਹੈ ਅਤੇ ਬੁਨਿਆਦੀ ਧਾਰਨਾਵਾਂ ਤੋਂ ਲੈ ਕੇ ਉਤਪਾਦਨ-ਤਿਆਰ ਐਪਲੀਕੇਸ਼ਨਾਂ ਦੇ ਨਿਰਮਾਣ ਤਕ ਸਭ ਕੁਝ ਢਕਦਾ ਹੈ।

**ਮੁੱਖ ਤਕਨੀਕਾਂ:**
- ਪਾਇਥਨ 3.9+ ਲਾਇਬ੍ਰੇਰੀਜ਼ ਨਾਲ: `openai`, `python-dotenv`, `tiktoken`, `azure-ai-inference`, `pandas`, `numpy`, `matplotlib`
- ਟਾਈਪਸਕ੍ਰਿਪਟ/ਜਾਵਾਸਕ੍ਰਿਪਟ ਨਾਲ Node.js ਅਤੇ ਲਾਇਬ੍ਰੇਰੀਜ਼: `openai` (v1 ਏਂਡਪੋਇੰਟ + Responses API ਰਾਹੀਂ ਏਜ਼ਯੂਰ OpenAI), `@azure-rest/ai-inference` (Microsoft Foundry ਮਾਡਲ)
- ਏਜ਼ਯੂਰ OpenAI ਸੇਵਾ, OpenAI API, ਅਤੇ Microsoft Foundry ਮਾਡਲ (GitHub ਮਾਡਲ ਜੁਲਾਈ 2026 ਦੇ ਅੰਤ ਵਿਚ ਰਿਟਾਇਰ ਹੋ ਰਹੇ ਹਨ)
- ਇੰਟਰਐਕਟਿਵ ਸਿੱਖਣ ਲਈ ਜੂਪਿਟਰ ਨੋਟਬੁੱਕਸ
- ਸਥਿਰ ਵਿਕਾਸ ਲਈ ਡੈਵ ਕੰਟੇਨਰ

**ਭੰਡਾਰ ਸਾਂਚਾ:**
- 21 ਗਿਣਤੀਵਾਲੇ ਪਾਠ ਡਾਇਰੈਕਟਰੀ (00-21) ਜਿਸ ਵਿੱਚ README, ਕੋਡ ਉਦਾਹਰਣਾਂ ਅਤੇ ਕਾਰਜਸ਼ੀਲਤਾਵਾਂ ਹਨ
- ਕਈ ਕਾਰਜਾਨੁਵੇਸ਼: ਪਾਇਥਨ, ਟਾਈਪਸਕ੍ਰਿਪਟ, ਅਤੇ ਕਈ ਵਾਰ .NET ਉਦਾਹਰਣਾਂ
- 40+ ਭਾਸ਼ਾਵਾਂ ਵਿੱਚ ਅਨੁਵਾਦ ਡਾਇਰੈਕਟਰੀ
- ਕੇਂਦਰੀਕ੍ਰਿਤ ਸੰਰਚਨਾ `.env` ਫ਼ਾਈਲ ਰਾਹੀਂ (ਟੈਮਪਲੇਟ ਲਈ `.env.copy` ਦੀ ਵਰਤੋਂ ਕਰੋ)

## ਸੈਟਅਪ ਕਮਾਂਡਾਂ

### ਪਹਿਲਾ ਭੰਡਾਰ ਸੈਟਅਪ

```bash
# ਰਿਪੋਜਟਰੀ ਨੂੰ ਕਲੋਨ ਕਰੋ
git clone https://github.com/microsoft/generative-ai-for-beginners.git
cd generative-ai-for-beginners

# ਵਾਤਾਵਰਣ ਟੈਂਪਲੇਟ ਨੂੰ ਕਾਪੀ ਕਰੋ
cp .env.copy .env
# ਆਪਣੀਆਂ API ਕੁੰਜੀਆਂ ਅਤੇ ਐਂਡਪੌਇੰਟਸ ਨਾਲ .env ਨੂੰ ਸੋਧੋ
```

### ਪਾਇਥਨ ਵਾਤਾਵਰਣ ਸੈਟਅਪ

```bash
# ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਬਣਾਓ
python3 -m venv venv

# ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਨੂੰ ਸਰਗਰਮ ਕਰੋ
# macOS/Linux 'ਤੇ:
source venv/bin/activate
# Windows 'ਤੇ:
venv\Scripts\activate

# ਡੀਪੈਂਡੈਂਸੀਸ ਇੰਸਟਾਲ ਕਰੋ
pip install -r requirements.txt
```

### ਨੋਡ.js/ਟਾਈਪਸਕ੍ਰਿਪਟ ਸੈਟਅਪ

```bash
# ਰੂਟ-ਸਤਰ ਦੀਆਂ dependencies ਇੰਸਟਾਲ ਕਰੋ (ਦਸਤਾਵੇਜ਼ਕਰਨ ਸੰਦਾਂ ਲਈ)
npm install

# ਵੱਖ-ਵੱਖ ਪਾਠ ਦੇ TypeScript ਉਦਾਹਰਣਾਂ ਲਈ, ਵਿਸ਼ੇਸ਼ ਪਾਠ 'ਤੇ ਜਾਓ:
cd 06-text-generation-apps/typescript/recipe-app
npm install
```

### ਡੈਵ ਕੰਟੇਨਰ ਸੈਟਅਪ (ਸਿਫਾਰਸ਼ੀ)

ਭੰਡਾਰ ਵਿੱਚ GitHub Codespaces ਜਾਂ VS ਕੋਡ ਡੈਵ ਕੰਟੇਨਰ ਲਈ `.devcontainer` ਸੰਰਚਨਾ ਸ਼ਾਮਲ ਹੈ:

1. GitHub Codespaces ਜਾਂ VS ਕੋਡ ਵਿੱਚ ਡੈਵ ਕੰਟੇਨਰ ਐਕਸਟੇਸ਼ਨ ਨਾਲ ਭੰਡਾਰ ਖੋਲ੍ਹੋ
2. ਡੈਵ ਕੰਟੇਨਰ ਸਵੈਚਾਲਿਤ ਤੌਰ ‘ਤੇ:
   - `requirements.txt` ਤੋਂ ਪਾਇਥਨ ਦੀਆਂ ਡਿਪੈਂਡੇਨਸੀਜ਼ ਇੰਸਟਾਲ ਕਰੇਗਾ
   - ਪੋਸਟ-ਕ੍ਰੀਏਟ ਸਕ੍ਰਿਪ੍ਟ ਚਲਾਏਗਾ (`.devcontainer/post-create.sh`)
   - ਜੂਪਿਟਰ ਕਰਨਲ ਸੈਟਅਪ ਕਰੇਗਾ

## ਵਿਕਾਸ ਵਰਕਫਲੋ

### ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ

ਸਾਰੇ ਪਾਠਾਂ ਨੂੰ API ਪਹੁੰਚ ਲਈ `.env` ਵਿੱਚ_DEFINED ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਦੀ ਲੋੜ ਹੁੰਦੀ ਹੈ:

- `OPENAI_API_KEY` - OpenAI API ਲਈ
- `AZURE_OPENAI_API_KEY` - Microsoft Foundry ਵਿੱਚ ਏਜ਼ਯੂਰ OpenAI ਲਈ (ਏਜ਼ਯੂਰ OpenAI ਸੇਵਾ ਹੁਣ Microsoft Foundry ਦਾ ਹਿੱਸਾ ਹੈ: https://ai.azure.com)
- `AZURE_OPENAI_ENDPOINT` - ਏਜ਼ਯੂਰ OpenAI ਏਂਡਪੋਇੰਟ URL (Foundry ਸਰੋਤ ਏਂਡਪੋਇੰਟ)
- `AZURE_OPENAI_DEPLOYMENT` - ਚੈਟ ਸਮਾਪਤੀ ਮਾਡਲ ਡਿਪਲੋਇਮੈਂਟ ਨਾਮ (ਕੋਰਸ ਮੂਲ: `gpt-5-mini`)
- `AZURE_OPENAI_EMBEDDINGS_DEPLOYMENT` - ਐਮਬੈਡਿੰਗਸ ਮਾਡਲ ਡਿਪਲੋਇਮੈਂਟ ਨਾਮ (ਕੋਰਸ ਮੂਲ: `text-embedding-3-small`)
- `AZURE_OPENAI_API_VERSION` - API ਸੰਸਕਰਨ (ਮੂਲ: `2024-10-21`)
- `HUGGING_FACE_API_KEY` - Hugging Face ਮਾਡਲਾਂ ਲਈ
- `AZURE_INFERENCE_ENDPOINT` - Microsoft Foundry ਮਾਡਲਸ ਏਂਡਪੋਇੰਟ (ਬਹੁ-ਪ੍ਰਦਾਤਾ ਮਾਡਲ ਕੈਟਾਲੌਗ)
- `AZURE_INFERENCE_CREDENTIAL` - Microsoft Foundry ਮਾਡਲਸ API ਕੀ (ਰਿਟਾਇਰ ਹੋ ਰਹੇ `GITHUB_TOKEN` ਦੀ ਥਾਂ)
- `AZURE_INFERENCE_CHAT_MODEL` - ਇਕ ਗੈਰ-ਵਿਚਾਰ ਮਾਡਲ (ਜਿਵੇਂ `Llama-3.3-70B-Instruct`) ਜੋ `temperature` ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਵਰਤਿਆ ਜਾਂਦਾ ਹੈ, ਕਿਉਂਕਿ ਵਿਚਾਰਸ਼ੀਲ ਮਾਡਲ ਸੈਂਪਲਿੰਗ ਨਿਯੰਤਰਣਾਂ ਦਾ ਸਮਰਥਨ ਨਹੀਂ ਕਰਦੇ

### ਮਾਡਲ ਧਾਰਣਾਵਾਂ (ਮਹੱਤਵਪੂਰਨ)

- **ਮੂਲ ਚੈਟ ਮਾਡਲ `gpt-5-mini` ਹੈ** - ਇਕ ਮੌਜੂਦਾ, ਗੈਰ-ਹਟਾਏ ਗਏ **ਵਿਚਾਰਸ਼ੀਲ** ਮਾਡਲ। 2026 ਤੋਂ ਬਾਅਦ ਪੁਰਾਣੇ ਤਾਪਮਾਨ-ਸਮਰਥ “ਮੀਨੀ” ਮਾਡਲ (`gpt-4o-mini`, `gpt-4.1-mini`) *ਹਟਾਏ ਜਾਂਦੇ ਹਨ*, ਇਸ ਲਈ ਕੋਰਸ GPT-5 ਪਰਿਵਾਰ ਤੇ ਧਿਆਨ ਕੇਂਦਰਿਤ ਕਰਦਾ ਹੈ।
- **ਵਿਚਾਰਸ਼ੀਲ ਮਾਡਲ `temperature` ਅਤੇ `top_p` ਨੂੰ ਅਸਵੀਕਾਰ ਕਰਦੇ ਹਨ**, ਅਤੇ `max_tokens` ਦੀ ਥਾਂ `max_output_tokens` (Responses API) / `max_completion_tokens` (ਚੈਟ ਸਮਾਪਤੀਆਂ) ਵਰਤਦੇ ਹਨ। `gpt-5-mini` ਨੂੰ ਕਾਲ ਕਰਨ ਵਾਲੇ ਨਮੂਨਿਆਂ ਵਿੱਚ `temperature`/`top_p`/`max_tokens` ਨਾ ਜੋੜੋ।
- **`temperature` ਦੇ ਨਮੂਨੇ ਲਈ**, ਨਮੂਨੇ Microsoft Foundry ਮਾਡਲਸ ਏਂਡਪੋਇੰਟ (`AZURE_INFERENCE_CHAT_MODEL`) ਰਾਹੀਂ **Llama** ਮਾਡਲ (`Llama-3.3-70B-Instruct`) ਨੂੰ ਵਰਤਦੇ ਹਨ। ਵਿਚਾਰਸ਼ੀਲ ਮਾਡਲਾਂ ਨੂੰ ਸੈਂਪਲਿੰਗ ਨਿਯੰਤਰਣਾਂ ਦੀ ਥਾਂ ਪ੍ਰੰਪਟ ਇੰਜੀਨੀਅਰਿੰਗ + ਵਿਚਾਰਸ਼ੀਲ ਨਿਯੰਤਰਣ ਨਾਲ ਸਾਂਭੋ।
- **ਫਾਈਨ-ਟਿਊਨਿੰਗ (ਪਾਠ 18)** `gpt-4.1-mini` ਰੱਖਦਾ ਹੈ: GPT-5 ਸਿਰਫ਼ ਰੀਇੰਫੋਰਸਮੈਂਟ ਫਾਈਨ-ਟਿਊਨਿੰਗ (RFT) ਨੂੰ ਸਮਰਥਨ ਕਰਦਾ ਹੈ, ਨਾ ਕਿ ਉਸਪਰੀਵਾਜ਼ਡ ਫਾਈਨ-ਟਿਊਨਿੰਗ (SFT) ਜੋ ਉਥੇ ਦਿਖਾਇਆ ਗਿਆ ਹੈ।
- ਪਾਠ 20 (ਮਿਸਟ੍ਰਾਲ) ਅਤੇ 21 (ਮੇਟਾ) `temperature`/`max_tokens` ਰੱਖਦੇ ਹਨ ਕਿਉਂਕਿ ਉਹ ਮਿਸਟ੍ਰਾਲ/ਲਾਮਾ ਮਾਡਲਾਂ ਨੂੰ ਟਾਰਗੇਟ ਕਰਦੇ ਹਨ ਜੋ ਉਹਨਾਂ ਨੂੰ ਸਮਰਥਨ ਕਰਦੇ ਹਨ।

### ਪਾਇਥਨ ਉਦਾਹਰਣ ਚਲਾਉਣ

```bash
# ਸਬਕ ਡਿਰੈਕਟਰੀ 'ਚ ਜਾਓ
cd 06-text-generation-apps/python

# ਇੱਕ ਪਾਇਥਨ ਸਕ੍ਰਿਪਟ ਚਲਾਓ
python aoai-app.py
```

### ਟਾਈਪਸਕ੍ਰਿਪਟ ਉਦਾਹਰਣ ਚਲਾਉਣ

```bash
# ਟਾਈਪਸਕ੍ਰਿਪਟ ਐਪ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਜਾਓ
cd 06-text-generation-apps/typescript/recipe-app

# ਟਾਈਪਸਕ੍ਰਿਪਟ ਕੋਡ ਨੂੰ ਬਿਲਡ ਕਰੋ
npm run build

# ਐਪਲੀਕੇਸ਼ਨ ਚਲਾਓ
npm start
```

### ਜੂਪਿਟਰ ਨੋਟਬੁੱਕਸ ਚਲਾਉਣ

```bash
# ਰਿਪੋਜ਼ਟਰੀ ਰੂਟ ਵਿੱਚ ਜੂਪਿਟਰ ਸ਼ੁਰੂ ਕਰੋ
jupyter notebook

# ਜਾਂ ਜੂਪਿਟਰ ਐਕਸਟੈਂਸ਼ਨ ਦੇ ਨਾਲ VS ਕੋਡ ਵਰਤੋ
```

### ਵੱਖ-ਵੱਖ ਪਾਠ ਕਿਸਮਾਂ ਨਾਲ ਕੰਮ ਕਰਨਾ

- **"ਸਿੱਖੋ" ਪਾਠ**: README.md ਦਸਤਾਵੇਜ਼ ਅਤੇ ਧਾਰਨਾਂ ਤੇ ਕੇਂਦਰਿਤ
- **"ਬਨਾਓ" ਪਾਠ**: ਪਾਇਥਨ ਅਤੇ ਟਾਈਪਸਕ੍ਰਿਪਟ ਵਿੱਚ ਕੰਮ ਕਰਨ ਵਾਲੇ ਕੋਡ ਉਦਾਹਰਣ ਸ਼ਾਮਲ ਹਨ
- ਹਰ ਪਾਠ ਦਾ README.md ਹੁੰਦਾ ਹੈ ਜਿਸ ਵਿੱਚ ਸਿਧਾਂਤ, ਕੋਡ ਚੱਲਣੀਆਂ ਅਤੇ ਵੀਡੀਓ ਸਮੱਗਰੀ ਲਈ ਲਿੰਕ ਹੁੰਦੇ ਹਨ

## ਕੋਡ ਸ਼ੈਲੀ ਦੀਆਂ ਰਹਿਣਿਯਾਂ

### ਪਾਇਥਨ

- ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਪ੍ਰਬੰਧਨ ਲਈ `python-dotenv` ਦੀ ਵਰਤੋਂ ਕਰੋ
- API ਸੰਪਰਕ ਲਈ `openai` ਲਾਇਬ੍ਰੇਰੀ ਇੰਪੋਰਟ ਕਰੋ
- Linting ਲਈ `pylint` ਦੀ ਵਰਤੋਂ ਕਰੋ (ਕਈ ਉਦਾਹਰਣਾਂ ਵਿੱਚ ਸਾਦਗੀ ਲਈ `# pylint: disable=all` ਹੁੰਦਾ ਹੈ)
- PEP 8 ਨਾਂਕਰਨ ਰੀਤੀਆਂ ਦੀ ਪਾਲਣਾ ਕਰੋ
- API ਸਰਟੀਫਿਕੇਟ `.env` ਫ਼ਾਈਲ ਵਿੱਚ ਸਟੋਰ ਕਰੋ, ਕਦੇ ਵੀ ਕੋਡ ਵਿੱਚ ਨਹੀਂ

### ਟਾਈਪਸਕ੍ਰਿਪਟ

- ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਲਈ `dotenv` ਪੈਕੇਜ ਦੀ ਵਰਤੋਂ ਕਰੋ
- ਹਰ ਐਪ ਲਈ `tsconfig.json` ਵਿੱਚ ਟਾਈਪਸਕ੍ਰਿਪਟ ਸੰਰਚਨਾ
- ਏਜ਼ਯੂਰ OpenAI ਲਈ `openai` ਪੈਕੇਜ ਦੀ ਵਰਤੋਂ ਕਰੋ (ਕਲਾਇੰਟ ਨੂੰ `/openai/v1/` ਏਂਡਪੋਇੰਟ ਸੈੱਟ ਕਰੋ ਅਤੇ `client.responses.create` ਕਾਲ ਕਰੋ); Microsoft Foundry ਮਾਡਲ ਲਈ `@azure-rest/ai-inference` ਦੀ ਵਰਤੋਂ ਕਰੋ
- ਆਟੋ-ਰੀਲੋਡ ਲਈ `nodemon` ਦੀ ਵਰਤੋਂ ਕਰੋ
- ਚਲਾਉਣ ਤੋਂ ਪਹਿਲਾਂ ਬਿਲਡ ਕਰੋ: `npm run build` ਫਿਰ `npm start`

### ਆਮ ਧਾਰਣਾਵਾਂ

- ਕੋਡ ਉਦਾਹਰਣ ਸਧਾਰਨ ਅਤੇ ਸਿੱਖਿਆਮੁਖ ਹੋਣੇ ਚਾਹੀਦੇ ਹਨ
- ਮੁੱਖ ਧਾਰਨਾਵਾਂ ਬਾਰੇ ਟਿੱਪਣੀਆਂ ਸ਼ਾਮਲ ਕਰੋ
- ਹਰ ਪਾਠ ਦਾ ਕੋਡ ਖੁਦਮੁਖਤਿਆਰ ਅਤੇ ਚਲਾਊ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ
- ਸਥਿਰ ਨਾਂਕਰਨ ਵਰਤੋ: ਏਜ਼ਯੂਰ OpenAI ਲਈ `aoai-` ਉਪਸਰਗ, OpenAI API ਲਈ `oai-`, Microsoft Foundry ਮਾਡਲ ਲਈ `githubmodels-` (GitHub ਮਾਡਲ ਯੁੱਗ ਤੋਂ ਉਪਸਰਗ ਬਚਾਇਆ ਗਿਆ)

## ਦਸਤਾਵੇਜ਼ਗਾਰੀ ਧਾਰਣਾਵਾਂ

### ਮਾਰਕਡਾਊਨ ਸ਼ੈਲੀ

- ਸਾਰੇ URL `[text](../../url)` ਫਾਰਮੈਟ ਵਿੱਚ ਲਿਖੇ ਜਾਣੇ ਚਾਹੀਦੇ ਹਨ ਬਿਨਾਂ ਵਾਧੂ ਖਾਲੀ ਥਾਂ ਦੇ
- ਸਾਪੇਕਸ਼ ਲਿੰਕ `./` ਜਾਂ `../` ਨਾਲ ਸ਼ੁਰੂ ਕਰਨੇ ਚਾਹੀਦੇ ਹਨ
- ਸਾਰੇ ਮਾਈਕਰੋਸੋਫਟ ਡੋਮੇਨ ਲਿੰਕਾਂ ਵਿੱਚ ਟ੍ਰੈਕਿੰਗ ID ਸ਼ਾਮਲ ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ: `?WT.mc_id=academic-105485-koreyst`
- URLs ਵਿੱਚ ਦੇਸ਼-ਖ਼ਾਸ ਟੋਟਕਿਆਂ ਤੋਂ ਬਚੋ (ਜਿਵੇਂ `/en-us/`)
- ਤਸਵੀਰਾਂ `./images` ਫੋਲਡਰ ਵਿੱਚ ਵਰਣਨਾਤਮਕ ਨਾਮਾਂ ਨਾਲ ਸਟੋਰ ਕਰੋ
- ਫ਼ਾਈਲ ਦੇ ਨਾਮਾਂ ਵਿੱਚ ਅੰਗਰੇਜ਼ੀ ਅੱਖਰ, ਨੰਬਰਾਂ ਅਤੇ ਡੈਸ਼ ਦੀ ਵਰਤੋਂ ਕਰੋ

### ਅਨੁਵਾਦ ਸਹਾਇਤਾ

- ਭੰਡਾਰ ਵਿੱਚ 40+ ਭਾਸ਼ਾਵਾਂ ਲਈ GitHub ਐਕਸ਼ਨਸ ਆਟੋਮੈਟਿਕ ਸਹਾਇਤਾ ਹੈ
- ਅਨੁਵਾਦ `translations/` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਸਟੋਰ ਹੁੰਦੇ ਹਨ
- ਅੰਸ਼ਕ ਅਨੁਵਾਦ ਸਬਮਿਟ ਨਾ ਕਰੋ
- ਮਸ਼ੀਨ ਅਨੁਵਾਦ ਸਵੀਕਾਰ ਨਹੀਂ ਕੀਤੇ ਜਾਂਦੇ
- ਅਨੁਵਾਦ ਕੀਤੀਆਂ ਤਸਵੀਰਾਂ `translated_images/` ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਸਟੋਰ ਕੀਤੀਆਂ ਜਾਣ

## ਪਰੀਖਣ ਅਤੇ ਮਿਆਰੀਕਰਨ

### ਪ੍ਰੀ-ਸਬਮਿਸ਼ਨ ਚੈਕਸ

ਇਹ ਭੰਡਾਰ ਪ੍ਰਮਾਣੀਕਰਨ ਲਈ GitHub ਐਕਸ਼ਨਸ ਵਰਤਦਾ ਹੈ। PR ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ:

1. **ਮਾਰਕਡਾਊਨ ਲਿੰਕ ਚੈੱਕ ਕਰੋ**:
   ```bash
   # validate-markdown.yml ਵਰਕਫਲੋ ਚੈੱਕ ਕਰਦਾ ਹੈ:
   # - ਟੁੱਟੇ ਹੋਏ ਰਿਸ਼ਤੀ ਵਾਲੇ ਪਾਥ
   # - ਪਾਥਾਂ 'ਤੇ ਗੁੰਨਤੀ ਦੀਆਂ IDs ਗਾਇਬ ਹਨ
   # - URLs 'ਤੇ ਗੁੰਨਤੀ ਦੀਆਂ IDs ਗਾਇਬ ਹਨ
   # - ਦੇਸ਼ੀ ਸਥਾਨਕਤਾ ਵਾਲੇ URLs
   # - ਟੁੱਟੇ ਹੋਏ ਬਾਹਰੀ URLs
   ```

2. **ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ**:
   - ਪਾਇਥਨ ਉਦਾਹਰਣਾਂ ਦੀ ਜਾਂਚ ਕਰੋ: ਵੈਨਵੀਵ ਨੂੰ ਐਕਟਿਵੇਟ ਕਰਕੇ ਸਕ੍ਰਿਪਟ ਚਲਾਓ
   - ਟਾਈਪਸਕ੍ਰਿਪਟ ਉਦਾਹਰਣਾਂ ਦੀ ਜਾਂਚ ਕਰੋ: `npm install`, `npm run build`, `npm start`
   - ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਸਹੀ ਤਰ੍ਹਾਂ ਸੰਰਚਿਤ ਹਨ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
   - ਕੋਡ ਉਦਾਹਰਣਾਂ ਨਾਲ API ਕੀਆਂ ਕੰਮ ਕਰ ਰਹੀਆਂ ਹਨ ਜਾਂ ਨਹੀਂ ਵੇਰੀਫਾਈ ਕਰੋ

3. **ਕੋਡ ਉਦਾਹਰਣ**:
   - ਸਾਰੇ ਕੋਡ ਬਿਨਾਂ ਗਲਤੀ ਦੇ ਚੱਲਿਆਂ ਇਹ ਯਕੀਨੀ ਬਣਾਓ
   - ਜਿੱਥੇ ਲਾਗੂ ਹੁੰਦੇ ਹਨ ਉੱਥੇ ਏਜ਼ਯੂਰ OpenAI ਅਤੇ OpenAI API ਨਾਲ ਟੈਸਟ ਕਰੋ
   - ਜਿੱਥੇ ਸਹਾਇਤਾ ਹੁੰਦੀ ਹੈ ਉੱਥੇ Microsoft Foundry ਮਾਡਲ ਨਾਲ ਉਦਾਹਰਣਾਂ ਦੀ ਜਾਂਚ ਕਰੋ

### ਕੋਈ ਆਟੋਮੈਟਿਕ ਟੈਸਟ ਨਹੀਂ

ਇਹ ਇੱਕ ਸਿੱਖਣ ਵਾਲਾ ਭੰਡਾਰ ਹੈ ਜੋ ਟਿਊਟੋਰੀਅਲ ਅਤੇ ਉਦਾਹਰਣਾਂ ‘ਤੇ ਧਿਆਨ ਕੇਂਦਰਿਤ ਕਰਦਾ ਹੈ। ਕੋਈ ਯੂਨਿਟ ਜਾਂ ਇੰਟੀਗ੍ਰੇਸ਼ਨ ਟੈਸਟ ਨਹੀਂ ਹਨ। ਪ੍ਰਮਾਣੀਕਰਨ ਪ੍ਰਧਾਨਤ:
- ਕੋਡ ਉਦਾਹਰਣਾਂ ਦੀ ਮੈਨੂਅਲ ਟੈਸਟਿੰਗ
- ਮਾਰਕਡਾਊਨ ਪ੍ਰਮਾਣੀਕਰਨ ਲਈ GitHub ਐਕਸ਼ਨਸ
- ਸਿੱਖਿਆ ਸਮੱਗਰੀ ਲਈ ਕਮਿਊਨਿਟੀ ਸਮੀਖਿਆ

## ਪੁਲ ਰਿਕਵੇਸਟ ਰਹਿਣਿਯਾਂ

### ਜਮ੍ਹਾਂ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ

1. ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ, ਪਾਇਥਨ ਅਤੇ ਟਾਈਪਸਕ੍ਰਿਪਟ ਦੋਹਾਂ ਵਿੱਚ ਕੋਡ ਬਦਲਾਅ ਟੈਸਟ ਕਰੋ
2. ਮਾਰਕਡਾਊਨ ਪ੍ਰਮਾਣੀਕਰਨ ਚਲਾਓ (ਆਪੋ-ਆਪ ਚਲਦਾ ਹੈ PR ਤੇ)
3. ਸਾਰੇ Microsoft URLs ਤੇ ਟ੍ਰੈਕਿੰਗ IDs ਦੀ ਸ਼ਮੂਲੀਅਤ ਯਕੀਨੀ ਬਣਾਓ
4. ਸਾਪੇਕਸ਼ ਲਿੰਕ ਮਾਨਯੋਗ ਹਨ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
5. ਤਸਵੀਰਾਂ ਨੂੰ ਠੀਕ ਤਰ੍ਹਾਂ ਦਰਸਾਇਆ ਗਿਆ ਹੈ ਜਾਚ ਕਰੋ

### PR ਸਿਰਲੇਖ ਫਾਰਮੈਟ

- ਵਰਣਨਾਤਮਕ ਸਿਰਲੇਖ ਵਰਤੋਂ: `[Lesson 06] ਪਾਇਥਨ ਉਦਾਹਰਣ ਟਾਈਪੋ ਠੀਕ ਕਰੋ` ਜਾਂ `Update README for lesson 08`
- ਜਿੱਥੇ ਲਾਗੂ ਹੋਵੇ ਮੁੱਦੇ ਨੰਬਰ ਦਿਓ: `Fixes #123`

### PR ਵਰਣਨ

- ਕੀ ਬਦਲਿਆ ਗਿਆ ਅਤੇ ਕਿਉਂ ਬਤਾਓ
- ਸੰਬੰਧਿਤ ਮੁੱਦਿਆਂ ਲਈ ਲਿੰਕ ਦਿਓ
- ਕੋਡ ਬਦਲਾਅ ਲਈ, ਦੱਸੋ ਕਿਹੜੇ ਉਦਾਹਰਣ ਟੈਸਟ ਕੀਤੇ ਗਏ
- ਅਨੁਵਾਦ PRs ਲਈ, ਸਾਰੇ ਫਾਈਲਾਂ ਸ਼ਾਮਲ ਕਰੋ ਪੂਰੇ ਅਨੁਵਾਦ ਲਈ

### ਯੋਗਦਾਨ ਦੀਆਂ ਲੋੜਾਂ

- Microsoft CLA ‘ਤੇ ਦਸਤਖਤ ਕਰੋ (ਪਹਿਲੇ PR ਤੇ ਆਟੋਮੈਟਿਕ)
- ਬਦਲਾਅ ਕਰਨ ਤੋਂ ਪਹਿਲਾਂ ਭੰਡਾਰ ਨੂੰ ਆਪਣੇ ਖਾਤੇ ਵਿੱਚ ਫੋਰਕ ਕਰੋ
- ਇੱਕ तारਕਿਕ ਬਦਲਾਅ ‘ਤੇ ਇੱਕ PR (ਅਸੰਬੰਧਤ ਫਿਕਸ ਨਾ ਜੋੜੋ)
- ਜਿੱਥੇ ਸੰਭਵ ਹੋਵੇ PR ਲਘੂ ਅਤੇ ਕੇਂਦਰਿਤ ਰੱਖੋ

## ਆਮ ਵਰਕਫਲੋ

### ਨਵਾਂ ਕੋਡ ਉਦਾਹਰਣ ਸ਼ਾਮਲ ਕਰਨਾ

1. ਸਬੰਧਤ ਪਾਠ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਜਾਓ
2. `python/` ਜਾਂ `typescript/` ਸਬ-ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਉਦਾਹਰਣ ਬਣਾਓ
3. ਨਾਂਕਰਨ ਦਾ ਧਿਆਨ ਰੱਖੋ: `{provider}-{example-name}.{py|ts|js}`
4. ਅਸਲੀ API ਸਰਟੀਫਿਕੇਟ ਨਾਲ ਟੈਸਟ ਕਰੋ
5. ਨਵੇਂ ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਕਿਸੇ ਵੀ ਪਾਠ README ਵਿੱਚ ਦਰਜ ਕਰੋ

### ਦਸਤਾਵੇਜ਼ਗਾਰੀ ਅੱਪਡੇਟ ਕਰਨਾ

1. ਪਾਠ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ README.md ਸੰਪਾਦਨ ਕਰੋ
2. ਮਾਰਕਡਾਊਨ ਨਿਯਮਾਂ ਦੀ ਪਾਲਣਾ ਕਰੋ (ਟ੍ਰੈਕਿੰਗ IDs, ਸਾਪੇਕਸ਼ ਲਿੰਕ)
3. ਅਨੁਵਾਦ GitHub ਐਕਸ਼ਨਸ ਦੁਆਰਾ ਸਣਭਾਲੇ ਜਾਂਦੇ ਹਨ (ਹੱਥੋਂ ਸੰਪਾਦਨ ਨਾ ਕਰੋ)
4. ਸਾਰੇ ਲਿੰਕ ਮਾਨਯੋਗ ਹਨ ਜਾਂ ਨਹੀਂ ਟੈਸਟ ਕਰੋ

### ਡੈਵ ਕੰਟੇਨਰ ਨਾਲ ਕੰਮ ਕਰਨਾ

1. ਭੰਡਾਰ ਵਿੱਚ `.devcontainer/devcontainer.json` ਹੈ
2. ਪੋਸਟ-ਕ੍ਰੀਏਟ ਸਕ੍ਰਿਪਟ ਪਾਇਥਨ ਡਿਪੈਂਡੇਨਸੀਜ਼ ਆਟੋਮੈਟਿਕਲੀ ਇੰਸਟਾਲ ਕਰਦਾ ਹੈ
3. ਪਾਇਥਨ ਅਤੇ ਜੂਪਿਟਰ ਲਈ ਐਕਸਟੇਸ਼ਨਾਂ ਪੂਰਵ-ਸੈਟ ਕੀਤੀਆਂ ਹੋਈਆਂ ਹਨ
4. ਵਾਤਾਵਰਣ `mcr.microsoft.com/devcontainers/universal:2.11.2` 'ਤੇ ਆਧਾਰਿਤ ਹੈ

## ਡਿਪਲੋਇਮੈਂਟ ਅਤੇ ਪ੍ਰਕਾਸ਼ਨ

ਇਹ ਸਿੱਖਣ ਵਾਲਾ ਭੰਡਾਰ ਹੈ - ਕੋਈ ਡਿਪਲੋਇਮੈਂਟ ਪ੍ਰਕਿਰਿਆ ਨਹੀਂ ਹੈ। ਕੋਰਸ ਨੂੰ ਖਪਤ ਕੀਤੀ ਜਾਂਦੀ ਹੈ:

1. **GitHub ਭੰਡਾਰ**: ਕੋਡ ਅਤੇ ਦਸਤਾਵੇਜ਼ ਲਈ ਸਿੱਧਾ ਪਹੁੰਚ
2. **GitHub Codespaces**: ਪ੍ਰੀ-ਸੈਟ ਕੀਤੇ ਡੈਵ ਵਾਤਾਵਰਣ ਦੇ ਨਾਲ ਤਤਕਾਲ ਪਹੁੰਚ
3. **Microsoft Learn**: ਸਮੱਗਰੀ ਸਰਕਾਰੀ ਸਿੱਖਣ ਪਲੇਟਫਾਰਮ 'ਤੇ ਪ੍ਰਸਾਰਿਤ ho ਸਕਦੀ ਹੈ
4. **docsify**: ਮਾਰਕਡਾਊਨ ਤੋਂ ਬਣੀ ਦਸਤਾਵੇਜ਼ਗਾਰੀ ਸਾਈਟ (ਦਿੱਖੋ `docsifytopdf.js` ਅਤੇ `package.json`)

### ਦਸਤਾਵੇਜ਼ਗਾਰੀ ਸਾਈਟ ਬਣਾਉਣਾ

```bash
# ਦਸਤਾਵੇਜ਼ਾਤੋਂ PDF ਤਿਆਰ ਕਰੋ (ਜੇ ਲੋੜ ਹੋਵੇ)
npm run convert
```

## ਸਮੱਸਿਆ ਨਿਪਟਾਰਾ

### ਆਮ ਸਮੱਸਿਆਵਾਂ

**ਪਾਇਥਨ ਇੰਪੋਰਟ ਗਲਤੀਆਂ**:
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ ਵਰਚੁਅਲ ਵਾਤਾਵਰਣ ਐਕਟਿਵ ਹੈ
- `pip install -r requirements.txt` ਚਲਾਓ
- ਪਾਇਥਨ ਸੰਸਕਰਨ 3.9+ ਹੈ ਜਾਂ ਨਹੀਂ ਜਾਚ ਕਰੋ

**ਟਾਈਪਸਕ੍ਰਿਪਟ ਬਿਲਡ ਗਲਤੀਆਂ**:
- ਖਾਸ ਐਪ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ `npm install` ਚਲਾਓ
- ਨੋਡ.js ਸੰਸਕਰਨ ਨਾਲਤ ਕੀਤਾ ਹੋਇਆ ਹੈ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
- `node_modules` ਸਾਫ਼ ਕਰੋ ਅਤੇ ਲੋੜ ਪੈਣ ’ਤੇ ਫੇਰ ਇੰਸਟਾਲ ਕਰੋ

**API ਪ੍ਰਮਾਣਿਕਤਾ ਗਲਤੀਆਂ**:
- ਯਕੀਨੀ ਬਣਾਓ ਕਿ `.env` ਫ਼ਾਈਲ ਮੌਜੂਦ ਹੈ ਅਤੇ ਸਹੀ ਮੁੱਲਾਂ ਨਾਲ ਹੈ
- API ਕੀ ਸਹੀ ਅਤੇ ਸਮਾਪਤ ਨਹੀਂ ਹੋਈਆਂ ਹਨ ਜਾਂ ਨਹੀਂ ਚੈੱਕ ਕਰੋ
- ਆਪਣੇ ਖੇਤਰ ਲਈ ਏਂਡਪੋਇੰਟ URLs ਸਹੀ ਹਨ ਜਾਂ ਨਹੀਂ ਵੇਖੋ

**ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਗਾਇਬ ਹਨ**:
- `.env.copy` ਨੂੰ `.env` ਵਿੱਚ ਕਾਪੀ ਕਰੋ
- ਜਿੱਥੇ ਤੁਸੀਂ ਕੰਮ ਕਰ ਰਹੇ ਹੋ, ਸਾਰੇ ਲੋੜੀਂਦੇ ਮੁੱਲ ਭਰੋ
- `.env` ਅਪਡੇਟ ਕਰਨ ਤੋਂ ਬਾਅਦ ਆਪਣਾ ਐਪ ਰੀਸਟਾਰਟ ਕਰੋ

## ਵਾਧੂ ਸਰੋਤ

- [ਕੋਰਸ ਸੈਟਅਪ ਗਾਈਡ](./00-course-setup/README.md?WT.mc_id=academic-105485-koreyst)
- [ਯੋਗਦਾਨ ਰਹਿਨੁਮਾ](./CONTRIBUTING.md)
- [ਆਚਰਨ ਸੰਹਿਤਾ](./CODE_OF_CONDUCT.md)
- [ਸੁਰੱਖਿਆ ਨੀਤੀ](./SECURITY.md)
- [ਏਜ਼ਯੂਰ ਏਆਈ ਡਿਸਕੋਰਡ](https://aka.ms/genai-discord?WT.mc_id=academic-105485-koreyst)
- [ਅਗੇਰੀ ਕੋਡ ਸੰਪ੍ਰੇਸ਼ਣਾਂ ਦਾ ਸੰਗ੍ਰਹਿ](https://aka.ms/genai-beg-code?WT.mc_id=academic-105485-koreyst)

## ਪ੍ਰੋਜੈਕਟ-ਵਿਸ਼ੇਸ਼ ਨੋਟਸ

- ਇਹ ਇੱਕ **ਸਿੱਖਣ ਵਾਲਾ ਭੰਡਾਰ** ਹੈ ਜੋ ਸਿੱਖਣ ‘ਤੇ ਕੇਂਦਰਿਤ ਹੈ, ਉਤਪਾਦਨ ਕੋਡ ‘ਤੇ ਨਹੀਂ
- ਉਦਾਹਰਣ ਇਰਾਦਾਤੱਕ ਸਧਾਰਨ ਅਤੇ ਧਾਰਣਾਵਾਂ ਸਿਖਾਉਣ ਤੇ ਕੇਂਦਰਿਤ ਹਨ
- ਕੋਡ ਗੁਣਵੱਤਾ ਸਿੱਖਿਆ ਪਾਰਦਰਸ਼ਤਾ ਨਾਲ ਸੰਤੁਲਿਤ ਹੈ
- ਹਰ ਪਾਠ ਖੁਦਮੁਖਤਿਆਰ ਹੈ ਅਤੇ ਸੁਤੰਤਰ ਤੌਰ ‘ਤੇ ਮੁਕੰਮਲ ਕੀਤਾ ਜਾ ਸਕਦਾ ਹੈ
- ਭੰਡਾਰ ਕਈ API ਪ੍ਰਦਾਤਾ ਸਮਰਥਿਤ ਕਰਦਾ ਹੈ: ਏਜ਼ਯੂਰ OpenAI, OpenAI, Microsoft Foundry ਮਾਡਲ, ਅਤੇ অফਲਾਈਨ ਪ੍ਰਦਾਤਾ ਜਿਵੇਂ Foundry Local ਅਤੇ Ollama
- ਸਮੱਗਰੀ ਬਹੁਭਾਸ਼ੀਅ ਹੈ ਜਿਸ ਵਿੱਚ ਆਟੋਮੈਟਿਕ ਅਨੁਵਾਦ ਵਰਕਫਲੋ ਸ਼ਾਮਲ ਹਨ
- ਸਵਾਲਾਂ ਅਤੇ ਸਹਾਇਤਾ ਲਈ Discord ‘ਤੇ ਸਰਗਰਮ ਕਮਿਊਨਿਟੀ ਉਪਲਬਧ ਹੈ

---

<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**ਅਸਵੀਕਾਰੋਪਣ**:
ਇਸ ਦਸਤਾਵੇਜ਼ ਦਾ ਅਨੁਵਾਦ ਏਆਈ ਅਨੁਵਾਦ ਸੇਵਾ [Co-op Translator](https://github.com/Azure/co-op-translator) ਦੀ ਵਰਤੋਂ ਕਰਕੇ ਕੀਤਾ ਗਿਆ ਹੈ। ਜਦੋਂ ਕਿ ਅਸੀਂ ਸਹੀਤਾਵਾਂ ਲਈ ਯਤਨਸ਼ੀਲ ਹਾਂ, ਕਿਰਪਾ ਕਰਕੇ ਧਿਆਨ ਰੱਖੋ ਕਿ ਸਵੈਚਾਲਿਤ ਅਨੁਵਾਦਾਂ ਵਿੱਚ ਗਲਤੀਆਂ ਜਾਂ ਅਸਮੱਤਿਆਵਾਂ ਹੋ ਸਕਦੀਆਂ ਹਨ। ਮੂਲ ਦਸਤਾਵੇਜ਼ ਆਪਣੀ ਮੂਲ ਭਾਸ਼ਾ ਵਿੱਚ ਅਧਿਕਾਰਕ ਸਰੋਤ ਮੰਨਿਆ ਜਾਣਾ ਚਾਹੀਦਾ ਹੈ। ਜਰੂਰੀ ਜਾਣਕਾਰੀ ਲਈ, ਪੇਸ਼ੇਵਰ ਮਨੁੱਖੀ ਅਨੁਵਾਦ ਦੀ ਸਿਫ਼ਾਰਸ਼ ਕੀਤੀ ਜਾਂਦੀ ਹੈ। ਅਸੀਂ ਇਸ ਅਨੁਵਾਦ ਦੇ ਉਪਯੋਗ ਤੋਂ ਪੈਦਾ ਹੋਣ ਵਾਲੀਆਂ ਕਿਸੇ ਵੀ ਗਲਤਫਹਿਮੀਆਂ ਜਾਂ ਗਲਤ ਵਿਆਖਿਆਵਾਂ ਲਈ ਜਵਾਬਦੇਹ ਨਹੀਂ ਹਾਂ।
<!-- CO-OP TRANSLATOR DISCLAIMER END -->