非同期コード

リクエストをAPI に送信する際にOpenAPI のレスポンスを待ちたくない場合には、非同期コードを使用する必要があります。

非同期での呼び出しを行うためには、OpenAIParameters オブジェクト引数に結果を受け取るためのコールバック 4D.Function(Formula) を提供する必要があります。

コールバック関数は、同期コード内での関数によって返される結果のオブジェクト型(OpenAIResult 子クラスのうちのいずれか)と同じものを受け取ります。 以下の例を参照.

プロセスに関する注意

非同期メソッドは 4D.HTTPRequest に基づいているもので、レスポンスはカレントプロセス内で受信されます。

⚠️ もしカレントのメソッドの終わりでプロセスも終了する(例: New process を使用している、あるいはメソッドエディターでコードをテストしている)場合、コールバックフォーミュラは非同期に呼び出されない可能性があります。 そのような場合には、CALL WORKER あるいは CALL FORM の使用を検討して下さい。

使用例

モデルリスト

$client.models.list({formula: Formula(MyReceiveMethod($1))})

$1 はOpenAIModelListResult のインスタンスのため、MyReceiveMethod メソッドの内容は例えば以下のようになります:

#DECLARE($result: cs.AIKit.OpenAIModelListResult)

If($result.success)

   Form.models:=$result.models

Else

  Alert($result.errors.formula(Formula(JSON Stringify($1))).join("\n"))

End if

チャット補完

var $messages:=[{role: "system"; content: "You are a helpful assistant."}]
$messages.push({role: "user"; content: "Could you explain me why 42 is a special number"})

$client.chat.completions.create($messages; { onResponse: Formula(MyChatCompletionsReceiveMethod($1))})

$1 はOpenAIChatCompletionsResult のインスタンスのため、MyChatCompletionsReceiveMethod メソッドの内容は例えば以下のようになります:

#DECLARE($result: cs.AIKit.OpenAIChatCompletionsResult)

ASSERT($result.success) // ここでは onResponse を使用するため、成功した場合のみコールバックを受け取る
Form.assistantMessage:=$result.choices[0].text