This project contains a web service that will accept HTTP GET requests at http://localhost:8080/ai/simple

There is optional message parameter whose default value is "Tell me a joke".

The response to the request is from the Azure OpenAI Service.

Before using the AI commands, obtain your Azure OpenAI endpoint and api-key from the Azure OpenAI Service section on Azure Portal

The Spring AI project defines a configuration property named spring.ai.azure.openai.api-key that you should set to the value of the API Key obtained from Azure.

Similarly, you need to set the endpoints name using the property spring.ai-azure.openai.endpoint.

Exporting an environment variables is one way to set these configuration properties.

export SPRING_AI_AZURE_OPENAI_API_KEY=<INSERT KEY HERE>
export SPRING_AI_AZURE_OPENAI_ENDPOINT=<INSERT ENDPOINT URL HERE>

Next you need to create an Azure AI Deployment and specify the deployent name as a configuration property.

Follow these steps to create an Azure AI Deployment via the Azure AI Portal so that you can use the default values in the Spring Boot Autoconfiguration

NOTE: In Azure, it's mandatory for each client to identify a Deployment Name for connecting to the Azure OpenAI service. Note that the Deployment Name is distinct from the actual model you intend to deploy. For example, a deployment called 'MyAiDeployment' might be set up to utilize the GPT 3.5 Turbo or the GPT 4.0 model.

For now, to create an easy setup, create a deployment in the Azure AI Portal with these parameters:

• Deployment Name: gpt-35-turbo
• Model Name: gpt-35-turbo

This configuration is compatible with the default settings of the Spring Boot Azure AI Starter and its auto-configuration capabilities.

export SPRING_AI_AZURE_OPENAI_CHAT_OPTIONS_DEPLOYMENT_NAME=<INSERT DEPLOYMENT NAME HERE>

The environment variables you defined before are referenced in the application.yml file that is in the ./src/main/resources directory.

spring:
  ai:
    azure:
      openai:
        api-key: <INSERT KEY HERE>
        endpoint: <INSERT ENDPOINT URL HERE>
        chat:
          options:
            deployment-name: <INSERT DEPLOYMENT NAME HERE>

./mvnw spring-boot:run

To get a response to the default request of "Tell me a joke"

http http://localhost:8080/ai/simple

A sample response is

Why don't scientists trust atoms?

Because they make up everything!

Now using the text request parameter

curl --get  --data-urlencode 'message=Tell me a joke about a cow.' http://localhost:8080/ai/simple 

A sample response is

Why did the cow go to outer space? To see the moooon!