Xikapi 接入文档

工具调用 ​

MiniMax 兼容 OpenAI 工具调用形态时，可以用于查询订单、搜索知识库、调用内部 API 和执行受控业务操作。

工具定义 ​

json
{
  "type": "function",
  "function": {
    "name": "get_order_status",
    "description": "Check order shipping status",
    "parameters": {
      "type": "object",
      "properties": {
        "order_id": {
          "type": "string",
          "description": "Order ID"
        }
      },
      "required": ["order_id"],
      "additionalProperties": false
    }
  }
}

调用流程 ​

  1. 请求中传入 tools
  2. 模型返回工具调用请求
  3. 服务端校验参数和权限
  4. 服务端执行真实函数
  5. 将工具结果返回模型生成最终回答

Agent 场景 ​

MiniMax 适合 Agent 工作流时，工具设计要保持清晰：

  • 一个工具只做一件事
  • 写操作必须确认
  • 返回结构化结果
  • 记录工具调用链路

最佳实践 ​

  • 工具执行必须在服务端
  • 所有参数都要做 schema 和业务校验
  • 写操作要二次确认
  • 工具结果只返回回答所需的信息