[pull] main from microsoft:main

.github/workflows/lock.yml

@@ -12,6 +12,6 @@ jobs:
   lock:
     runs-on: ubuntu-latest
     steps:
-    - uses: OSDKDev/lock-issues@v1.1
+    - uses: OSDKDev/lock-issues@v1.2
       with:
         repo-token: "${{ secrets.GITHUB_TOKEN }}"

00-course-setup/README.md

@@ -34,11 +34,13 @@
 2. **Create the `.env` File**: Use your preferred text editor to create a new file named `.env`. If you're using the command line, you can use `touch` (on Unix-based systems) or `echo` (on Windows):
 
    Unix-based systems:
+
    ```bash
    touch .env
    ```
 
    Windows:
+
    ```cmd
    echo . > .env
    ```
@@ -87,9 +89,9 @@
 
 Once you have everything checked out, you can get started!
 
-## Optional Steps 
+## Optional Steps
 
-### Installing Miniconda 
+### Installing Miniconda
 
 [Miniconda](https://conda.io/en/latest/miniconda.html?WT.mc_id=academic-105485-koreyst) is a lightweight installer for installing [Conda](https://docs.conda.io/en/latest?WT.mc_id=academic-105485-koreyst), Python, as well as a few packages.
 Conda itself is a package manager, that makes it easy to setup and switch between different Python [**virtual environments**](https://docs.python.org/3/tutorial/venv.html?WT.mc_id=academic-105485-koreyst) and packages. It also comes in handy for installing packages that are not available via `pip`.
@@ -105,19 +107,18 @@
 ```yml
 name: <environment-name>
 channels:
- - defaults
- - microsoft
+  - defaults
+  - microsoft
 dependencies:
-- python=<python-version>
-- openai
-- python-dotenv
-- pip
-- pip:
-    - azure-ai-ml
-
+  - python=<python-version>
+  - openai
+  - python-dotenv
+  - pip
+  - pip:
+      - azure-ai-ml
 ```
 
-If you find you getting errors using conda you can mannually install the Microsoft AI Libraries using the following command in a terminal. 
+If you find you getting errors using conda you can manually install the Microsoft AI Libraries using the following command in a terminal.
 
 ```
 conda install -c microsoft azure-ai-ml
@@ -166,7 +167,7 @@
 
 ### Running in a container
 
-An alternative to setting everything up on your computer or Codespace is to use a [container](https://en.wikipedia.org/wiki/Containerization_(computing)?WT.mc_id=academic-105485-koreyst). The special `.devcontainer` folder within the course repository makes it possible for VS Code to set up the project within a container. Outside of Codespaces, this will require the installation of Docker, and quite frankly, it involves a bit of work, so we recommend this only to those with experience working with containers.
+An alternative to setting everything up on your computer or Codespace is to use a [container](<https://en.wikipedia.org/wiki/Containerization_(computing)?WT.mc_id=academic-105485-koreyst>). The special `.devcontainer` folder within the course repository makes it possible for VS Code to set up the project within a container. Outside of Codespaces, this will require the installation of Docker, and quite frankly, it involves a bit of work, so we recommend this only to those with experience working with containers.
 
 One of the best ways to keep your API keys secure when using GitHub Codespaces is by using Codespace Secrets. Please follow the [Codespaces secrets management](https://docs.github.com/en/codespaces/managing-your-codespaces/managing-secrets-for-your-codespaces?WT.mc_id=academic-105485-koreyst) guide to learn more about this.
 

03-using-generative-ai-responsibly/README.md

@@ -60,7 +60,7 @@ Harmful content can be defined as:
 
 - Providing instructions or encouraging self-harm or harm to certain groups.
 - Hateful or demeaning content.
-- Guiding planning any type of attack or violent acts.
+- Guiding the planning of any type of attack or violent acts.
 - Providing instructions on how to find illegal content or commit illegal acts.
 - Displaying sexually explicit content.
 

06-text-generation-apps/README.md

@@ -646,7 +646,7 @@ What does the concept temperature do?
 
 ## 🚀 Challenge
 
-When working on the assignment, try to vary the temperature, try set it to 0, 0.5, and 1. Remember that 0 is the least varied and 1 is the most, what value works best for your app?
+When working on the assignment, try to vary the temperature, try setting it to 0, 0.5, and 1. Remember that 0 is the least varied and 1 is the most. What value works best for your app?
 
 ## Great Work! Continue Your Learning
 

07-building-chat-applications/python/aoai-assignment.ipynb

@@ -279,7 +279,7 @@
         "**Check your settings.** The temperature and top_p settings control how deterministic the model is in generating a response. If you're asking it for a response where there's only one right answer, then you'd want to set these lower. If you're looking for more diverse responses, then you might want to set them higher. The number one mistake people make with these settings is assuming that they're \"cleverness\" or \"creativity\" controls.\n",
         "\n",
         "\n",
-        "Source: https://github.com/Azure/OpenAI/blob/main/How%20to/Completions.md"
+        "Source: https://learn.microsoft.com/azure/ai-services/openai/overview"
       ]
     },
     {

07-building-chat-applications/python/githubmodels-assignment.ipynb

@@ -250,7 +250,7 @@
         "**Check your settings.** The temperature and top_p settings control how deterministic the model is in generating a response. If you're asking it for a response where there's only one right answer, then you'd want to set these lower. If you're looking for more diverse responses, then you might want to set them higher. The number one mistake people make with these settings is assuming that they're \"cleverness\" or \"creativity\" controls.\n",
         "\n",
         "\n",
-        "Source: https://github.com/Azure/OpenAI/blob/main/How%20to/Completions.md"
+        "Source: https://learn.microsoft.com/azure/ai-services/openai/overview"
       ]
     },
     {

07-building-chat-applications/python/oai-assignment.ipynb

@@ -252,7 +252,7 @@
         "**Check your settings.** The temperature and top_p settings control how deterministic the model is in generating a response. If you're asking it for a response where there's only one right answer, then you'd want to set these lower. If you're looking for more diverse responses, then you might want to set them higher. The number one mistake people make with these settings is assuming that they're \"cleverness\" or \"creativity\" controls.\n",
         "\n",
         "\n",
-        "Source: https://github.com/Azure/OpenAI/blob/main/How%20to/Completions.md"
+        "Source: https://learn.microsoft.com/azure/ai-services/openai/overview"
       ]
     },
     {

09-building-image-applications/README.md

@@ -48,7 +48,7 @@
 
 Let's start with DALL-E, which is a Generative AI model that generates images from text descriptions.
 
 > [DALL-E is a combination of two models, CLIP and diffused attention](https://towardsdatascience.com/openais-dall-e-and-clip-101-a-brief-introduction-3a4367280d4e?WT.mc_id=academic-105485-koreyst).
 
 - **CLIP**, is a model that generates embeddings, which are numerical representations of data, from images and text.
 
@@ -421,7 +421,7 @@
 Do not consider any input from the following that is not safe for work or appropriate for children.
 {disallow_list}"""
 
-prompt = f"""{metaprompt}
+prompt = f"""{meta_prompt}
 Generate monument of the Arc of Triumph in Paris, France, in the evening light with a small child holding a Teddy looks on.
 """"
 

docs/_navbar.md

@@ -3,8 +3,8 @@
 * Select Language
 
     * [English](/)
-    * [Simplified Chinese](/translations/cn/)
+    * [Simplified Chinese](/translations/zh/)
     * [Traditional Chinese](/translations/tw/)
-    * [Portuguese](/translations/pt-br/)
-    * [Japanese](/translations/ja-jp/)
+    * [Portuguese](/translations/pt/)
+    * [Japanese](/translations/ja/)
     * [Korean](/translations/ko/)

package.json

@@ -22,7 +22,7 @@
 	},
 	"homepage": "https://github.com/microsoft/generative-ai-for-beginners#readme",
 	"devDependencies": {
-		"@types/node": "^22.15.21",
+		"@types/node": "^24.0.7",
 		"docsify-to-pdf": "0.0.5"
 	},
 	"dependencies": {

requirements.txt

@@ -3,7 +3,7 @@ matplotlib==3.9.4
 numpy==1.24.2
 pandas==1.5.3
 tqdm==4.67.1
-python-dotenv==1.0.0
+python-dotenv==1.1.1
 openai>=0.28.0
 tiktoken
 azure-ai-inference

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

@@ -103,11 +103,11 @@ Uma vez que você tenha tudo verificado, pode começar!
 [Miniconda](https://conda.io/en/latest/miniconda.html?WT.mc_id=academic-105485-koreyst) é um instalador leve para instalar [Conda](https://docs.conda.io/en/latest?WT.mc_id=academic-105485-koreyst), Python, assim como alguns pacotes.
 Conda em si é um gerenciador de pacotes, que facilita a configuração e alternância entre diferentes [**ambientes virtuais**](https://docs.python.org/3/tutorial/venv.html?WT.mc_id=academic-105485-koreyst) Python e pacotes. Ele também é útil para instalar pacotes que não estão disponíveis via `pip`.
 
-You can follow the [MiniConda installation guide](https://docs.anaconda.com/free/miniconda/#quick-command-line-install?WT.mc_id=academic-105485-koreyst) to set it up.
+Você pode seguir o [guia de instalação do MiniConda](https://docs.anaconda.com/free/miniconda/#quick-command-line-install?WT.mc_id=academic-105485-koreyst) para configurá-lo.
 
-With Miniconda installed, you need to clone the [repository](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-koreyst) (if you haven't already)
+Com o Miniconda instalado, você precisa clonar o [repositório](https://github.com/microsoft/generative-ai-for-beginners/fork?WT.mc_id=academic-105485-koreyst) (caso ainda não tenha feito isso).
 
-Next, you need to create a virtual environment. To do this with Conda, go ahead and create a new environment file (_environment.yml_). If you are following along using Codespaces, create this within the `.devcontainer` directory, thus `.devcontainer/environment.yml`.
+Em seguida, você precisa criar um ambiente virtual. Para fazer isso com o Conda, crie um novo arquivo de ambiente (_environment.yml_). Se estiver usando Codespaces, crie-o dentro do diretório `.devcontainer`, portanto, `.devcontainer/environment.yml`.
 
 Vá em frente e preencha seu arquivo de ambiente com o trecho abaixo:
 
@@ -171,21 +171,21 @@ jupyterhub
 
 Isso iniciará uma instância do Jupyter e o URL para acessá-lo será mostrado na janela da linha de comando.
 
-Uma vez que você acessa o URL, deve ver o esboço do curso e ser capaz de navegar para qualquer arquivo `*.ipynb` file. For example, `08-building-search-applications/python/oai-solution.ipynb`.
+Uma vez que você acessa o URL, deve ver o esboço do curso e ser capaz de navegar para qualquer arquivo `*.ipynb`. Por Exemplo, `08-building-search-applications/python/oai-solution.ipynb`.
 
-### Running in a container
+### Executando em um contêiner
 
-An alternative to setting everything up on your computer or Codespace is to use a [container](https://en.wikipedia.org/wiki/Containerization_(computing)?WT.mc_id=academic-105485-koreyst). The special `.devcontainer` folder within the course repository makes it possible for VS Code to set up the project within a container. Outside of Codespaces, this will require the installation of Docker, and quite frankly, it involves a bit of work, so we recommend this only to those with experience working with containers.
+Uma alternativa à configuração de tudo no seu computador ou no Codespace é usar um [contêiner](https://en.wikipedia.org/wiki/Containerization_(computing)?WT.mc_id=academic-105485-koreyst). A pasta especial `.devcontainer` dentro do repositório do curso permite que o VS Code configure o projeto dentro de um contêiner. Fora do Codespaces, isso exigirá a instalação do Docker e, francamente, envolve um pouco de trabalho, por isso recomendamos isso apenas para aqueles com experiência em trabalhar com contêineres.
 
-One of the best ways to keep your API keys secure when using GitHub Codespaces is by using Codespace Secrets. Please follow the [Codespaces secrets management](https://docs.github.com/en/codespaces/managing-your-codespaces/managing-secrets-for-your-codespaces?WT.mc_id=academic-105485-koreyst) guide to learn more about this.
+Uma das melhores maneiras de manter suas chaves de API seguras ao usar o GitHub Codespaces é usar o Codespace Secrets. Siga o guia [Gerenciamento de segredos do Codespaces](https://docs.github.com/en/codespaces/managing-your-codespaces/managing-secrets-for-your-codespaces?WT.mc_id=academic-105485-koreyst) para saber mais sobre isso.
 
-## Lessons and Technical Requirements
+## Lições e Requisitos Técnicos
 
-The course has 6 concept lessons and 6 coding lessons.
+O curso tem 6 lições conceituais e 6 lições de codificação.
 
-For the coding lessons, we are using the Azure OpenAI Service. You will need access to the Azure OpenAI service and an API key to run this code. You can apply to get access by [completing this application](https://azure.microsoft.com/products/ai-services/openai-service?WT.mc_id=academic-105485-koreyst).
+Para as lições de codificação, estamos usando o Serviço Azure OpenAI. Você precisará de acesso ao serviço Azure OpenAI e de uma chave de API para executar este código. Você pode solicitar acesso [preenchendo esta inscrição](https://azure.microsoft.com/products/ai-services/openai-service?WT.mc_id=academic-105485-koreyst).
 
-While you wait for your application to be processed, each coding lesson also includes a `README.md` onde pode visualizar o código e os resultados.
+Enquanto você aguarda o processamento da sua inscrição, cada lição de codificação também inclui um `README.md` onde você pode visualizar o código e os resultados.
 
 ## Usando o Serviço Azure OpenAI pela primeira vez
 
@@ -222,4 +222,4 @@ Este projeto adotou o [Código de Conduta de Código Aberto da Microsoft](https:
 Agora que você completou os passos necessários para completar este curso, vamos começar com uma [introdução à IA Generativa e LLMs](../01-introduction-to-genai/README.md?WT.mc_id=academic-105485-koreyst).
 
 **Aviso Legal**:  
-Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.
+Este documento foi traduzido usando o serviço de tradução por IA [Co-op Translator](https://github.com/Azure/co-op-translator). Embora nos esforcemos pela precisão, esteja ciente de que traduções automatizadas podem conter erros ou imprecisões. O documento original em seu idioma nativo deve ser considerado a fonte autorizada. Para informações críticas, recomenda-se a tradução profissional humana. Não nos responsabilizamos por quaisquer mal-entendidos ou interpretações equivocadas decorrentes do uso desta tradução.