From 8c11b0734912ee44bb70a33d9d35ee1ccb695ca2 Mon Sep 17 00:00:00 2001
From: Luis Marcos Rivera <luis.m.r@outlook.com>
Date: Tue, 6 Feb 2024 10:37:49 +0100
Subject: [PATCH] Added translate prompt function

---
 CHANGELOG.md                                  |  2 ++
 Directory.Build.props                         |  2 +-
 .../Example.cs                                | 15 +++++++++++
 .../Program.cs                                |  2 ++
 ...nmarcha.SemanticKernel.Plugins.Text.csproj |  2 ++
 .../Plugins/TextPlugin/Translate/config.json  | 25 +++++++++++++++++
 .../Plugins/TextPlugin/Translate/skprompt.txt | 11 ++++++++
 .../PluginsInfo.cs                            | 27 +++++++++++++++++++
 8 files changed, 85 insertions(+), 1 deletion(-)
 create mode 100644 src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/config.json
 create mode 100644 src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/skprompt.txt

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b3dfb4e..a8ac562 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -22,6 +22,8 @@ Previous classification is not required if changes are simple or all belong to t
 - Added `Description` property in `VersionSwaggerGenOptions`.
 - New text prompt function for extract KeyPhrases with specified locale, `KeyPhrasesLocaled`.
 - Added an example of using `KeyPhrasesLocaled` in `Encamina.Enmarcha.Samples.SemanticKernel.Text`.
+- New text prompt function for translate texts, `Translate`.
+- Added an example of using `Translate` in `Encamina.Enmarcha.Samples.SemanticKernel.Text`.
 
 ## [8.1.2]
 
diff --git a/Directory.Build.props b/Directory.Build.props
index 4dbc238..bff6d70 100644
--- a/Directory.Build.props
+++ b/Directory.Build.props
@@ -17,7 +17,7 @@
 
   <PropertyGroup>
     <VersionPrefix>8.1.3</VersionPrefix>
-    <VersionSuffix>preview-02</VersionSuffix>
+    <VersionSuffix>preview-03</VersionSuffix>
   </PropertyGroup>
 
   <!--
diff --git a/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Example.cs b/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Example.cs
index da1dd8f..8002c23 100644
--- a/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Example.cs
+++ b/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Example.cs
@@ -65,4 +65,19 @@ public async Task TextKeyPhrasesLocaledAsync()
 
         Console.WriteLine($"# Key Phrases Localed: {result} \n");
     }
+
+    public async Task TextTranslateAsync()
+    {
+        var translateArguments = new KernelArguments()
+        {
+            [PluginsInfo.TextPlugin.Functions.Translate.Parameters.Input] = input,
+            [PluginsInfo.TextPlugin.Functions.Translate.Parameters.Locale] = "Spanish",
+        };
+
+        var functionTranslate = kernel.Plugins.GetFunction(PluginsInfo.TextPlugin.Name, PluginsInfo.TextPlugin.Functions.Translate.Name);
+
+        var result = await kernel.InvokeAsync<string>(functionTranslate, translateArguments);
+
+        Console.WriteLine($"# Translation: {result} \n");
+    }
 }
diff --git a/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Program.cs b/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Program.cs
index 3495286..8ddcfaf 100644
--- a/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Program.cs
+++ b/samples/SemanticKernel/Encamina.Enmarcha.Samples.SemanticKernel.Text/Program.cs
@@ -50,5 +50,7 @@ private static async Task Main(string[] _)
         await example.TextKeyPhrasesAsync();
 
         await example.TextKeyPhrasesLocaledAsync();
+
+        await example.TextTranslateAsync();
     }
 }
diff --git a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Encamina.Enmarcha.SemanticKernel.Plugins.Text.csproj b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Encamina.Enmarcha.SemanticKernel.Plugins.Text.csproj
index ee88920..5e14ce8 100644
--- a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Encamina.Enmarcha.SemanticKernel.Plugins.Text.csproj
+++ b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Encamina.Enmarcha.SemanticKernel.Plugins.Text.csproj
@@ -17,6 +17,8 @@
     <EmbeddedResource Include="Plugins\TextPlugin\KeyPhrases\skprompt.txt" />
     <EmbeddedResource Include="Plugins\TextPlugin\Summarize\config.json" />
     <EmbeddedResource Include="Plugins\TextPlugin\Summarize\skprompt.txt" />
+    <EmbeddedResource Include="Plugins\TextPlugin\Translate\config.json" />
+    <EmbeddedResource Include="Plugins\TextPlugin\Translate\skprompt.txt" />
   </ItemGroup>
 
   <ItemGroup>
diff --git a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/config.json b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/config.json
new file mode 100644
index 0000000..0f2fd50
--- /dev/null
+++ b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/config.json
@@ -0,0 +1,25 @@
+{
+  "schema": 1,
+  "description": "Translate a given input text",
+  "execution_settings": {
+    "default": {
+      "max_tokens": 2000,
+      "temperature": 0.1,
+      "top_p": 1.0,
+      "presence_penalty": 0.0,
+      "frequency_penalty": 0.0
+    }
+  },
+  "input_variables": [
+    {
+      "name": "input",
+      "description": "The input text to translate",
+      "is_required": true
+    },   
+    {
+      "name": "locale",
+      "description": "Language in which the translation will be generated",      
+      "is_required": true
+    }
+  ]
+}
diff --git a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/skprompt.txt b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/skprompt.txt
new file mode 100644
index 0000000..4d42bf2
--- /dev/null
+++ b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/Plugins/TextPlugin/Translate/skprompt.txt
@@ -0,0 +1,11 @@
+Your task is TO TRANSLATE the INPUT text into the '{{$locale}}' language.
+If the INPUT text is already in the '{{$locale}}' language, you must return the INPUT text without altering it.
+MAKE SURE YOU ONLY USE '{{$locale}}' language.
+
+
+[INPUT]
+
+{{$input}}
+
+[TRANSLATION]
+
diff --git a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/PluginsInfo.cs b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/PluginsInfo.cs
index 1bec734..0fbef6c 100644
--- a/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/PluginsInfo.cs
+++ b/src/Encamina.Enmarcha.SemanticKernel.Plugins.Text/PluginsInfo.cs
@@ -110,6 +110,33 @@ public static class Parameters
                     public static readonly string Locale = nameof(Locale).ToLowerInvariant();
                 }
             }
+
+            /// <summary>
+            /// Information about the «Translate» function.
+            /// </summary>
+            public static class Translate
+            {
+                /// <summary>
+                /// The name of the function.
+                /// </summary>
+                public static readonly string Name = nameof(Translate);
+
+                /// <summary>
+                /// Information about the function's parameters.
+                /// </summary>
+                public static class Parameters
+                {
+                    /// <summary>
+                    /// The name of the «input» parameter, which represents the text to translate.
+                    /// </summary>
+                    public static readonly string Input = nameof(Input).ToLowerInvariant();
+
+                    /// <summary>
+                    /// The name of the «locale» parameter, which represents the language in which the translation will be generated.
+                    /// </summary>
+                    public static readonly string Locale = nameof(Locale).ToLowerInvariant();
+                }
+            }
         }
     }
 }