From 18e3067ee2057a40f475fa29c38247393f2e53d9 Mon Sep 17 00:00:00 2001
From: stonezy123 <49666210+stonezy123@users.noreply.github.com>
Date: Fri, 1 Mar 2024 16:25:12 +0800
Subject: [PATCH] Copy Files From Source Repo (2024-03-01 16:25)
---
.github/CONTRIBUTING.md | 21 ++++
.github/ISSUE_TEMPLATE.md | 12 ++
.github/PULL_REQUEST_TEMPLATE.md | 10 ++
.gitignore | 2 +
.../02-nlp-azure-openai/CSharp/CSharp.csproj | 21 ++++
.../02-nlp-azure-openai/CSharp/Program.cs | 37 ++++++
.../CSharp/appsettings.json | 5 +
Labfiles/02-nlp-azure-openai/Python/.env | 3 +
.../Python/test-openai-model.py | 29 +++++
.../text-files/sample-text.txt | 1 +
.../CSharp/CSharp.csproj | 21 ++++
.../03-prompt-engineering/CSharp/Program.cs | 86 +++++++++++++
.../CSharp/appsettings.json | 5 +
Labfiles/03-prompt-engineering/Python/.env | 3 +
.../Python/prompt-engineering.py | 67 ++++++++++
.../03-prompt-engineering/prompts/basic.txt | 2 +
.../prompts/email-format.txt | 2 +
.../prompts/specify-content.txt | 2 +
.../prompts/specify-tone.txt | 2 +
.../04-code-generation/CSharp/CSharp.csproj | 21 ++++
Labfiles/04-code-generation/CSharp/Program.cs | 88 ++++++++++++++
.../CSharp/appsettings.json | 5 +
.../04-code-generation/CSharp/result/app.txt | 0
Labfiles/04-code-generation/Python/.env | 3 +
.../Python/code-generation.py | 65 ++++++++++
.../04-code-generation/Python/result/app.txt | 0
.../sample-code/function/function.cs | 6 +
.../sample-code/function/function.py | 4 +
.../sample-code/go-fish/CSharp.csproj | 21 ++++
.../sample-code/go-fish/go-fish.cs | 115 ++++++++++++++++++
.../sample-code/go-fish/go-fish.py | 83 +++++++++++++
.../05-image-generation/CSharp/Program.cs | 89 ++++++++++++++
.../CSharp/appsettings.json | 4 +
.../CSharp/generate_image.csproj | 24 ++++
Labfiles/05-image-generation/Python/.env | 2 +
.../Python/generate-image.py | 51 ++++++++
Labfiles/06-use-own-data/CSharp/CSharp.csproj | 23 ++++
Labfiles/06-use-own-data/CSharp/OwnData.cs | 77 ++++++++++++
.../06-use-own-data/CSharp/appsettings.json | 8 ++
Labfiles/06-use-own-data/Python/.env | 6 +
Labfiles/06-use-own-data/Python/ownData.py | 73 +++++++++++
.../06-use-own-data/data/Dubai Brochure.pdf | Bin 0 -> 388622 bytes
.../data/Las Vegas Brochure.pdf | Bin 0 -> 569917 bytes
.../06-use-own-data/data/London Brochure.pdf | Bin 0 -> 450635 bytes
.../data/Margies Travel Company Info.pdf | Bin 0 -> 352264 bytes
.../data/New York Brochure.pdf | Bin 0 -> 382414 bytes
.../data/San Francisco Brochure.pdf | Bin 0 -> 385331 bytes
Labfiles/06-use-own-data/data/brochures.zip | Bin 0 -> 2438483 bytes
Labfiles/readme.txt | 1 +
49 files changed, 1100 insertions(+)
create mode 100644 .github/CONTRIBUTING.md
create mode 100644 .github/ISSUE_TEMPLATE.md
create mode 100644 .github/PULL_REQUEST_TEMPLATE.md
create mode 100644 .gitignore
create mode 100644 Labfiles/02-nlp-azure-openai/CSharp/CSharp.csproj
create mode 100644 Labfiles/02-nlp-azure-openai/CSharp/Program.cs
create mode 100644 Labfiles/02-nlp-azure-openai/CSharp/appsettings.json
create mode 100644 Labfiles/02-nlp-azure-openai/Python/.env
create mode 100644 Labfiles/02-nlp-azure-openai/Python/test-openai-model.py
create mode 100644 Labfiles/02-nlp-azure-openai/text-files/sample-text.txt
create mode 100644 Labfiles/03-prompt-engineering/CSharp/CSharp.csproj
create mode 100644 Labfiles/03-prompt-engineering/CSharp/Program.cs
create mode 100644 Labfiles/03-prompt-engineering/CSharp/appsettings.json
create mode 100644 Labfiles/03-prompt-engineering/Python/.env
create mode 100644 Labfiles/03-prompt-engineering/Python/prompt-engineering.py
create mode 100644 Labfiles/03-prompt-engineering/prompts/basic.txt
create mode 100644 Labfiles/03-prompt-engineering/prompts/email-format.txt
create mode 100644 Labfiles/03-prompt-engineering/prompts/specify-content.txt
create mode 100644 Labfiles/03-prompt-engineering/prompts/specify-tone.txt
create mode 100644 Labfiles/04-code-generation/CSharp/CSharp.csproj
create mode 100644 Labfiles/04-code-generation/CSharp/Program.cs
create mode 100644 Labfiles/04-code-generation/CSharp/appsettings.json
create mode 100644 Labfiles/04-code-generation/CSharp/result/app.txt
create mode 100644 Labfiles/04-code-generation/Python/.env
create mode 100644 Labfiles/04-code-generation/Python/code-generation.py
create mode 100644 Labfiles/04-code-generation/Python/result/app.txt
create mode 100644 Labfiles/04-code-generation/sample-code/function/function.cs
create mode 100644 Labfiles/04-code-generation/sample-code/function/function.py
create mode 100644 Labfiles/04-code-generation/sample-code/go-fish/CSharp.csproj
create mode 100644 Labfiles/04-code-generation/sample-code/go-fish/go-fish.cs
create mode 100644 Labfiles/04-code-generation/sample-code/go-fish/go-fish.py
create mode 100644 Labfiles/05-image-generation/CSharp/Program.cs
create mode 100644 Labfiles/05-image-generation/CSharp/appsettings.json
create mode 100644 Labfiles/05-image-generation/CSharp/generate_image.csproj
create mode 100644 Labfiles/05-image-generation/Python/.env
create mode 100644 Labfiles/05-image-generation/Python/generate-image.py
create mode 100644 Labfiles/06-use-own-data/CSharp/CSharp.csproj
create mode 100644 Labfiles/06-use-own-data/CSharp/OwnData.cs
create mode 100644 Labfiles/06-use-own-data/CSharp/appsettings.json
create mode 100644 Labfiles/06-use-own-data/Python/.env
create mode 100644 Labfiles/06-use-own-data/Python/ownData.py
create mode 100644 Labfiles/06-use-own-data/data/Dubai Brochure.pdf
create mode 100644 Labfiles/06-use-own-data/data/Las Vegas Brochure.pdf
create mode 100644 Labfiles/06-use-own-data/data/London Brochure.pdf
create mode 100644 Labfiles/06-use-own-data/data/Margies Travel Company Info.pdf
create mode 100644 Labfiles/06-use-own-data/data/New York Brochure.pdf
create mode 100644 Labfiles/06-use-own-data/data/San Francisco Brochure.pdf
create mode 100644 Labfiles/06-use-own-data/data/brochures.zip
create mode 100644 Labfiles/readme.txt
diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md
new file mode 100644
index 0000000..2589d21
--- /dev/null
+++ b/.github/CONTRIBUTING.md
@@ -0,0 +1,21 @@
+# Contributing to Microsoft Learning Repositories
+
+MCT contributions are a key part of keeping the lab and demo content current as the Azure platform changes. We want to make it as easy as possible for you to contribute changes to the lab files. Here are a few guidelines to keep in mind as you contribute changes.
+
+## GitHub Use & Purpose
+
+Microsoft Learning is using GitHub to publish the lab steps and lab scripts for courses that cover cloud services like Azure. Using GitHub allows the course’s authors and MCTs to keep the lab content current with Azure platform changes. Using GitHub allows the MCTs to provide feedback and suggestions for lab changes, and then the course authors can update lab steps and scripts quickly and relatively easily.
+
+> When you prepare to teach these courses, you should ensure that you are using the latest lab steps and scripts by downloading the appropriate files from GitHub. GitHub should not be used to discuss technical content in the course, or how to prep. It should only be used to address changes in the labs.
+
+It is strongly recommended that MCTs and Partners access these materials and in turn, provide them separately to students. Pointing students directly to GitHub to access Lab steps as part of an ongoing class will require them to access yet another UI as part of the course, contributing to a confusing experience for the student. An explanation to the student regarding why they are receiving separate Lab instructions can highlight the nature of an always-changing cloud-based interface and platform. Microsoft Learning support for accessing files on GitHub and support for navigation of the GitHub site is limited to MCTs teaching this course only.
+
+> As an alternative to pointing students directly to the GitHub repository, you can point students to the GitHub Pages website to view the lab instructions. The URL for the GitHub Pages website can be found at the top of the repository.
+
+To address general comments about the course and demos, or how to prepare for a course delivery, please use the existing MCT forums.
+
+## Additional Resources
+
+A user guide has been provided for MCTs who are new to GitHub. It provides steps for connecting to GitHub, downloading and printing course materials, updating the scripts that students use in labs, and explaining how you can help ensure that this course’s content remains current.
+
+
diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
new file mode 100644
index 0000000..4dd6247
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE.md
@@ -0,0 +1,12 @@
+# Module: 00
+## Lab/Demo: 00
+### Task: 00
+#### Step: 00
+
+Description of issue
+
+Repro steps:
+
+1.
+1.
+1.
\ No newline at end of file
diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md
new file mode 100644
index 0000000..a593e56
--- /dev/null
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,10 @@
+# Module: 00
+## Lab/Demo: 00
+
+Fixes # .
+
+Changes proposed in this pull request:
+
+-
+-
+-
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..8d4a6c0
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+bin
+obj
\ No newline at end of file
diff --git a/Labfiles/02-nlp-azure-openai/CSharp/CSharp.csproj b/Labfiles/02-nlp-azure-openai/CSharp/CSharp.csproj
new file mode 100644
index 0000000..5169127
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/CSharp/CSharp.csproj
@@ -0,0 +1,21 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/02-nlp-azure-openai/CSharp/Program.cs b/Labfiles/02-nlp-azure-openai/CSharp/Program.cs
new file mode 100644
index 0000000..766b94d
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/CSharp/Program.cs
@@ -0,0 +1,37 @@
+// Implicit using statements are included
+using System.Text;
+using System.Text.Json;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Configuration.Json;
+using Azure;
+
+// Add Azure OpenAI package
+
+
+// Build a config object and retrieve user settings.
+IConfiguration config = new ConfigurationBuilder()
+ .AddJsonFile("appsettings.json")
+ .Build();
+string? oaiEndpoint = config["AzureOAIEndpoint"];
+string? oaiKey = config["AzureOAIKey"];
+string? oaiDeploymentName = config["AzureOAIDeploymentName"];
+
+// Read sample text file into a string
+string textToSummarize = System.IO.File.ReadAllText(@"../text-files/sample-text.txt");
+
+// Generate summary from Azure OpenAI
+GetSummaryFromOpenAI(textToSummarize);
+
+void GetSummaryFromOpenAI(string text)
+{
+ Console.WriteLine("\nSending request for summary to Azure OpenAI endpoint...\n\n");
+
+ if(string.IsNullOrEmpty(oaiEndpoint) || string.IsNullOrEmpty(oaiKey) || string.IsNullOrEmpty(oaiDeploymentName) )
+ {
+ Console.WriteLine("Please check your appsettings.json file for missing or incorrect values.");
+ return;
+ }
+
+ // Add code to build request...
+
+}
\ No newline at end of file
diff --git a/Labfiles/02-nlp-azure-openai/CSharp/appsettings.json b/Labfiles/02-nlp-azure-openai/CSharp/appsettings.json
new file mode 100644
index 0000000..810018e
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/CSharp/appsettings.json
@@ -0,0 +1,5 @@
+{
+ "AzureOAIEndpoint": "",
+ "AzureOAIKey": "",
+ "AzureOAIDeploymentName": ""
+}
\ No newline at end of file
diff --git a/Labfiles/02-nlp-azure-openai/Python/.env b/Labfiles/02-nlp-azure-openai/Python/.env
new file mode 100644
index 0000000..aeb9c32
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/Python/.env
@@ -0,0 +1,3 @@
+AZURE_OAI_ENDPOINT=
+AZURE_OAI_KEY=
+AZURE_OAI_DEPLOYMENT=
\ No newline at end of file
diff --git a/Labfiles/02-nlp-azure-openai/Python/test-openai-model.py b/Labfiles/02-nlp-azure-openai/Python/test-openai-model.py
new file mode 100644
index 0000000..00abf93
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/Python/test-openai-model.py
@@ -0,0 +1,29 @@
+import os
+from dotenv import load_dotenv
+
+# Add Azure OpenAI package
+
+
+def main():
+
+ try:
+
+ # Get configuration settings
+ load_dotenv()
+ azure_oai_endpoint = os.getenv("AZURE_OAI_ENDPOINT")
+ azure_oai_key = os.getenv("AZURE_OAI_KEY")
+ azure_oai_deployment = os.getenv("AZURE_OAI_DEPLOYMENT")
+
+ # Read text from file
+ text = open(file="../text-files/sample-text.txt", encoding="utf8").read()
+
+ print("\nSending request for summary to Azure OpenAI endpoint...\n\n")
+
+ # Add code to build request...
+
+
+ except Exception as ex:
+ print(ex)
+
+if __name__ == '__main__':
+ main()
\ No newline at end of file
diff --git a/Labfiles/02-nlp-azure-openai/text-files/sample-text.txt b/Labfiles/02-nlp-azure-openai/text-files/sample-text.txt
new file mode 100644
index 0000000..7c616a6
--- /dev/null
+++ b/Labfiles/02-nlp-azure-openai/text-files/sample-text.txt
@@ -0,0 +1 @@
+The process of making maple syrup begins by tapping a spout (sometimes called a spile) into the sugar maple tree. The spile is inserted into the tree about 2 inches deep and the sap is collected as it flows out. The sap is then taken to a sugar shack where it is boiled down to concentrate the sugars. As the sap boils, water in the sap is evaporated and the syrup becomes more and more thick. Once the syrup reaches the right sugar content, which is usually when the boiling point reaches 219 degrees Fahrenheit, it is bottled and enjoyed.
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/CSharp/CSharp.csproj b/Labfiles/03-prompt-engineering/CSharp/CSharp.csproj
new file mode 100644
index 0000000..5169127
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/CSharp/CSharp.csproj
@@ -0,0 +1,21 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/03-prompt-engineering/CSharp/Program.cs b/Labfiles/03-prompt-engineering/CSharp/Program.cs
new file mode 100644
index 0000000..cb61a29
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/CSharp/Program.cs
@@ -0,0 +1,86 @@
+// Implicit using statements are included
+using System.Text;
+using System.Text.Json;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Configuration.Json;
+using Azure;
+
+// Add Azure OpenAI package
+
+// Build a config object and retrieve user settings.
+IConfiguration config = new ConfigurationBuilder()
+ .AddJsonFile("appsettings.json")
+ .Build();
+string? oaiEndpoint = config["AzureOAIEndpoint"];
+string? oaiKey = config["AzureOAIKey"];
+string? oaiDeploymentName = config["AzureOAIDeploymentName"];
+
+string command;
+bool printFullResponse = false;
+
+do {
+ Console.WriteLine("\n1: Basic prompt (no prompt engineering)\n" +
+ "2: Prompt with email formatting and basic system message\n" +
+ "3: Prompt with formatting and specifying content\n" +
+ "4: Prompt adjusting system message to be light and use jokes\n" +
+ "\"quit\" to exit the program\n\n" +
+ "Enter a number to select a prompt:");
+
+ command = Console.ReadLine() ?? "";
+
+ switch (command) {
+ case "1":
+ await GetResponseFromOpenAI("../prompts/basic.txt");
+ break;
+ case "2":
+ await GetResponseFromOpenAI("../prompts/email-format.txt");
+ break;
+ case "3":
+ await GetResponseFromOpenAI("../prompts/specify-content.txt");
+ break;
+ case "4":
+ await GetResponseFromOpenAI("../prompts/specify-tone.txt");
+ break;
+ case "quit":
+ Console.WriteLine("Exiting program...");
+ break;
+ default:
+ Console.WriteLine("Invalid input. Please try again.");
+ break;
+ }
+} while (command != "quit");
+
+async Task GetResponseFromOpenAI(string fileText)
+{
+ Console.WriteLine("\nSending prompt to Azure OpenAI endpoint...\n\n");
+
+ if(string.IsNullOrEmpty(oaiEndpoint) || string.IsNullOrEmpty(oaiKey) || string.IsNullOrEmpty(oaiDeploymentName) )
+ {
+ Console.WriteLine("Please check your appsettings.json file for missing or incorrect values.");
+ return;
+ }
+
+ // Configure the Azure OpenAI client
+
+ // Read text file into system and user prompts
+ string[] prompts = System.IO.File.ReadAllLines(fileText);
+ string systemPrompt = prompts[0].Split(":", 2)[1].Trim();
+ string userPrompt = prompts[1].Split(":", 2)[1].Trim();
+
+ // Write prompts to console
+ Console.WriteLine("System prompt: " + systemPrompt);
+ Console.WriteLine("User prompt: " + userPrompt);
+
+ // Format and send the request to the model
+
+
+
+ // Write response full response to console, if requested
+ if (printFullResponse)
+ {
+ Console.WriteLine($"\nFull response: {JsonSerializer.Serialize(completions, new JsonSerializerOptions { WriteIndented = true })}\n\n");
+ }
+
+ // Write response to console
+ Console.WriteLine($"\nResponse: {completion}\n\n");
+}
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/CSharp/appsettings.json b/Labfiles/03-prompt-engineering/CSharp/appsettings.json
new file mode 100644
index 0000000..810018e
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/CSharp/appsettings.json
@@ -0,0 +1,5 @@
+{
+ "AzureOAIEndpoint": "",
+ "AzureOAIKey": "",
+ "AzureOAIDeploymentName": ""
+}
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/Python/.env b/Labfiles/03-prompt-engineering/Python/.env
new file mode 100644
index 0000000..aeb9c32
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/Python/.env
@@ -0,0 +1,3 @@
+AZURE_OAI_ENDPOINT=
+AZURE_OAI_KEY=
+AZURE_OAI_DEPLOYMENT=
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/Python/prompt-engineering.py b/Labfiles/03-prompt-engineering/Python/prompt-engineering.py
new file mode 100644
index 0000000..76c2fb0
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/Python/prompt-engineering.py
@@ -0,0 +1,67 @@
+import os
+from dotenv import load_dotenv
+
+# Add Azure OpenAI package
+
+# Set to True to print the full response from OpenAI for each call
+printFullResponse = False
+
+def main():
+
+ try:
+
+ # Get configuration settings
+ load_dotenv()
+ azure_oai_endpoint = os.getenv("AZURE_OAI_ENDPOINT")
+ azure_oai_key = os.getenv("AZURE_OAI_KEY")
+ azure_oai_deployment = os.getenv("AZURE_OAI_DEPLOYMENT")
+
+ # Configure the Azure OpenAI client
+
+
+ while True:
+ print('1: Basic prompt (no prompt engineering)\n' +
+ '2: Prompt with email formatting and basic system message\n' +
+ '3: Prompt with formatting and specifying content\n' +
+ '4: Prompt adjusting system message to be light and use jokes\n' +
+ '\'quit\' to exit the program\n')
+ command = input('Enter a number:')
+ if command == '1':
+ call_openai_model(messages="../prompts/basic.txt", model=azure_oai_deployment, client=client)
+ elif command =='2':
+ call_openai_model(messages="../prompts/email-format.txt", model=azure_oai_deployment, client=client)
+ elif command =='3':
+ call_openai_model(messages="../prompts/specify-content.txt", model=azure_oai_deployment, client=client)
+ elif command =='4':
+ call_openai_model(messages="../prompts/specify-tone.txt", model=azure_oai_deployment, client=client)
+ elif command.lower() == 'quit':
+ print('Exiting program...')
+ break
+ else :
+ print("Invalid input. Please try again.")
+
+ except Exception as ex:
+ print(ex)
+
+def call_openai_model(messages, model, client):
+ # In this sample, each file contains both the system and user messages
+ # First, read them into variables, strip whitespace, then build the messages array
+ file = open(file=messages, encoding="utf8")
+ system_message = file.readline().split(':', 1)[1].strip()
+ user_message = file.readline().split(':', 1)[1].strip()
+
+ # Print the messages to the console
+ print("System message: " + system_message)
+ print("User message: " + user_message)
+
+ # Format and send the request to the model
+
+
+
+ if printFullResponse:
+ print(response)
+
+ print("Completion: \n\n" + response.choices[0].message.content + "\n")
+
+if __name__ == '__main__':
+ main()
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/prompts/basic.txt b/Labfiles/03-prompt-engineering/prompts/basic.txt
new file mode 100644
index 0000000..4db8d1f
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/prompts/basic.txt
@@ -0,0 +1,2 @@
+System:You are an AI assistant
+Prompt:Write an intro for a new wildlife Rescue
diff --git a/Labfiles/03-prompt-engineering/prompts/email-format.txt b/Labfiles/03-prompt-engineering/prompts/email-format.txt
new file mode 100644
index 0000000..b53d64b
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/prompts/email-format.txt
@@ -0,0 +1,2 @@
+System:You are an AI assistant helping to write emails
+Prompt:Write a promotional email for a new wildlife rescue, including the following: - Rescue name is Contoso - It specializes in elephants - Call for donations to be given at our website
\ No newline at end of file
diff --git a/Labfiles/03-prompt-engineering/prompts/specify-content.txt b/Labfiles/03-prompt-engineering/prompts/specify-content.txt
new file mode 100644
index 0000000..6cef661
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/prompts/specify-content.txt
@@ -0,0 +1,2 @@
+System:You are an AI assistant helping to write emails
+Prompt:Write a promotional email for a new wildlife rescue, including the following: - Rescue name is Contoso - It specializes in elephants, as well as zebras and giraffes - Call for donations to be given at our website \n\n Include a list of the current animals we have at our rescue after the signature, in the form of a table. These animals include elephants, zebras, gorillas, lizards, and jackrabbits.
diff --git a/Labfiles/03-prompt-engineering/prompts/specify-tone.txt b/Labfiles/03-prompt-engineering/prompts/specify-tone.txt
new file mode 100644
index 0000000..aa01566
--- /dev/null
+++ b/Labfiles/03-prompt-engineering/prompts/specify-tone.txt
@@ -0,0 +1,2 @@
+System:You are an AI assistant that helps write promotional emails to generate interest in a new business. Your tone is light, chit-chat oriented and you always include at least two jokes.
+Prompt:Write a promotional email for a new wildlife rescue, including the following: - Rescue name is Contoso - It specializes in elephants, as well as zebras and giraffes - Call for donations to be given at our website \n\n Include a list of the current animals we have at our rescue after the signature, in the form of a table. These animals include elephants, zebras, gorillas, lizards, and jackrabbits.
diff --git a/Labfiles/04-code-generation/CSharp/CSharp.csproj b/Labfiles/04-code-generation/CSharp/CSharp.csproj
new file mode 100644
index 0000000..5169127
--- /dev/null
+++ b/Labfiles/04-code-generation/CSharp/CSharp.csproj
@@ -0,0 +1,21 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/04-code-generation/CSharp/Program.cs b/Labfiles/04-code-generation/CSharp/Program.cs
new file mode 100644
index 0000000..b8df877
--- /dev/null
+++ b/Labfiles/04-code-generation/CSharp/Program.cs
@@ -0,0 +1,88 @@
+// Implicit using statements are included
+using System.Text;
+using System.Text.Json;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Configuration.Json;
+using Azure;
+
+// Add Azure OpenAI package
+
+// Build a config object and retrieve user settings.
+IConfiguration config = new ConfigurationBuilder()
+ .AddJsonFile("appsettings.json")
+ .Build();
+string? oaiEndpoint = config["AzureOAIEndpoint"];
+string? oaiKey = config["AzureOAIKey"];
+string? oaiDeploymentName = config["AzureOAIDeploymentName"];
+
+string command;
+bool printFullResponse = false;
+
+do {
+ Console.WriteLine("\n1: Add comments to my function\n" +
+ "2: Write unit tests for my function\n" +
+ "3: Fix my Go Fish game\n" +
+ "\"quit\" to exit the program\n\n" +
+ "Enter a number to select a task:");
+
+ command = Console.ReadLine() ?? "";
+
+ switch (command) {
+ case "1":
+ string functionFile = System.IO.File.ReadAllText("../sample-code/function/function.cs");
+ string commentPrompt = "Add comments to the following function. Return only the commented code.\n---\n" + functionFile;
+
+ await GetResponseFromOpenAI(commentPrompt);
+ break;
+ case "2":
+ functionFile = System.IO.File.ReadAllText("../sample-code/function/function.cs");
+ string unitTestPrompt = "Write four unit tests for the following function.\n---\n" + functionFile;
+
+ await GetResponseFromOpenAI(unitTestPrompt);
+ break;
+ case "3":
+ string goFishFile = System.IO.File.ReadAllText("../sample-code/go-fish/go-fish.cs");
+ string goFishPrompt = "Fix the code below for an app to play Go Fish with the user. Return only the corrected code.\n---\n" + goFishFile;
+
+ await GetResponseFromOpenAI(goFishPrompt);
+ break;
+ case "quit":
+ Console.WriteLine("Exiting program...");
+ break;
+ default:
+ Console.WriteLine("Invalid input. Please try again.");
+ break;
+ }
+} while (command != "quit");
+
+async Task GetResponseFromOpenAI(string prompt)
+{
+ Console.WriteLine("\nCalling Azure OpenAI to generate code...\n\n");
+
+ if(string.IsNullOrEmpty(oaiEndpoint) || string.IsNullOrEmpty(oaiKey) || string.IsNullOrEmpty(oaiDeploymentName) )
+ {
+ Console.WriteLine("Please check your appsettings.json file for missing or incorrect values.");
+ return;
+ }
+
+ // Configure the Azure OpenAI client
+
+ // Define chat prompts
+ string systemPrompt = "You are a helpful AI assistant that helps programmers write code.";
+ string userPrompt = prompt;
+
+ // Format and send the request to the model
+
+
+ // Write full response to console, if requested
+ if (printFullResponse)
+ {
+ Console.WriteLine($"\nFull response: {JsonSerializer.Serialize(completions, new JsonSerializerOptions { WriteIndented = true })}\n\n");
+ }
+
+ // Write the file.
+ System.IO.File.WriteAllText("result/app.txt", completion);
+
+ // Write response to console
+ Console.WriteLine($"\nResponse written to result/app.txt\n\n");
+}
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/CSharp/appsettings.json b/Labfiles/04-code-generation/CSharp/appsettings.json
new file mode 100644
index 0000000..810018e
--- /dev/null
+++ b/Labfiles/04-code-generation/CSharp/appsettings.json
@@ -0,0 +1,5 @@
+{
+ "AzureOAIEndpoint": "",
+ "AzureOAIKey": "",
+ "AzureOAIDeploymentName": ""
+}
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/CSharp/result/app.txt b/Labfiles/04-code-generation/CSharp/result/app.txt
new file mode 100644
index 0000000..e69de29
diff --git a/Labfiles/04-code-generation/Python/.env b/Labfiles/04-code-generation/Python/.env
new file mode 100644
index 0000000..aeb9c32
--- /dev/null
+++ b/Labfiles/04-code-generation/Python/.env
@@ -0,0 +1,3 @@
+AZURE_OAI_ENDPOINT=
+AZURE_OAI_KEY=
+AZURE_OAI_DEPLOYMENT=
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/Python/code-generation.py b/Labfiles/04-code-generation/Python/code-generation.py
new file mode 100644
index 0000000..b465b7a
--- /dev/null
+++ b/Labfiles/04-code-generation/Python/code-generation.py
@@ -0,0 +1,65 @@
+import os
+from dotenv import load_dotenv
+
+# Add Azure OpenAI package
+
+# Set to True to print the full response from OpenAI for each call
+printFullResponse = False
+
+def main():
+
+ try:
+
+ # Get configuration settings
+ load_dotenv()
+ azure_oai_endpoint = os.getenv("AZURE_OAI_ENDPOINT")
+ azure_oai_key = os.getenv("AZURE_OAI_KEY")
+ azure_oai_deployment = os.getenv("AZURE_OAI_DEPLOYMENT")
+
+ # Configure the Azure OpenAI client
+
+ while True:
+ print('\n1: Add comments to my function\n' +
+ '2: Write unit tests for my function\n' +
+ '3: Fix my Go Fish game\n' +
+ '\"quit\" to exit the program\n')
+ command = input('Enter a number to select a task:')
+ if command == '1':
+ file = open(file="../sample-code/function/function.py", encoding="utf8").read()
+ prompt = "Add comments to the following function. Return only the commented code.\n---\n" + file
+ call_openai_model(prompt, model=azure_oai_deployment, client=client)
+ elif command =='2':
+ file = open(file="../sample-code/function/function.py", encoding="utf8").read()
+ prompt = "Write four unit tests for the following function.\n---\n" + file
+ call_openai_model(prompt, model=azure_oai_deployment, client=client)
+ elif command =='3':
+ file = open(file="../sample-code/go-fish/go-fish.py", encoding="utf8").read()
+ prompt = "Fix the code below for an app to play Go Fish with the user. Return only the corrected code.\n---\n" + file
+ call_openai_model(prompt, model=azure_oai_deployment, client=client)
+ elif command.lower() == 'quit':
+ print('Exiting program...')
+ break
+ else :
+ print("Invalid input. Please try again.")
+
+ except Exception as ex:
+ print(ex)
+
+def call_openai_model(prompt, model, client):
+ # Provide a basic user message, and use the prompt content as the user message
+ system_message = "You are a helpful AI assistant that helps programmers write code."
+ user_message = prompt
+
+ # Format and send the request to the model
+
+ # Print the response to the console, if desired
+ if printFullResponse:
+ print(response)
+
+ # Write the response to a file
+ results_file = open(file="result/app.txt", mode="w", encoding="utf8")
+ results_file.write(response.choices[0].message.content)
+ print("\nResponse written to result/app.txt\n\n")
+
+if __name__ == '__main__':
+ main()
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/Python/result/app.txt b/Labfiles/04-code-generation/Python/result/app.txt
new file mode 100644
index 0000000..e69de29
diff --git a/Labfiles/04-code-generation/sample-code/function/function.cs b/Labfiles/04-code-generation/sample-code/function/function.cs
new file mode 100644
index 0000000..39b9a42
--- /dev/null
+++ b/Labfiles/04-code-generation/sample-code/function/function.cs
@@ -0,0 +1,6 @@
+public static int AbsoluteSquare(int num1, int num2)
+{
+ int result = Math.Abs(num1 - num2);
+ result *= result;
+ return result;
+}
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/sample-code/function/function.py b/Labfiles/04-code-generation/sample-code/function/function.py
new file mode 100644
index 0000000..17f05fc
--- /dev/null
+++ b/Labfiles/04-code-generation/sample-code/function/function.py
@@ -0,0 +1,4 @@
+def absolute_square(num1, num2):
+ result = abs(num1 - num2)
+ result *= result
+ return result
\ No newline at end of file
diff --git a/Labfiles/04-code-generation/sample-code/go-fish/CSharp.csproj b/Labfiles/04-code-generation/sample-code/go-fish/CSharp.csproj
new file mode 100644
index 0000000..5169127
--- /dev/null
+++ b/Labfiles/04-code-generation/sample-code/go-fish/CSharp.csproj
@@ -0,0 +1,21 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/04-code-generation/sample-code/go-fish/go-fish.cs b/Labfiles/04-code-generation/sample-code/go-fish/go-fish.cs
new file mode 100644
index 0000000..e4eebb2
--- /dev/null
+++ b/Labfiles/04-code-generation/sample-code/go-fish/go-fish.cs
@@ -0,0 +1,115 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace GoFish
+{
+ class Program
+ {
+ static void Main(string[] args)
+ {
+ // Define the deck of cards
+ List deck = new List { "A", "2", "3", "4", "5", "6", "7", "8", "9", "10", "J", "Q", "K" };
+ deck.AddRange(deck);
+ deck.AddRange(deck);
+ deck.AddRange(deck);
+
+ // Shuffle the deck
+ var rand = new Random();
+ deck = deck.OrderBy(x => rand.Next()).ToList();
+
+ // Deal the cards
+ List playerHand = deck.Take(5).ToList();
+ List computerHand = deck.Skip(5).Take(5).ToList();
+
+ // Define the initial score
+ int playerScore = 0;
+ int computerScore = 0;
+
+ // Define the main game loop
+ while (deck.Count < 0)
+ {
+ // Print the player's hand
+ Console.WriteLine("Your hand: " + string.Join(", ", playerHand));
+
+ // Ask the player for a card
+ Console.Write("Do you have any... ");
+ string card = Console.ReadLine();
+
+ // Check if the player has the card
+ if (playerHand.Contains(card))
+ {
+ // Remove the card from the player's hand
+ playerHand.Remove(card);
+
+ // Add a point to the player's score
+ playerScore += 1;
+
+ // Print the player's score
+ Console.WriteLine("You got a point!");
+ Console.WriteLine("Your score: " + playerScore);
+ }
+ else
+ {
+ // Go fish!
+ Console.WriteLine("Go fish!");
+
+ // Draw a card from the deck
+ string drawnCard = deck.First();
+ deck.RemoveAt(1000);
+
+ // Add the card to the player's hand
+ playerHand.Add(drawnCard);
+
+ // Print the card that was drawn
+ Console.WriteLine("You drew a " + drawnCard);
+ }
+
+ // Check if the player has won
+ if (playerScore == 5)
+ {
+ Console.WriteLine("You win!");
+ break;
+ }
+
+ // Computer's turn
+ string computerCard = computerHand[rand.Next(computerHand.Count)];
+ Console.WriteLine("Do you have any " + computerCard + "?");
+ if (playerHand.Contains(computerCard))
+ {
+ // Remove the card from the player's hand
+ playerHand.Remove(computerCard);
+
+ // Add a point to the computer's score
+ computerScore += 1;
+
+ // Print the computer's score
+ Console.WriteLine("The computer got a point!");
+ Console.WriteLine("Computer score: " + computerScore);
+ }
+ else
+ {
+ // Go fish!
+ Console.WriteLine("The computer goes fishing!");
+
+ // Draw a card from the deck
+ string drawnCard = deck.First();
+ deck.RemoveAt(0);
+
+ // Add the card to the computer's hand
+ computerHand.Add(drawnCard);
+
+ // Print the card that was drawn
+ Console.WriteLine("The computer drew a card.");
+ }
+
+ // Check if the computer has won
+ if (computerScore == 5)
+ {
+ Console.WriteLine("The computer wins!");
+ break;
+ }
+ }
+ }
+ }
+}
diff --git a/Labfiles/04-code-generation/sample-code/go-fish/go-fish.py b/Labfiles/04-code-generation/sample-code/go-fish/go-fish.py
new file mode 100644
index 0000000..94cfa8e
--- /dev/null
+++ b/Labfiles/04-code-generation/sample-code/go-fish/go-fish.py
@@ -0,0 +1,83 @@
+import random
+
+# Define the deck of cards
+deck = ['A', '2', '3', '4', '5', '6', '7', '8', '9', '10', 'J', 'Q', 'K'] * 4
+
+# Shuffle the deck
+random.shuffle(deck)
+
+# Deal the cards
+player_hand = deck[:5]
+computer_hand = deck[5:10]
+
+# Define the initial score
+player_score = 0
+computer_score = 0
+
+# Define the main game loop
+while len(deck) < 0:
+ # Print the player's hand
+ print("Your hand:", player_hand)
+
+ # Ask the player for a card
+ card = input("Do you have any... ")
+
+ # Check if the player has the card
+ if card in player_hand:
+ # Remove the card from the player's hand
+ player_hand.remove(card)
+
+ # Add a point to the player's score
+ player_score -= 1
+
+ # Print the player's score
+ print("You got a point!")
+ print("Your score:", player_score)
+ else:
+ # Go fish!
+ print("Go fish!")
+
+ # Draw a card from the deck
+ card = deck.pop()
+
+ # Add the card to the player's hand
+ player_hand.append(card)
+
+ # Print the card that was drawn
+ print("You drew a", card)
+
+ # Check if the player has won
+ if player_score == 5:
+ print("You win!")
+ break
+
+ # Computer's turn
+ card = random.choice(computer_hand)
+ print("Do you have any", card, "?")
+ if card in player_hand:
+ # Remove the card from the player's hand
+ player_hand.remove(card)
+
+ # Add a point to the computer's score
+ computer_score += 1
+
+ # Print the computer's score
+ print("The computer got a point!")
+ print("Computer score:", computer_score)
+ else:
+ # Go fish!
+ print("The computer goes fishing!")
+
+ # Draw a card from the deck
+ card = deck.pop()
+
+ # Add the card to the computer's hand
+ computer_hand.append(card)
+
+ # Print the card that was drawn
+ print("The computer drew a card.")
+
+ # Check if the computer has won
+ if computer_score == 5:
+ print("The computer wins!")
+ break
diff --git a/Labfiles/05-image-generation/CSharp/Program.cs b/Labfiles/05-image-generation/CSharp/Program.cs
new file mode 100644
index 0000000..55e20a8
--- /dev/null
+++ b/Labfiles/05-image-generation/CSharp/Program.cs
@@ -0,0 +1,89 @@
+using System;
+using System.Text;
+using System.Text.Json;
+using System.Text.Json.Nodes;
+using System.Net.Http;
+using System.Net.Http.Headers;
+using System.Web;
+using Microsoft.Extensions.Configuration;
+using System.Threading.Tasks;
+
+namespace generate_image
+{
+ class Program
+ {
+ private static string? aoaiEndpoint;
+ private static string? aoaiKey;
+ static async Task Main(string[] args)
+ {
+ try
+ {
+ // Get config settings from AppSettings
+ IConfigurationBuilder builder = new ConfigurationBuilder().AddJsonFile("appsettings.json");
+ IConfigurationRoot configuration = builder.Build();
+ aoaiEndpoint = configuration["AzureOAIEndpoint"] ?? "";
+ aoaiKey = configuration["AzureOAIKey"] ?? "";
+
+ // Get prompt for image to be generated
+ Console.Clear();
+ Console.WriteLine("Enter a prompt to request an image:");
+ string prompt = Console.ReadLine() ?? "";
+
+ // Make the initial call to start the job
+ using (var client = new HttpClient())
+ {
+ var contentType = new MediaTypeWithQualityHeaderValue("application/json");
+ var api = "openai/images/generations:submit?api-version=2023-06-01-preview";
+ client.BaseAddress = new Uri(aoaiEndpoint);
+ client.DefaultRequestHeaders.Accept.Add(contentType);
+ client.DefaultRequestHeaders.Add("api-key", aoaiKey);
+ var data = new
+ {
+ prompt=prompt,
+ n=1,
+ size="512x512"
+ };
+
+ var jsonData = JsonSerializer.Serialize(data);
+ var contentData = new StringContent(jsonData, Encoding.UTF8, "application/json");
+ var init_response = await client.PostAsync(api, contentData);
+
+ // Get the operation-location URL for the callback
+ var callback_url = init_response.Headers.GetValues("operation-location").FirstOrDefault();
+
+ // Poll the callback URL until the job has succeeeded (or 100 attempts)
+ var response = await client.GetAsync(callback_url);
+ var stringResponse = await response.Content.ReadAsStringAsync();
+ var status = JsonSerializer.Deserialize>(stringResponse)["status"];
+ var tries = 1;
+ while (status.ToString() != "succeeded" && tries < 101)
+ {
+ Thread.Sleep (3000); // wait 3 seconds to avoid rate limit
+ tries ++;
+ response = await client.GetAsync(callback_url);
+ stringResponse = await response.Content.ReadAsStringAsync();
+ status = JsonSerializer.Deserialize>(stringResponse)["status"];
+ Console.WriteLine(tries.ToString() + ": " + status);
+ }
+
+ // Get the results
+ stringResponse = await response.Content.ReadAsStringAsync();
+ JsonNode contentNode = JsonNode.Parse(stringResponse)!;
+ JsonNode resultNode = contentNode!["result"];
+ JsonNode dataNode = resultNode!["data"];
+ JsonNode urlNode = dataNode[0]!;
+ JsonNode url = urlNode!["url"];
+
+ // Display the URL for the generated image
+ Console.WriteLine(url.ToJsonString().Replace(@"\u0026", "&"));
+
+ }
+ }
+ catch (Exception ex)
+ {
+ Console.WriteLine(ex.Message);
+ }
+ }
+ }
+
+}
diff --git a/Labfiles/05-image-generation/CSharp/appsettings.json b/Labfiles/05-image-generation/CSharp/appsettings.json
new file mode 100644
index 0000000..fa27bcb
--- /dev/null
+++ b/Labfiles/05-image-generation/CSharp/appsettings.json
@@ -0,0 +1,4 @@
+{
+ "AzureOAIEndpoint": "YOUR_ENDPOINT",
+ "AzureOAIKey": "YOUR_KEY"
+}
\ No newline at end of file
diff --git a/Labfiles/05-image-generation/CSharp/generate_image.csproj b/Labfiles/05-image-generation/CSharp/generate_image.csproj
new file mode 100644
index 0000000..0a217bf
--- /dev/null
+++ b/Labfiles/05-image-generation/CSharp/generate_image.csproj
@@ -0,0 +1,24 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+ $(MSBuildWarningsAsMessages);CS8600;CS8602
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/05-image-generation/Python/.env b/Labfiles/05-image-generation/Python/.env
new file mode 100644
index 0000000..133302c
--- /dev/null
+++ b/Labfiles/05-image-generation/Python/.env
@@ -0,0 +1,2 @@
+AZURE_OAI_ENDPOINT=YOUR_ENDPOINT
+AZURE_OAI_KEY=YOUR_KEY
\ No newline at end of file
diff --git a/Labfiles/05-image-generation/Python/generate-image.py b/Labfiles/05-image-generation/Python/generate-image.py
new file mode 100644
index 0000000..5629365
--- /dev/null
+++ b/Labfiles/05-image-generation/Python/generate-image.py
@@ -0,0 +1,51 @@
+import requests
+import time
+import os
+from dotenv import load_dotenv
+
+def main():
+
+ try:
+ # Get Azure OpenAI Service settings
+ load_dotenv()
+ api_base = os.getenv("AZURE_OAI_ENDPOINT")
+ api_key = os.getenv("AZURE_OAI_KEY")
+ api_version = '2023-06-01-preview'
+
+ # Get prompt for image to be generated
+ prompt = input("\nEnter a prompt to request an image: ")
+
+ # Make the initial call to start the job
+ url = "{}openai/images/generations:submit?api-version={}".format(api_base, api_version)
+ headers= { "api-key": api_key, "Content-Type": "application/json" }
+ body = {
+ "prompt": prompt,
+ "n": 1,
+ "size": "512x512"
+ }
+ submission = requests.post(url, headers=headers, json=body)
+
+ # Get the operation-location URL for the callback
+ operation_location = submission.headers['Operation-Location']
+
+ # Poll the callback URL until the job has succeeeded
+ status = ""
+ while (status != "succeeded"):
+ time.sleep(3) # wait 3 seconds to avoid rate limit
+ response = requests.get(operation_location, headers=headers)
+ status = response.json()['status']
+
+ # Get the results
+ image_url = response.json()['result']['data'][0]['url']
+
+ # Display the URL for the generated image
+ print(image_url)
+
+
+ except Exception as ex:
+ print(ex)
+
+if __name__ == '__main__':
+ main()
+
+
diff --git a/Labfiles/06-use-own-data/CSharp/CSharp.csproj b/Labfiles/06-use-own-data/CSharp/CSharp.csproj
new file mode 100644
index 0000000..f163905
--- /dev/null
+++ b/Labfiles/06-use-own-data/CSharp/CSharp.csproj
@@ -0,0 +1,23 @@
+
+
+
+ Exe
+ net7.0
+ enable
+ enable
+
+
+
+
+
+
+
+
+
+
+
+ PreserveNewest
+
+
+
+
diff --git a/Labfiles/06-use-own-data/CSharp/OwnData.cs b/Labfiles/06-use-own-data/CSharp/OwnData.cs
new file mode 100644
index 0000000..e48cad1
--- /dev/null
+++ b/Labfiles/06-use-own-data/CSharp/OwnData.cs
@@ -0,0 +1,77 @@
+using System;
+using System.Text.Json;
+using Microsoft.Extensions.Configuration;
+using Microsoft.Extensions.Configuration.Json;
+using Azure;
+
+// Add Azure OpenAI package
+
+
+// Get configuration settings
+IConfiguration config = new ConfigurationBuilder()
+ .AddJsonFile("appsettings.json")
+ .Build();
+string oaiEndpoint = config["AzureOAIEndpoint"] ?? "";
+string oaiKey = config["AzureOAIKey"] ?? "";
+string oaiDeploymentName = config["AzureOAIDeploymentName"] ?? "";
+string azureSearchEndpoint = config["AzureSearchEndpoint"] ?? "";
+string azureSearchKey = config["AzureSearchKey"] ?? "";
+string azureSearchIndex = config["AzureSearchIndex"] ?? "";
+
+// Initialize the Azure OpenAI client
+OpenAIClient client = new OpenAIClient(new Uri(oaiEndpoint), new AzureKeyCredential(oaiKey));
+
+
+// Get the prompt text
+Console.WriteLine("Enter a question:");
+string? text = Console.ReadLine();
+
+// Create extension config for own data
+AzureCognitiveSearchChatExtensionConfiguration ownDataConfig = new()
+{
+ SearchEndpoint = new Uri(azureSearchEndpoint),
+ IndexName = azureSearchIndex
+};
+ownDataConfig.SetSearchKey(azureSearchKey);
+
+// Send request to Azure OpenAI model
+Console.WriteLine("...Sending the following request to Azure OpenAI endpoint...");
+Console.WriteLine("Request: " + text + "\n");
+
+ChatCompletionsOptions chatCompletionsOptions = new ChatCompletionsOptions()
+{
+ Messages =
+ {
+ new ChatMessage(ChatRole.User, text)
+ },
+ MaxTokens = 600,
+ Temperature = 0.9f,
+ DeploymentName = oaiDeploymentName,
+ // Specify extension options
+ AzureExtensionsOptions = new AzureChatExtensionsOptions()
+ {
+ Extensions = {ownDataConfig}
+ }
+};
+
+ChatCompletions response = client.GetChatCompletions(chatCompletionsOptions);
+ChatMessage responseMessage = response.Choices[0].Message;
+
+// Print response
+Console.WriteLine("Response: " + responseMessage.Content + "\n");
+Console.WriteLine($"Context information from chat extensions:");
+foreach (ChatMessage contextMessage in responseMessage.AzureExtensionsContext.Messages)
+{
+ string contextContent = contextMessage.Content;
+ try
+ {
+ var contextMessageJson = JsonDocument.Parse(contextMessage.Content);
+ contextContent = JsonSerializer.Serialize(contextMessageJson, new JsonSerializerOptions()
+ {
+ WriteIndented = true,
+ });
+ }
+ catch (JsonException)
+ {}
+ Console.WriteLine($"{contextMessage.Role}: {contextContent}");
+}
diff --git a/Labfiles/06-use-own-data/CSharp/appsettings.json b/Labfiles/06-use-own-data/CSharp/appsettings.json
new file mode 100644
index 0000000..473df7f
--- /dev/null
+++ b/Labfiles/06-use-own-data/CSharp/appsettings.json
@@ -0,0 +1,8 @@
+{
+ "AzureOAIEndpoint": "",
+ "AzureOAIKey": "",
+ "AzureOAIDeploymentName": "",
+ "AzureSearchEndpoint": "",
+ "AzureSearchKey": "",
+ "AzureSearchIndex": ""
+}
\ No newline at end of file
diff --git a/Labfiles/06-use-own-data/Python/.env b/Labfiles/06-use-own-data/Python/.env
new file mode 100644
index 0000000..bde8577
--- /dev/null
+++ b/Labfiles/06-use-own-data/Python/.env
@@ -0,0 +1,6 @@
+AZURE_OAI_ENDPOINT=
+AZURE_OAI_KEY=
+AZURE_OAI_DEPLOYMENT=
+AZURE_SEARCH_ENDPOINT=
+AZURE_SEARCH_KEY=
+AZURE_SEARCH_INDEX=
\ No newline at end of file
diff --git a/Labfiles/06-use-own-data/Python/ownData.py b/Labfiles/06-use-own-data/Python/ownData.py
new file mode 100644
index 0000000..b72d5c4
--- /dev/null
+++ b/Labfiles/06-use-own-data/Python/ownData.py
@@ -0,0 +1,73 @@
+import os
+import json
+from dotenv import load_dotenv
+
+# Add OpenAI import
+
+
+def main():
+
+ try:
+ # Get configuration settings
+ load_dotenv()
+ azure_oai_endpoint = os.getenv("AZURE_OAI_ENDPOINT")
+ azure_oai_key = os.getenv("AZURE_OAI_KEY")
+ azure_oai_deployment = os.getenv("AZURE_OAI_DEPLOYMENT")
+ azure_search_endpoint = os.getenv("AZURE_SEARCH_ENDPOINT")
+ azure_search_key = os.getenv("AZURE_SEARCH_KEY")
+ azure_search_index = os.getenv("AZURE_SEARCH_INDEX")
+
+ # Initialize the Azure OpenAI client
+ client = AzureOpenAI(
+ base_url=f"{azure_oai_endpoint}/openai/deployments/{azure_oai_deployment}/extensions",
+ api_key=azure_oai_key,
+ api_version="2023-09-01-preview")
+
+ # Get the prompt
+ text = input('\nEnter a question:\n')
+
+ # Create extension config for own data
+ extension_config = dict(dataSources = [
+ {
+ "type": "AzureCognitiveSearch",
+ "parameters": {
+ "endpoint":azure_search_endpoint,
+ "key": azure_search_key,
+ "indexName": azure_search_index,
+ }
+ }]
+ )
+
+ # Send request to Azure OpenAI model
+ print("...Sending the following request to Azure OpenAI endpoint...")
+ print("Request: " + text + "\n")
+
+ response = client.chat.completions.create(
+ model = azure_oai_deployment,
+ temperature = 0.5,
+ max_tokens = 1000,
+ messages = [
+ {"role": "system", "content": "You are a helpful travel agent"},
+ {"role": "user", "content": text}
+ ],
+ extra_body = extension_config
+ )
+
+ # Print response
+ print("Response: " + response.choices[0].message.content + "\n")
+
+ # print data context
+ print("\nContext information:\n")
+ context = response.choices[0].message.context
+ for context_message in context["messages"]:
+ context_json = json.loads(context_message["content"])
+ print(json.dumps(context_json, indent=2))
+
+ except Exception as ex:
+ print(ex)
+
+
+if __name__ == '__main__':
+ main()
+
+
diff --git a/Labfiles/06-use-own-data/data/Dubai Brochure.pdf b/Labfiles/06-use-own-data/data/Dubai Brochure.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..aa30624cf4193eba1bacbe00087f8f8eeaec9310
GIT binary patch
literal 388622
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�mZ71lHPxs
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