チュートリアル: Azure OpenAI テキスト補完のヒントを Visual Studio Code の関数に追加する

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• Visual Studio Code のクイックスタートのパート 1 の手順を完了する。

• .NET Core CLI ツールをインストールします。

5.バインディング拡張機能を登録する

Azure OpenAI の出力バインドを使用しているため、このプロジェクトを実行する前に対応するバインド拡張機能をインストールしておく必要があります。

HTTP トリガーとタイマー トリガーを除き、バインドは拡張機能パッケージとして実装されます。 Azure OpenAI 拡張機能パッケージをプロジェクトに追加するには、[ターミナル] ウィンドウで次の dotnet add package コマンドを実行します。

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.OpenAI --prerelease

5.拡張機能バンドルを更新する

プレビューの Azure OpenAI バインドにアクセスするには、この拡張機能を含む拡張機能バンドルのプレビュー バージョンを使用する必要があります。

現在の host.json ファイルの extensionBundle 設定を次の JSON に置き換えます。

 "extensionBundle": {
   "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
   "version": "[4.*, 5.0.0)"
 }

1. 既存の HttpExample クラス ファイルに、次の using ステートメントを追加します。

   using Microsoft.Azure.Functions.Worker.Extensions.OpenAI.TextCompletion;
   

2. 同じファイルに、whois という名前の新しい HTTP トリガー エンドポイントを定義する次のコードを追加します。

   [Function(nameof(WhoIs))]
   public IActionResult WhoIs([HttpTrigger(AuthorizationLevel.Function, Route = "whois/{name}")] HttpRequest req,
   [TextCompletionInput("Who is {name}?", Model = "%CHAT_MODEL_DEPLOYMENT_NAME%")] TextCompletionResponse response)
   {
       if(!String.IsNullOrEmpty(response.Content))
       {
           return new OkObjectResult(response.Content);
       }
       else
       {
           return new NotFoundObjectResult("Something went wrong.");
       }
   }
   

1. pom.xml プロジェクト ファイルを更新して、この参照を properties コレクションに追加します。

   <azure-functions-java-library-openai>0.3.0-preview</azure-functions-java-library-openai>
   

2. 同じファイル内で、この依存関係を dependencies コレクションに追加します。

   <dependency>
       <groupId>com.microsoft.azure.functions</groupId>
       <artifactId>azure-functions-java-library-openai</artifactId>
       <version>${azure-functions-java-library-openai}</version>
   </dependency>
   

3. 既存の Function.java プロジェクト ファイルに、次の import ステートメントを追加します。

   import com.microsoft.azure.functions.openai.annotation.textcompletion.TextCompletion;
   import com.microsoft.azure.functions.openai.annotation.textcompletion.TextCompletionResponse;
   

4. 同じファイルに、whois という名前の新しい HTTP トリガー エンドポイントを定義する次のコードを追加します。

   @FunctionName("WhoIs")
   public HttpResponseMessage whoIs(
       @HttpTrigger(
           name = "req", 
           methods = {HttpMethod.GET},
           authLevel = AuthorizationLevel.ANONYMOUS, 
           route = "whois/{name}") 
           HttpRequestMessage<Optional<String>> request,
       @BindingName("name") String name,
       @TextCompletion(prompt = "Who is {name}?", model = "%CHAT_MODEL_DEPLOYMENT_NAME%", name = "response") TextCompletionResponse response,
       final ExecutionContext context) {
       return request.createResponseBuilder(HttpStatus.OK)
           .header("Content-Type", "application/json")
           .body(response.getContent())
           .build();
   }
   

1. Visual Studio Code で F1 キーを押し、コマンド パレットで「Azure Functions: Create Function...」と入力し、[HTTP トリガー] を選択し、関数名 (whois) を入力して Enter キーを押します。

