* add exception for the scenario where the second step function call fails.

module/ai/control.php

@@ -518,10 +518,16 @@ class ai extends control
         if(empty($location)) return $this->send(array('result' => 'fail', 'message' => sprintf($this->lang->ai->execute->failFormat, $this->lang->ai->execute->failReasons['noTargetForm'])));
         if(!empty($stop))    return header("location: $location", true, 302);
 
-        $response = $this->ai->executePrompt($prompt, $object);
+        try
+        {
+            $response = $this->ai->executePrompt($prompt, $object);
+        }
+        catch(AIResponseException $e)
+        {
+            return $this->send(array('result' => 'fail', 'message' => sprintf($this->lang->ai->execute->failFormat, $e->getMessage())));
+        }
         if(is_int($response)) return $this->send(array('result' => 'fail', 'message' => sprintf($this->lang->ai->execute->failFormat, $this->lang->ai->execute->executeErrors["$response"]) . (empty($this->ai->errors) ? '' : implode(', ', $this->ai->errors))));
         if(empty($response))  return $this->send(array('result' => 'fail', 'message' => sprintf($this->lang->ai->execute->failFormat, $this->lang->ai->execute->failReasons['noResponse'])));
-
         $this->ai->setInjectData($prompt->targetForm, $response);
 
         $_SESSION['aiPrompt']['prompt']   = $prompt;

module/ai/lang/de.php

@@ -796,3 +796,6 @@ $lang->ai->audit->backLocationList[1] = 'back to audit page and regenerate.';
 
 $lang->ai->engineeredPrompts = new stdclass();
 $lang->ai->engineeredPrompts->askForFunctionCalling = array((object)array('role' => 'user', 'content' => 'Please convert my next message into a function call.'), (object)array('role' => 'assistant', 'content' => 'Sure, I\'ll convert your next message into a function call.'));
+
+$lang->ai->aiResponseException = array();
+$lang->ai->aiResponseException['notFunctionCalling'] = 'The response is not a function calling';

module/ai/lang/en.php

@@ -796,3 +796,6 @@ $lang->ai->audit->backLocationList[1] = 'back to audit page and regenerate.';
 
 $lang->ai->engineeredPrompts = new stdclass();
 $lang->ai->engineeredPrompts->askForFunctionCalling = array((object)array('role' => 'user', 'content' => 'Please convert my next message into a function call.'), (object)array('role' => 'assistant', 'content' => 'Sure, I\'ll convert your next message into a function call.'));
+
+$lang->ai->aiResponseException = array();
+$lang->ai->aiResponseException['notFunctionCalling'] = 'The response is not a function calling';

module/ai/lang/fr.php

@@ -796,3 +796,6 @@ $lang->ai->audit->backLocationList[1] = 'back to audit page and regenerate.';
 
 $lang->ai->engineeredPrompts = new stdclass();
 $lang->ai->engineeredPrompts->askForFunctionCalling = array((object)array('role' => 'user', 'content' => 'Please convert my next message into a function call.'), (object)array('role' => 'assistant', 'content' => 'Sure, I\'ll convert your next message into a function call.'));
+
+$lang->ai->aiResponseException = array();
+$lang->ai->aiResponseException['notFunctionCalling'] = 'The response is not a function calling';

module/ai/lang/zh-cn.php

@@ -797,3 +797,6 @@ $lang->ai->audit->backLocationList[1] = '返回调试页面并重新生成';
 
 $lang->ai->engineeredPrompts = new stdclass();
 $lang->ai->engineeredPrompts->askForFunctionCalling = array((object)array('role' => 'user', 'content' => '请把我所发的下一条消息内容转换为 function 调用。'), (object)array('role' => 'assistant', 'content' => '好的，我会把下一条消息转换为 function 调用。'));
+
+$lang->ai->aiResponseException = array();
+$lang->ai->aiResponseException['notFunctionCalling'] = 'AI 提词执行返回值结构不正确，请重试（可能可以通过优化提词来解决）';

module/ai/model.php

@@ -372,6 +372,7 @@ class aiModel extends model
         {
             /* Extract function call arguments. */
             if(!empty($response->function_call)) return array($response->function_call->arguments);
+            throw new AIResponseException('notFunctionCalling', $response);
         }
         else
         {
@@ -530,6 +531,7 @@ class aiModel extends model
      * @param  array  $options   optional params, see https://platform.openai.com/docs/api-reference/chat/create
      * @access public
      * @return mixed  false if error, array of JSON object if success
+     * @throws AIResponseException
      */
     public function converseTwiceForJSON($messages, $schema, $options = array())
     {
@@ -1033,6 +1035,7 @@ class aiModel extends model
      * @param  int|object    $object    object (or id) to execute prompt on.
      * @access public
      * @return string|int    returns either JSON string or negative integer on error.
+     * @throws AIResponseException
      */
     public function executePrompt($prompt, $object)
     {
@@ -1728,3 +1731,43 @@ class aiModel extends model
         return true;
     }
 }
+
+/**
+ * Exception class for response from AI.
+ */
+class AIResponseException extends Exception
+{
+    /**
+     * Type of response error, error messages are defined in lang files with type as key.
+     *
+     * See `$lang->ai->aiResponseException`.
+     *
+     * @var    string
+     * @access public
+     */
+    public $type;
+
+    /**
+     * Response with error.
+     *
+     * @var    string|object
+     * @access public
+     */
+    public $response;
+
+    /**
+     * Create a AIResponseException, load error message from lang file.
+     *
+     * @param  string        $type
+     * @param  string|object $response
+     * @access public
+     * @return void
+     */
+    public function __construct($type, $response)
+    {
+        global $app;
+        $this->type     = $type;
+        $this->response = $response;
+        $this->message  = zget($app->lang->ai->aiResponseException, $type, '');
+    }
+}