initial samples

Author: KrzysztofCwalina

docs/examples/text-and-prompting/README.MD

@@ -0,0 +1,9 @@
+# OpenAI Documentation Examples for .NET
+
+## Running the Samples
+
+The samples use new .NET 10 feature which allows running single *.cs file applications. 
+Each of the files *.cs in this folder is a standalone application.
+To run them you need to install .NET 10 preview
+Then from the command line run them using `dotnet run <sample_name>`, e.g. `dotnet run s1-chat_simpleprompt.cs`
+

docs/examples/text-and-prompting/s1-chat_simpleprompt.cs

@@ -0,0 +1,10 @@
+// SAMPLE: Generate text from a simple prompt
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Chat; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+ChatClient client = new("gpt-4.1", key);
+ChatCompletion acompletion = client.CompleteChat("Write a one-sentence bedtime story about a unicorn.");
+Console.WriteLine(acompletion.Content[0].Text);

docs/examples/text-and-prompting/s2-responses_simpleprompt.cs

@@ -0,0 +1,10 @@
+// SAMPLE: Generate text from a simple prompt
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Responses; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+OpenAIResponseClient client = new("gpt-4.1", key);
+OpenAIResponse response = client.CreateResponse("Write a one-sentence bedtime story about a unicorn.");
+Console.WriteLine(response.GetOutputText());

docs/examples/text-and-prompting/s3-chat_instructions.cs

@@ -0,0 +1,13 @@
+// SAMPLE: Generate text with messages using different roles
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Chat; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+ChatClient client = new("gpt-4.1", key);
+ChatCompletion acompletion = client.CompleteChat([
+    ChatMessage.CreateDeveloperMessage("Talk like a pirate."),
+    ChatMessage.CreateUserMessage("Are semicolons optional in JavaScript?")
+]);
+Console.WriteLine(acompletion.Content[0].Text);

docs/examples/text-and-prompting/s4-responses_instructions.cs

@@ -0,0 +1,15 @@
+// SAMPLE: Generate text with instructions
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Responses; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+OpenAIResponseClient client = new("gpt-4.1", key);
+OpenAIResponse response = client.CreateResponse(
+    "Are semicolons optional in JavaScript?",
+    new() { Instructions = "Talk like a pirate." }
+);
+
+
+Console.WriteLine(response.GetOutputText());

docs/examples/text-and-prompting/s5-chat_roles.cs

@@ -0,0 +1,13 @@
+// SAMPLE: Generate text with messages using different roles
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Chat; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+ChatClient client = new("gpt-4.1", key);
+ChatCompletion acompletion = client.CompleteChat([
+    ChatMessage.CreateDeveloperMessage("Talk like a pirate."),
+    ChatMessage.CreateUserMessage("Are semicolons optional in JavaScript?")
+]);
+Console.WriteLine(acompletion.Content[0].Text);

docs/examples/text-and-prompting/s6-responses_roles.cs

@@ -0,0 +1,15 @@
+// SAMPLE: Generate text with messages using different roles
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Responses; 
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+OpenAIResponseClient client = new("gpt-4.1", key);
+OpenAIResponse response = client.CreateResponse([
+    ResponseItem.CreateDeveloperMessageItem("Talk like a pirate."),
+    ResponseItem.CreateUserMessageItem("Are semicolons optional in JavaScript?")
+]);
+
+
+Console.WriteLine(response.GetOutputText());

docs/examples/text-and-prompting/s7-responses_prompttemplate.cs

@@ -0,0 +1,24 @@
+// SAMPLE: Generate text with a prompt template
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Responses;
+using System.ClientModel;
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+OpenAIResponseClient client = new("gpt-4.1", key);
+OpenAIResponse response = (OpenAIResponse)client.CreateResponse(
+    BinaryContent.Create(BinaryData.FromObjectAsJson(
+    new {
+        model = "gpt-4.1",
+        prompt = new {
+            id = "pmpt_abc123",
+            version = "2",
+            variables = new {
+                customer_name = "Jane Doe",
+                product = "40oz juice box"
+            }
+        }
+    }
+)));
+Console.WriteLine(response.GetOutputText());

docs/examples/text-and-prompting/s8-responses_fileinput.cs

@@ -0,0 +1,32 @@
+// SAMPLE: Prompt template with file input variable
+#:package OpenAI@2.2.*-*
+#:property PublishAot=false
+
+using OpenAI.Responses;
+using OpenAI.Files;
+using System.ClientModel;
+
+string key = Environment.GetEnvironmentVariable("OPENAI_KEY")!;
+OpenAIResponseClient client = new("gpt-4.1", key);
+
+// Upload a PDF we will reference in the variables
+OpenAIFileClient files = new(key);
+OpenAIFile file = files.UploadFile("draconomicon.pdf", FileUploadPurpose.UserData);
+
+OpenAIResponse response = (OpenAIResponse)client.CreateResponse(
+    BinaryContent.Create(BinaryData.FromObjectAsJson(
+    new {
+        model = "gpt-4.1",
+        prompt = new {
+            id = "pmpt_abc123",
+            variables = new {
+                topic = "Dragons",
+                reference_pdf = new {
+                    type = "input_file",
+                    file_id = file.Id,
+                }
+            }
+        }
+    }
+)));
+Console.WriteLine(response.GetOutputText());