ThinkAI插件调用指南

ThinkAI正式上线了插件调用功能的SDK支持，除了支持国内外主流大模型的统一调用外，可以在会话接口中调用插件工具增强大模型的能力，ThinkAI内置提供了包括联网查询、知识库及物流查询、天气、资讯等超过50个实用的插件工具，并且还会持续增加更多工具。 在日常的AI对话应用开发中，企业场景对回复内容的准确性和严谨性有较高要求，仅凭大模型本身的能力不足以实现精准的回复，很容易出现AI幻觉，通过插件工具可以规范和限制大模型的随意回复，这就是术业有专攻的道理。 [ThinkBot](https://bot.topthink.com/)作为一个开箱即用的企业智能体的快速构建引擎，正是依托于内置的丰富的插件工具能力和企业知识库的支持，现在ThinkAI的API调用也可以享受工具调用的能力及便利。 做过AI开发的都知道，各大模型厂商官方提供的工具有限，即使是OpenAI也是寥寥无几的几个内置工具。ThinkAI基于顶想云多年以来积累的一些API接口直接转化为内置工具，极大丰富了AI的常用插件和工具，另外还单独开发了一些原生的AI工具集。 我们使用ThinkAI进行AI应用开发并调用插件的步骤如下： ## 第一步：申请令牌 如果你是第一次使用ThinkAI的话，必须要先创建一个用于授权的令牌。可以进入ThinkAI的[控制台](https://console.topthink.com/ai/)点击菜单或者直接[去这里](https://console.topthink.com/user/token)创建。  创建令牌的时候记得务必勾选启智AI  确定后会弹出令牌创建成功的提示，<strong>务必在这个时候点击复制令牌</strong>，否则无法再次获取令牌，只能删除令牌后重新生成。  令牌可以生成多个或者随时更换，支持设置有效期，但请妥善保管。 ## 第二步：接口调用 要进行接口调用，首先需要进行用户鉴权（如果使用官方提供的SDK则可以忽略该步），然后选择需要的接口调用即可，ThinkAI的内置接口[参考这里](https://doc.topthink.com/think-ai/api.html)。 ### 用户鉴权 如果是自己封装HTTP请求接口的话，需要在`header`信息中添加令牌鉴权如下： ``` 'Authorization: Bearer XXXXXXXX' ``` ### SDK调用 为了便于生态开发者，如果是使用的是PHP语言开发应用，那么可以直接使用官方提供的SDK进行调用（要求PHP 8.0+），这也是ThinkAI推荐的方式。 ``` composer require topthink/think-ai ``` 我们可以通过SDK进行大模型对话调用，支持流式和非流式调用。下面是一个简单的例子，我们调用DeepSeek模型进行对话。 ``` use think\ai\Client; $client = new Client('接口令牌'); // 非流式输出 $result = $client->chat()->completions([ 'model' => 'deepseek-r1', 'messages' => [ ['role' => 'user', 'content' => '你好'], ], 'stream' => false, ]); dump($result); // 流式输出 $result = $client->chat()->completions([ 'model' => 'deepseek-r1', 'messages' => [ ['role' => 'user', 'content' => '你好'], ], 'stream' => true, ]); foreach($result as $chunk){ dump($chunk); } ``` SDK中的`model`参数传入的是调用大模型的标识，你可以选择ThinkAI支持的任何一个模型（包括GPT、DeepSeek、智谱、豆包、通义等，查看[支持模型](https://console.topthink.com/ai/model/chat)的标识）进行对话调用。  ThinkAI的模型列表会展示模型的名称、标识及类型（包括视觉理解、推理，以及是否支持函数调用）。 * <strong>视觉理解</strong>：可以在对话中的图像进行理解并回复。 * <strong>推理模型</strong>：支持思维链输出，通常在数学、编程、分析、创作以及通用任务上都具备更强的能力。 * <strong>函数调用</strong>：支持函数调用的大模型可以调用知识库及插件工具。 对于支持视觉功能的模型，支持在对话中传入图片信息，例如： ``` $result = $client->chat()->completions([ 'model' => 'gpt-4.1', 'messages' => [ [ "role" => "user", "content" => [ [ "type" => "text", "text" => "What is in this image?"], [ "type" => "image_url", "image_url" => [ "url": "https://xxx/xxx.jpg" ] ] ] ] ], 'stream'=>true, ]); ``` 并且ThinkAI已经统一适配支持了推理模型的思考过程返回，统一使用`reasoning`返回思考过程，无需你进行各个大模型的适配。 ## 第三步：调用插件 ThinkAI提供了丰富的插件工具，可以供开发者直接调用。  对于支持函数调用的大模型，都可以通过会话接口调用内置工具。官方会持续增加新的插件工具，让AI应用开发更加简单高效。 通常在会话接口中调用插件完成相应的任务，参考下面的示例在`tools`中传入插件调用，`type`使用`plugin`即可，`name`和`tool`的值请参考[插件列表](https://console.topthink.com/ai/plugin)中的标识。 > 需要支持工具调用的模型才支持插件调用  我们以国内新闻插件为例来说明下调用方法 ``` $result = $client->chat()->completions([ 'model' => 'gpt-4o-mini', 'messages' => [ [ 'role' => 'user', 'content' => '今天有什么新闻', ], ], 'tools' => [ [ 'type' => 'plugin', 'plugin' => [ 'name' => 'pmbk5ezJ', 'tool' => 'news_internal', ], ], //... 这里还可以添加更多的可使用的工具， // 具体调用哪个由大模型根据你的问题以及上下文决定 ], 'stream' => false, ]); ``` 返回数据 ``` { "message": { "role": "assistant", "content": null, "tool_calls": [ { "id": "call_vdWclMCeGLKWTOPGSHYC3vsG", "type": "plugin", "plugin": { "name": "pmbk5ezJ", "tool": "news_internal", "title": "国内新闻", "function": "plugin-pmbk5ezJ-news_internal", "arguments": "{\"num\":\"5\"}", "content": "", "response": "[{\"id\":\"7c1191b5f9d4e209ac48f6f7cfeb57a6\",\"ctime\":\"2025-04-30 00:00\",\"title\":\"海大女研究生离世捐献器官 生命热度延续人间大爱\",\"description\":\"\",\"source\":\"中华国内\",\"picUrl\":\"https:\\/\\/img0.utuku.imgcdc.com\\/300x200\\/news\\/20250430\\/3477c2fd-586e-4c45-bb7c-69cc54978335.jpg\",\"url\":\"https:\\/\\/news.china.com\\/socialgd\\/10000169\\/20250430\\/48280908.html\"},{\"id\":\"69a9a2d8a4167d5aced1d26c6eb8f78f\",\"ctime\":\"2025-04-30 00:00\",\"title\":\"成都地铁偷拍女性的男子被拘 私自改装设备作案\",\"description\":\"\",\"source\":\"中华国内\",\"picUrl\":\"https:\\/\\/img2.utuku.imgcdc.com\\/300x200\\/news\\/20250430\\/f4e25ec2-9abe-4fe1-b964-22244800e148.jpg\",\"url\":\"https:\\/\\/news.china.com\\/socialgd\\/10000169\\/20250430\\/48280909.html\"},{\"id\":\"d4b8d237e2d09b98bf401dd8f1d94fd9\",\"ctime\":\"2025-04-30 00:00\",\"title\":\"北京动物园辟谣萌兰出国 虚假信息澄清\",\"description\":\"\",\"source\":\"中华国内\",\"picUrl\":\"https:\\/\\/img1.utuku.imgcdc.com\\/300x200\\/news\\/20250430\\/3a7cd20e-3c38-4cff-80ce-aaadc7c5e678.jpg\",\"url\":\"https:\\/\\/news.china.com\\/socialgd\\/10000169\\/20250430\\/48280911.html\"},{\"id\":\"34bc66b586820538a70356f5c7b1f6b8\",\"ctime\":\"2025-04-30 00:00\",\"title\":\"获奖名单公布，这个头像刷屏！\",\"description\":\"\",\"source\":\"中华国内\",\"picUrl\":\"https:\\/\\/img3.utuku.imgcdc.com\\/300x200\\/news\\/20250430\\/913570e5-4cc3-419a-ad23-f33aaf0a38cd.jpg\",\"url\":\"https:\\/\\/news.china.com\\/domestic\\/945\\/20250430\\/48280467.html\"},{\"id\":\"2e10bb52be4d556f857b4fa519e2f4a7\",\"ctime\":\"2025-04-30 00:00\",\"title\":\"外交部：中方高度赞赏索方坚定恪守一个中国原则\",\"description\":\"\",\"source\":\"中华国内\",\"picUrl\":\"https:\\/\\/img3.utuku.imgcdc.com\\/300x200\\/news\\/20250430\\/34c6114e-6f4d-4f04-8d05-04e468affbe4.png\",\"url\":\"https:\\/\\/news.china.com\\/domestic\\/945\\/20250430\\/48280505.html\"}]", "error": false, "usage": 100 } } ], "refusal": null, "annotations": [] }, "finish_reason": "tool_calls", "usage": { "prompt_tokens": 26, "completion_tokens": 24, "total_tokens": 50 } } ``` 插件调用的结果在`response`里面，可以直接使用，也可以像下面这样通过多轮调用让大模型整理后再输出。 ``` $result = $client->chat()->completions([ 'model' => 'gpt-4o-mini', 'messages' => [ [ 'role' => 'user', 'content' => '今天有什么新闻', ], //这里添加上上面返回的工具调用数据 再次请求 [ 'role' => 'assistant', 'tool_calls' => [ [ 'id' => 'call_vdWclMCeGLKWTOPGSHYC3vsG', 'type' => 'plugin', 'plugin' => [ 'name' => 'pmbk5ezJ', 'tool' => 'news_internal', 'title' => '国内新闻', 'function' => 'plugin-pmbk5ezJ-news_internal', 'arguments' => '{"num":"5"}', 'content' => '', 'response' => '[{"id":"7c1191b5f9d4e209ac48f6f7cfeb57a6","ctime":"2025-04-30 00:00","title":"海大女研究生离世捐献器官 生命热度延续人间大爱","description":"","source":"中华国内","picUrl":"https:\/\/img0.utuku.imgcdc.com\/300x200\/news\/20250430\/3477c2fd-586e-4c45-bb7c-69cc54978335.jpg","url":"https:\/\/news.china.com\/socialgd\/10000169\/20250430\/48280908.html"},{"id":"69a9a2d8a4167d5aced1d26c6eb8f78f","ctime":"2025-04-30 00:00","title":"成都地铁偷拍女性的男子被拘 私自改装设备作案","description":"","source":"中华国内","picUrl":"https:\/\/img2.utuku.imgcdc.com\/300x200\/news\/20250430\/f4e25ec2-9abe-4fe1-b964-22244800e148.jpg","url":"https:\/\/news.china.com\/socialgd\/10000169\/20250430\/48280909.html"},{"id":"d4b8d237e2d09b98bf401dd8f1d94fd9","ctime":"2025-04-30 00:00","title":"北京动物园辟谣萌兰出国 虚假信息澄清","description":"","source":"中华国内","picUrl":"https:\/\/img1.utuku.imgcdc.com\/300x200\/news\/20250430\/3a7cd20e-3c38-4cff-80ce-aaadc7c5e678.jpg","url":"https:\/\/news.china.com\/socialgd\/10000169\/20250430\/48280911.html"},{"id":"34bc66b586820538a70356f5c7b1f6b8","ctime":"2025-04-30 00:00","title":"获奖名单公布，这个头像刷屏！","description":"","source":"中华国内","picUrl":"https:\/\/img3.utuku.imgcdc.com\/300x200\/news\/20250430\/913570e5-4cc3-419a-ad23-f33aaf0a38cd.jpg","url":"https:\/\/news.china.com\/domestic\/945\/20250430\/48280467.html"},{"id":"2e10bb52be4d556f857b4fa519e2f4a7","ctime":"2025-04-30 00:00","title":"外交部：中方高度赞赏索方坚定恪守一个中国原则","description":"","source":"中华国内","picUrl":"https:\/\/img3.utuku.imgcdc.com\/300x200\/news\/20250430\/34c6114e-6f4d-4f04-8d05-04e468affbe4.png","url":"https:\/\/news.china.com\/domestic\/945\/20250430\/48280505.html"}]', 'error' => false, 'usage' => 100 ] ] ], ], ], 'tools' => [ [ 'type' => 'plugin', 'plugin' => [ 'name' => 'pmbk5ezJ', 'tool' => 'news_internal', ], ] ], 'stream' => false, ]); ``` 调用结果 ``` { "message": { "role": "assistant", "content": "今天的新闻有：\n\n1. 海大女研究生离世捐献器官，生命热度延续人间大爱。[详情](https://news.china.com/socialgd/10000169/20250430/48280908.html)\n2. 成都地铁偷拍女性的男子被拘，私自改装设备作案。[详情](https://news.china.com/socialgd/10000169/20250430/48280909.html)\n3. 北京动物园辟谣萌兰出国，虚假信息澄清。[详情](https://news.china.com/socialgd/10000169/20250430/48280911.html)\n4. 获奖名单公布，这个头像刷屏！[详情](https://news.china.com/domestic/945/20250430/48280467.html)\n5. 外交部：中方高度赞赏索方坚定恪守一个中国原则。[详情](https://news.china.com/domestic/945/20250430/48280505.html)\n\n您想了解哪条新闻的详细内容？", "refusal": null, "annotations": [] }, "finish_reason": "stop", "usage": { "prompt_tokens": 215, "completion_tokens": 246, "total_tokens": 461 } } ``` 现在，你已经基本了解了ThinkAI的SDK使用及插件调用的方法，更深入的就需要结合自己的业务需求进行开发。 对于企业大部分的AI使用场景而言，我们更推荐基于[ThinkBot](https://bot.topthink.com/)直接开发AI应用，可以省去大量的底层开发工作也不需要关注底层调用机制，让你可以更专注于业务场景，只需要在后台根据业务需求构建智能体后直接集成，构建智能体的过程中可以直接使用内置的所有插件以及知识库功能，对于复杂的业务可以通过[工作流模式](https://doc.topthink.com/think-bot/flow.html)或多智能体协同方式构建，并且ThinkBot也提供了对话接口。