EN 中文
返回总览

LiteRtLm_CreateConversationWithConfig

带预设的高级会话创建。允许在初始化时注入系统提示词、多轮历史消息及工具 (Tools) 架构定义。

01. 预设注入流程

graph TD JSON[Json Preface String] -->|Parse| Parser[Internal JSON Parser] Parser -->|Apply| System[System Prompt] Parser -->|Fill| History[Messages History] Parser -->|Register| Tools[Function Tools Definition] subgraph State_Machine [会话初始状态机] System History Tools end State_Machine --> Result[void* Configured Conv Handle]
应用场景： 用于快速“复活”历史会话，或者在 NPC 初始化阶段注入其性格设定（System Prompt）和可调用的动作接口（Tools）。

02. 参数详细定义

void* LiteRtLm_CreateConversationWithConfig(
    void* engine_ptr, 
    const char* json_preface_str,
    int bEnableConstrainedDecoding
);
参数名称职责说明
json_preface_str JSON 格式的预设字符串。
包含 "messages" 数组和 "tools" 定义。必须符合 OpenAI API 格式标准的子集。
bEnableConstrainedDecoding 强制约束开关。
设为 1 时，引擎将根据 tools 定义自动启用 JSON 强约束，确保 AI 必须按格式输出工具调用。

03. JsonPreface 标准格式示例

{
  "messages": [
    {"role": "system", "content": "You are a helpful companion."},
    {"role": "user", "content": "Hello!"}
  ],
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_weather",
        "parameters": { "type": "object", "properties": {...} }
      }
    }
  ]
}