2. 新しい whois.js コード ファイルで、ファイルの内容を次のコードに置き換えます。

   const { app, input } = require("@azure/functions");
   
   // This OpenAI completion input requires a {name} binding value.
   const openAICompletionInput = input.generic({
       prompt: 'Who is {name}?',
       maxTokens: '100',
       type: 'textCompletion',
       model: '%CHAT_MODEL_DEPLOYMENT_NAME%'
   })
   
   app.http('whois', {
       methods: ['GET'],
       route: 'whois/{name}',
       authLevel: 'function',
       extraInputs: [openAICompletionInput],
       handler: async (_request, context) => {
           var response = context.extraInputs.get(openAICompletionInput)
           return { body: response.content.trim() }
       }
   });
   

1. Visual Studio Code で F1 キーを押し、コマンド パレットで「Azure Functions: Create Function...」と入力し、[HTTP トリガー] を選択し、関数名 (whois) を入力して Enter キーを押します。

2. 新しい whois.ts コード ファイルで、ファイルの内容を次のコードに置き換えます。

   import { app, input } from "@azure/functions";
   
   // This OpenAI completion input requires a {name} binding value.
   const openAICompletionInput = input.generic({
       prompt: 'Who is {name}?',
       maxTokens: '100',
       type: 'textCompletion',
       model: '%CHAT_MODEL_DEPLOYMENT_NAME%'
   })
   
   app.http('whois', {
       methods: ['GET'],
       route: 'whois/{name}',
       authLevel: 'function',
       extraInputs: [openAICompletionInput],
       handler: async (_request, context) => {
           var response: any = context.extraInputs.get(openAICompletionInput)
           return { body: response.content.trim() }
       }
   });
   

1. 既存の function_app.py プロジェクト ファイルに、次の import ステートメントを追加します。

   import json
   

2. 同じファイルに、whois という名前の新しい HTTP トリガー エンドポイントを定義する次のコードを追加します。

   @app.route(route="whois/{name}", methods=["GET"])
   @app.text_completion_input(arg_name="response", prompt="Who is {name}?", max_tokens="100", model = "%CHAT_MODEL_DEPLOYMENT_NAME%")
   def whois(req: func.HttpRequest, response: str) -> func.HttpResponse:
       response_json = json.loads(response)
       return func.HttpResponse(response_json["content"], status_code=200)
   
   
   @app.route(route="genericcompletion", methods=["POST"])
   @app.text_completion_input(arg_name="response", prompt="{Prompt}", model = "%CHAT_MODEL_DEPLOYMENT_NAME%")
   def genericcompletion(req: func.HttpRequest, response: str) -> func.HttpResponse:
       response_json = json.loads(response)
       return func.HttpResponse(response_json["content"], status_code=200)
   

1. Visual Studio Code で F1 キーを押し、コマンド パレットに「Azure Functions: Create Function...」と入力し、[HTTP トリガー] を選択し、関数名 (whois) を入力し、[匿名] を選択して Enter キーを押します。

2. 新しい whois/function.json コード ファイルを開き、その内容を次のコードに置き換えます。これにより、TextCompletionResponse 入力バインドの定義が追加されます。

   {
     "bindings": [
       {
         "authLevel": "function",
         "type": "httpTrigger",
         "direction": "in",
         "name": "Request",
         "route": "whois/{name}",
         "methods": [
           "get"
         ]
       },
       {
         "type": "http",
         "direction": "out",
         "name": "Response"
       },
       {
         "type": "textCompletion",
         "direction": "in",
         "name": "TextCompletionResponse",
         "prompt": "Who is {name}?",
         "maxTokens": "100",
         "model": "%CHAT_MODEL_DEPLOYMENT_NAME%"
       }
     ]
   }
   

3. whois/run.ps1 コード ファイルの内容を次のコードに置き換えます。このコードは、入力バインド応答を返します。

   using namespace System.Net
   
   param($Request, $TriggerMetadata, $TextCompletionResponse)
   
   Push-OutputBinding -Name Response -Value ([HttpResponseContext]@{
           StatusCode = [HttpStatusCode]::OK
           Body       = $TextCompletionResponse.Content
       })