@@ -128,10 +128,10 @@ If you want to interact with Sforza, run the [Characters](/app/README.md) app.
4. Once it appears, select the "Open in Browser" button.
5. Chat with Sforza.
-For a more detailed explanation of the app, see [Detailed app explanation](../01-intro-to-genai/README.md#talk-to-dinocrates).
+For a more detailed explanation of the app, see [Detailed app explanation](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
- > If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
+ > If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](/docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
## What is prompt engineering?
@@ -306,7 +306,7 @@ Build an app that asks for:
Use the chain-of-though technique to arrive at a response.
-Here's a starter project [Starter project](./sample-app/).
+Here's a starter project [Starter project](/app/README.md).
## Solution
diff --git a/lessons/03-prompt-engineering/translations/README.pt-br.md b/lessons/03-prompt-engineering/translations/README.pt-br.md
index 043b4efd..33f46732 100644
--- a/lessons/03-prompt-engineering/translations/README.pt-br.md
+++ b/lessons/03-prompt-engineering/translations/README.pt-br.md
@@ -18,14 +18,14 @@ _Este vídeo oferece uma introdução para melhorar suas habilidades de "prompti
*🎥 Clique na imagem acima para assistir a um vídeo curto sobre engenharia de prompts*
-💼 Slides: [Engenharia de prompts](../../videos/slides/02-prompt-engineering.pptx)
+💼 Slides: [Engenharia de prompts](/videos/slides/02-prompt-engineering.pptx)
## Narrativa: Passagem para aventura
> [!NOTE]
> Até agora, você esteve em uma jornada através do tempo com Leonardo da Vinci, explorando as maravilhas do Renascimento. Você encontrou o Besouro do Tempo, um dispositivo misterioso que permite viajar através do tempo e do espaço.
>
-> Veja a [Lição 1](../01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
+> Veja a [Lição 1](/lessons/01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
> [!NOTE]
> Embora recomendemos seguir a história (é divertido!), [clique aqui](#interaja-com-sforza) se preferir ir direto para o conteúdo técnico.
@@ -35,7 +35,7 @@ _Este vídeo oferece uma introdução para melhorar suas habilidades de "prompti
Antes que você consiga pressionar o botão, as portas da oficina se abrem com um estrondo. Um homem está na entrada, de ombros largos e vestido com roupas caras, ele agita um pedaço de papel no ar, gritando:
*Ludovico Sforza*
@@ -65,7 +65,7 @@ Um turbilhão de cores envolve a carruagem, o mundo ao seu redor se dissolve em
O turbilhão de cores desaparece, e você se encontra na carruagem, agora correndo pela Via Appia em Roma e, para seu espanto, está no meio de uma corrida de cavalos. Bigas trovejam passando, suas rodas levantando nuvens de poeira.
**Você:** Leonardo, onde estamos?
@@ -105,7 +105,7 @@ Com um impulso final, o parafuso aéreo começa a girar. As lâminas pegam o ar,
Você olha para a cidade; os edifícios antigos se estendem abaixo de você.
## Interaja com Sforza
@@ -114,10 +114,10 @@ Se você quiser interagir com Sforza, execute o aplicativo [Characters](/app/REA
> [!IMPORTANT]
> Isso é inteiramente fictício; as respostas são geradas por IA.
-> [Aviso sobre IA Responsável](../../README.md#responsible-ai-disclaimer)
+> [Aviso sobre IA Responsável](/README.md#responsible-ai-disclaimer)
**Passos**:
@@ -128,10 +128,10 @@ Se você quiser interagir com Sforza, execute o aplicativo [Characters](/app/REA
4. Quando aparecer, selecione o botão "Open in Browser".
5. Converse com Sforza.
-Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](../01-intro-to-genai/README.md#talk-to-dinocrates).
+Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
- > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
+ > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](/docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
## O que é engenharia de prompts?
@@ -306,7 +306,7 @@ Construa um aplicativo que pergunte por:
Use a técnica de cadeia de pensamento para chegar a uma resposta.
-Aqui está um projeto inicial [Projeto inicial](./sample-app/).
+Aqui está um projeto inicial [Projeto inicial](/app/README.md).
## Solução
@@ -320,7 +320,7 @@ Construa um aplicativo em JavaScript que peça as seguintes entradas:
Em seguida, use o LLM para incorporar essas entradas e aproveitar a técnica de prompting de cadeia de pensamento para guiar o modelo até a resposta correta.
-[Solução](./solution/solution.md)
+[Solução](../solution/solution.md)
## Verificação de conhecimento
@@ -332,10 +332,10 @@ B. Engenharia de prompts é sobre elaborar os prompts certos para obter a saída
C. Engenharia de prompts é sobre treinar um modelo para reconhecer padrões em dados.
-[Solução do quiz](./solution/solution-quiz.md)
+[Solução do quiz](../solution/solution-quiz.md)
## Recursos para auto-estudo
- [Engenharia de prompts](https://en.wikipedia.org/wiki/Prompt_engineering)
- [Fundamentos de engenharia de prompts](https://github.com/microsoft/generative-ai-for-beginners/blob/main/04-prompt-engineering-fundamentals/README.md?WT.mc_id=academic-105485-koreyst)
-- [Engenharia de prompts avançada](https://github.com/microsoft/generative-ai-for-beginners/tree/main/05-advanced-prompts)
\ No newline at end of file
+- [Engenharia de prompts avançada](https://github.com/microsoft/generative-ai-for-beginners/tree/main/05-advanced-prompts)
diff --git a/lessons/04-structured-output/README.md b/lessons/04-structured-output/README.md
index ce816520..3ba1a21d 100644
--- a/lessons/04-structured-output/README.md
+++ b/lessons/04-structured-output/README.md
@@ -126,7 +126,7 @@ If you want to interact with Montezuma, run the [Characters](/app/README.md) app
> [!IMPORTANT]
> This is entirely fictional; the responses are generated by AI.
-> [Responsible AI disclaimer](../../README.md#responsible-ai-disclaimer)
+> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

@@ -140,10 +140,10 @@ If you want to interact with Montezuma, run the [Characters](/app/README.md) app
4. Once it appears, select the "Open in Browser" button.
5. Chat with Montezuma.
-For a more detailed explanation of the app, see [Detailed app explanation](../01-intro-to-genai/README.md#talk-to-dinocrates).
+For a more detailed explanation of the app, see [Detailed app explanation](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
- > If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
+ > If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](/docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
## Structured Output
@@ -528,7 +528,7 @@ This combination of presenting skills and parameters and extracting data from pr
**Instruction:** Write a prompt that asks for the boot sequence for the aerial screw, the text should be mirrored and encoded with a Caesar cipher with a shift of 3. Respond with the encoded text.
-See the [sample app](./sample-app) for code to get started with. It contains a Node.js project with all the dependencies you need.
+See the [sample app](/app/README.md) for code to get started with. It contains a Node.js project with all the dependencies you need.
> NOTE: If you haven't created a Codespace, please do so now as you will need it to get the AI communication in the sample app to work.
>
diff --git a/lessons/04-structured-output/translations/README.bn.md b/lessons/04-structured-output/translations/README.bn.md
index 8469e3d4..b08fdd81 100644
--- a/lessons/04-structured-output/translations/README.bn.md
+++ b/lessons/04-structured-output/translations/README.bn.md
@@ -576,7 +576,7 @@ parameters: cuisine, delivery_address, payment_method
- **উত্তরটি এনকোড করা পাঠ্য হিসেবে প্রদান করবে।**
### **রেফারেন্স:**
-[**নমুনা অ্যাপ**](/lessons/04-structured-output/sample-app) দেখো যেখানে একটি **Node.js প্রকল্প** রয়েছে, যাতে প্রয়োজনীয় সমস্ত ডিপেন্ডেন্সি আছে।
+[**নমুনা অ্যাপ**](/app/README.md) দেখো যেখানে একটি **Node.js প্রকল্প** রয়েছে, যাতে প্রয়োজনীয় সমস্ত ডিপেন্ডেন্সি আছে।
> [!NOTE]
> যদি তুমি এখনও **Codespace তৈরি না করে থাকো**, তাহলে এখনই করো, কারণ এটি **AI-এর সাথে যোগাযোগের জন্য প্রয়োজনীয়**।
diff --git a/lessons/04-structured-output/translations/README.pt-br.md b/lessons/04-structured-output/translations/README.pt-br.md
index 5ca21034..2493cefb 100644
--- a/lessons/04-structured-output/translations/README.pt-br.md
+++ b/lessons/04-structured-output/translations/README.pt-br.md
@@ -20,14 +20,14 @@ _Este vídeo oferece uma introdução para melhorar suas habilidades de "prompti
*🎥 Clique na imagem acima para assistir a um vídeo curto sobre engenharia de prompts*
-💼 Slides: [Engenharia de prompts](../../videos/slides/02-prompt-engineering.pptx)
+💼 Slides: [Engenharia de prompts](/videos/slides/02-prompt-engineering.pptx)
## Narrativa - Da frigideira para o fogo
> [!NOTE]
> _Nossa história até agora: Você, um engenheiro treinado em mecânica de 1860, tem estado em uma jornada através do tempo com Leonardo da Vinci. Você escapou dos soldados romanos — ou melhor, está em processo de escapar deles — e está desesperadamente procurando uma maneira de pousar o parafuso aéreo com segurança_.
>
-> Veja a [Lição 1](../01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
+> Veja a [Lição 1](/lessons/01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
> [!NOTE]
> Embora recomendemos seguir a história (é divertido!), [clique aqui](#interaja-com-montezuma) se preferir ir direto para o conteúdo técnico.
@@ -47,7 +47,7 @@ A luz brilhante do Besouro do Tempo desaparece, e você se vê parado na base de
O parafuso aéreo repousa desajeitadamente sobre uma grande pedra intrincadamente esculpida, com marcações que parecem um calendário
-

+
_Calendário asteca, Wikipedia_
@@ -59,7 +59,7 @@ Leonardo da Vinci avança, seus olhos arregalados de admiração.
Antes que você possa reagir, um grupo de soldados astecas se aproxima.
-

+
**Líder dos soldados:** "Quem são vocês e o que fizeram?" ele exige em Nahuatl.
@@ -83,7 +83,7 @@ Ao chegar ao topo da pirâmide, você é conduzido a uma grande câmara onde Mon
**Montezuma:** "Muito bem. Proponho um jogo de [Patolli](#patolli). Se eu vencer a melhor de três partidas, vocês me darão seu dispositivo e me dirão como ele funciona. Se vocês vencerem, estarão livres para ir."
-

+
O jogo começa, e a sala fica em silêncio, exceto pelo som de feijões sendo rolados e peças se movendo pelo tabuleiro.
@@ -115,7 +115,7 @@ Com um movimento final e decisivo, Leonardo vence o jogo. A sala explode em viva
> **Envolvimento Asteca**: Amplamente jogado por nobres e plebeus, era um favorito na corte de Montezuma. Além de diversão, envolvia apostas de alto risco com apostas como cobertores, pedras preciosas ou até mesmo a liberdade.
-

+
_Patolli - Wikipedia_
@@ -126,10 +126,10 @@ Se você quiser interagir com Montezuma, execute o aplicativo [Characters](/app/
> [!IMPORTANT]
> Isso é inteiramente fictício; as respostas são geradas por IA.
-> [Aviso sobre IA Responsável](../../README.md#responsible-ai-disclaimer)
+> [Aviso sobre IA Responsável](/README.md#responsible-ai-disclaimer)
-

+
**Passos**:
@@ -140,10 +140,10 @@ Se você quiser interagir com Montezuma, execute o aplicativo [Characters](/app/
4. Quando aparecer, selecione o botão "Open in Browser".
5. Converse com Montezuma.
-Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](../01-intro-to-genai/README.md#talk-to-dinocrates).
+Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
- > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
+ > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](/docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
## Saída Estruturada
@@ -528,7 +528,7 @@ Esta combinação de apresentar habilidades e parâmetros e extrair dados de pro
**Instrução:** Escreva um prompt que solicite a sequência de inicialização para o parafuso aéreo, o texto deve ser espelhado e codificado com uma cifra de César com um deslocamento de 3. Responda com o texto codificado.
-Veja o [aplicativo de exemplo](./sample-app) para começar com o código. Ele contém um projeto Node.js com todas as dependências necessárias.
+Veja o [aplicativo de exemplo](/app/README.md) para começar com o código. Ele contém um projeto Node.js com todas as dependências necessárias.
> NOTA: Se você ainda não criou um Codespace, faça isso agora, pois precisará dele para que a comunicação com IA no aplicativo de exemplo funcione.
>
@@ -536,7 +536,7 @@ Veja o [aplicativo de exemplo](./sample-app) para começar com o código. Ele co
## Solução
-[Solução](./solution/solution.md)
+[Solução](../solution/solution.md)
## Desafio
@@ -564,8 +564,8 @@ B. Extrair dados de prompts.
C. Gerar texto não estruturado.
-[Solução do quiz](./solution/solution-quiz.md)
+[Solução do quiz](../solution/solution-quiz.md)
## Recursos para auto-estudo
-- [Série de vídeos sobre IA Generativa com JavaScript](https://aka.ms/genai-js)
\ No newline at end of file
+- [Série de vídeos sobre IA Generativa com JavaScript](https://aka.ms/genai-js)
diff --git a/lessons/05-rag/README.md b/lessons/05-rag/README.md
index 980fffc1..ebe1bf2d 100644
--- a/lessons/05-rag/README.md
+++ b/lessons/05-rag/README.md
@@ -82,7 +82,7 @@ If you want to interact with Ada, run the [Characters](/app/README.md) app.
> [!IMPORTANT]
> This is entirely fictional; the responses are generated by AI.
-> [Responsible AI disclaimer](../../README.md#responsible-ai-disclaimer)
+> [Responsible AI disclaimer](/README.md#responsible-ai-disclaimer)

@@ -96,7 +96,7 @@ If you want to interact with Ada, run the [Characters](/app/README.md) app.
4. Once it appears, select the "Open in Browser" button.
5. Chat with Ada.
-For a more detailed explanation of the app, see [Detailed app explanation](../01-intro-to-genai/README.md#interact-with-dinocrates).
+For a more detailed explanation of the app, see [Detailed app explanation](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
> If you're running the project locally on your machine, please review the QuickStart guide to get a [GitHub personal access](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) token setup and replace the key in the code.
@@ -131,7 +131,7 @@ At its core, RAG involves two main components: a **retriever** and a **generator
Here's a schema illustrating how a RAG system works:
-
+
1. **User input:** The user asks a question.
2. **Retriever:** The retriever component searches for relevant information using one or more knowledge bases.
diff --git a/lessons/05-rag/translations/README.pt-br.md b/lessons/05-rag/translations/README.pt-br.md
index 0f53b5cd..17c7a7d6 100644
--- a/lessons/05-rag/translations/README.pt-br.md
+++ b/lessons/05-rag/translations/README.pt-br.md
@@ -18,14 +18,14 @@ _Este vídeo explica a Geração Aumentada por Recuperação (RAG), um método q
*🎥 Clique na imagem acima para assistir a um vídeo curto sobre geração aumentada por recuperação, RAG*
-💼 Slides: [Geração aumentada por recuperação, RAG](../../videos/slides/03-rag.pptx)
+💼 Slides: [Geração aumentada por recuperação, RAG](/videos/slides/03-rag.pptx)
## Narrativa - Gênesis
> [!NOTE]
> _Nossa história até agora. Você é um mecânico da Londres dos anos 1860. Você estava trabalhando em seu autômato e recebeu uma carta de Charles Babbage que acabou levando você a uma biblioteca onde você pegou um dispositivo de viagem no tempo. Durante suas viagens no tempo, você acabou em Florença, onde conheceu Leonardo Da Vinci. Você também foi ao império Asteca e é aqui que a história continua._
>
-> Veja a [Lição 1](../01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
+> Veja a [Lição 1](/lessons/01-intro-to-genai/README.md) se quiser acompanhar a história desde o início.
> [!NOTE]
> Embora recomendemos seguir a história (é divertido!), [clique aqui](#interaja-com-ada-lovelace) se preferir ir direto para o conteúdo técnico.
@@ -37,7 +37,7 @@ _Este vídeo explica a Geração Aumentada por Recuperação (RAG), um método q
Vocês pousam no jardim, é tarde da noite com uma névoa espessa e luzes sinistras piscando à distância. A mansão se ergue diante de vocês. Leonardo olha ao redor, seus olhos arregalados de admiração.
-

+
### Fugindo dos Cães
@@ -45,7 +45,7 @@ Vocês pousam no jardim, é tarde da noite com uma névoa espessa e luzes sinist
Você ouve latidos e o som de cães correndo em sua direção. Você se vira para Leonardo: "Precisamos entrar, agora!"
-

+
Quando você chega à porta da mansão, ela se abre e um par de atendentes sai apressadamente. Depois de avaliá-los, eles fazem sinal para que vocês os sigam.
@@ -63,7 +63,7 @@ Você se encontra cara a cara com Ada Lovelace, seus olhos brilhando de curiosid
**Você:** Mas...
-

+
Charles Babbage se aproxima, examinando o Besouro do Tempo em sua mão. "Este dispositivo é notável, mas está um pouco defeituoso, não está? Você deve ter notado, tenho certeza."
@@ -82,10 +82,10 @@ Se você quiser interagir com Ada, execute o aplicativo [Characters](/app/README
> [!IMPORTANT]
> Isso é inteiramente fictício; as respostas são geradas por IA.
-> [Aviso sobre IA Responsável](../../README.md#responsible-ai-disclaimer)
+> [Aviso sobre IA Responsável](/README.md#responsible-ai-disclaimer)
-

+
**Passos**:
@@ -96,10 +96,10 @@ Se você quiser interagir com Ada, execute o aplicativo [Characters](/app/README
4. Quando aparecer, selecione o botão "Open in Browser".
5. Converse com Ada.
-Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](../01-intro-to-genai/README.md#interact-with-dinocrates).
+Para uma explicação mais detalhada do aplicativo, consulte [Explicação detalhada do aplicativo](/lessons/01-intro-to-genai/README.md#interact-with-dinocrates).
> [!NOTE]
- > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](../../docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
+ > Se você estiver executando o projeto localmente em sua máquina, por favor revise o guia de Início Rápido para configurar um [token de acesso pessoal do GitHub](/docs/setup/README.md#creating-a-personal-access-token-pat-for-github-model-access) e substitua a chave no código.
## Desafios conhecidos com grandes modelos de linguagem, LLMs
@@ -131,7 +131,7 @@ Em sua essência, o RAG envolve dois componentes principais: um **recuperador**
Aqui está um esquema ilustrando como um sistema RAG funciona:
-
+
1. **Entrada do usuário:** O usuário faz uma pergunta.
2. **Recuperador:** O componente recuperador busca informações relevantes usando uma ou mais bases de conhecimento.
@@ -284,7 +284,7 @@ for await (const chunk of chunks) {
}
```
-Você pode encontrar este código no arquivo [`example/rag-cars.js`](./example/rag-cars.js) junto com o arquivo [`hybrid.csv`](./example/hybrid.csv) contendo os dados usados para a recuperação.
+Você pode encontrar este código no arquivo [`example/rag-cars.js`](../example/rag-cars.js) junto com o arquivo [`hybrid.csv`](../example/hybrid.csv) contendo os dados usados para a recuperação.
**Ada:** Uma vez que você execute este código, você deve ver os dados encontrados no arquivo CSV pelo recuperador, formatados como uma tabela markdown, seguidos pela resposta gerada pela IA para a pergunta. Tente mudar a pergunta para ver como os dados recuperados e a resposta mudam. Você também pode tentar fazer perguntas sobre tópicos não relacionados para ver como o modelo de IA lida com eles.
@@ -328,7 +328,7 @@ const text = Object.values(data.query.pages)[0]?.extract;
## Solução
-[Solução](./solution/rag-www.js)
+[Solução](../solution/rag-www.js)
## Verificação de conhecimento
@@ -340,7 +340,7 @@ B. O recuperador gera informações relevantes com base nos dados de treinamento
C. O recuperador encontra informações relevantes de fontes de dados externas.
-[Solução do quiz](./solution/solution-quiz.md)
+[Solução do quiz](../solution/solution-quiz.md)
## Recursos para auto-estudo
@@ -348,4 +348,4 @@ C. O recuperador encontra informações relevantes de fontes de dados externas.
- **Aplicativos de exemplo**:
* [Chat de IA Serverless com RAG](https://github.com/Azure-Samples/serverless-chat-langchainjs/)
* [Ask Youtube: Uma API de perguntas e respostas do Youtube baseada em RAG](https://github.com/Azure-Samples/langchainjs-quickstart-demo)
-- [Workshop completo: Crie seu próprio ChatGPT com RAG](https://moaw.dev/workshop/gh:azure-samples/azure-openai-rag-workshop/docs/workshop-qdrant.md)
\ No newline at end of file
+- [Workshop completo: Crie seu próprio ChatGPT com RAG](https://moaw.dev/workshop/gh:azure-samples/azure-openai-rag-workshop/docs/workshop-qdrant.md)