Function calling on Azure.

Note that this only works with the right models. We're currently testing on
gpt-35-turbo-16k-0613.

Author: ccreutzi

azureChat.m

@@ -14,7 +14,7 @@
 %                             This parameter requires API version 2023-12-01-preview.
 %
 %   API Version             - A list of API versions to use for this operation.
-%                             Default value is 2023-05-15.
+%                             Default value is 2024-02-01.
 %
 %   Temperature             - Temperature value for controlling the randomness
 %                             of the output. Default value is 1.
@@ -207,7 +207,7 @@ function mustBeValidFunctionCall(this, functionCall)
                 if ~isempty(this.Tools)
                     toolChoice = "auto";
                 end
-            elseif ToolChoice ~= "auto"
+            elseif toolChoice ~= "auto"
                 % if toolChoice is not empty, then it must be in the format
                 % {"type": "function", "function": {"name": "my_function"}}
                 toolChoice = struct("type","function","function",struct("name",toolChoice));

tests/tazureChat.m

@@ -48,7 +48,7 @@ function seedFixesResult(testCase)
             testCase.verifyEqual(response1,response2);
         end
 
-        function createOpenAIChatWithStreamFunc(testCase)
+        function createAzureChatWithStreamFunc(testCase)
             testCase.assumeTrue(isenv("AZURE_OPENAI_API_KEY"),"end-to-end test requires environment variables AZURE_OPENAI_API_KEY, AZURE_OPENAI_ENDPOINT, and AZURE_OPENAI_DEPLOYMENT.");
             function seen = sf(str)
                 persistent data;
@@ -69,6 +69,27 @@ function createOpenAIChatWithStreamFunc(testCase)
             testCase.verifyGreaterThan(numel(sf("")), 1);
         end
 
+        function generateWithTools(testCase)
+            import matlab.unittest.constraints.HasField
+
+            f = openAIFunction("getCurrentWeather", "Get the current weather in a given location");
+            f = addParameter(f, "location", type="string", description="The city and country, optionally state. E.g., San Francisco, CA, USA");
+            f = addParameter(f, "unit", type="string", enum=["Kelvin","Celsius"], RequiredParameter=false);
+
+            chat = azureChat(getenv("AZURE_OPENAI_ENDPOINT"), getenv("AZURE_OPENAI_DEPLOYMENT"), ...
+                Tools=f);
+
+            prompt =  "What's the weather like in San Francisco, Tokyo, and Paris?";
+            [~, response] = generate(chat, prompt, ToolChoice="getCurrentWeather");
+
+            testCase.assertThat(response, HasField("tool_calls"));
+            testCase.assertEqual(response.tool_calls.type,'function');
+            testCase.assertEqual(response.tool_calls.function.name,'getCurrentWeather');
+            data = testCase.verifyWarningFree( ...
+                @() jsondecode(response.tool_calls.function.arguments));
+            testCase.verifyThat(data,HasField("location"));
+        end
+
         function errorsWhenPassingToolChoiceWithEmptyTools(testCase)
             chat = azureChat(getenv("AZURE_OPENAI_ENDPOINT"), getenv("AZURE_OPENAI_DEPLOYMENT"), APIKey="this-is-not-a-real-key");
             testCase.verifyError(@()generate(chat,"input", ToolChoice="bla"), "llms:mustSetFunctionsForCall");