强制执行工作流组件
更新时间：2025-08-04
概述
使用Agent时，针对用户需求特别明确的某一类问题，可以绕过思考模型直接调用组件。如“查询北京3月20号的天气”，开发者可以通过tool_choice字段，在前端构建快捷指令，直接调用天气查询组件，保证效果和时延。
使用流程
1.在平台通过工作流创建一个组件。 2.将创建好的组件加入到自主规划Agent应用中，可以看到正常的执行过程中含有思考过程。
3.应用准备好后，在平台的应用列表中获取到应id。便可以通过代码态的方式进行组件强制执行（绕过思考模型）
通过代码强制执行工作流组件
1.通过“新建对话” 接口 获取conversation_id
JSON
1curl --location 'http://qianfan.baidubce.com/v2/app/conversation' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data '{
5 "app_id": "231b102a-3412-4cce-bfd2-2fd31d7ba48d"
6}'
JSON
1{
2 "request_id": "d502c73c-dce5-404d-9cad-92a295757dd4",
3 "conversation_id": "e08db6b2-50a3-47b6-8fcb-9fd07f503959"
4}2.调用“对话”接口，可以通过配置tool_chioce字段，绕过思考模型，直接对工作流组件进行调用。
注意：用户只需传入组件开始节点的新增参数，系统参数如rawQuery、chatHistory、fileUrls等，不需要传入，组件会自动获取对应app_id的系统参数。
请求示例
JSON
1curl --location --request POST 'http://qianfan.baidubce.com/v2/app/conversation/runs' \
2--header 'Authorization: Bearer <AppBuilder API Key>' \
3--header 'Content-Type: application/json' \
4--data-raw '{
5 "app_id": "231b102a-3412-4cce-bfd2-2fd31d7ba48d",
6 "query": "今天天气如何",
7 "stream": false,
8 "conversation_id": "6f83c06f-5551-4f90-9056-a686110c248b",
9 "tool_choice": {
10 "type": "function",
11 "function": {
12 "name": "TianQiChaXun",
13 "input": {
14 "city":"深圳"
15 }
16 }
17 }
18}'3.从响应结果中可以看到，组件执行成功
JSON
1{
2 "request_id": "8d829664-0aea-4f4a-b55b-5d299eb45ee4",
3 "date": "2025-08-04T07:41:26Z",
4 "answer": "根据查询结果，今天深圳的天气情况如下：\n\n- 当前时间：2025-08-04 15:35\n- 当前气温：25°C\n- 天气状况：晴\n- 风向风速：东北风 2级\n- 湿度：27%\n- 可见度：10000米\n- 气压：1021.0 hPa\n\n未来几小时的天气预报：\n\n- 16时：晴，气温21°C\n- 17时：晴，气温21°C\n- 18时：晴，气温20°C\n\n未来若干天的天气预报：\n\n- 3月20日：日间晴，夜间晴，气温范围25°C - 14°C\n- 3月21日：日间晴，夜间晴，气温范围25°C - 15°C\n- 3月22日：日间晴，夜间晴，气温范围26°C - 16°C\n- ...（省略部分日期）\n\n请注意，以上天气信息仅供参考，实际天气情况可能会有所不同。如需更多信息，请查询相关天气预报网站或应用。",
5 "conversation_id": "6f83c06f-5551-4f90-9056-a686110c248b",
6 "message_id": "4332fef6-6f83-45c0-9b50-da2cf5944478",
7 "is_completion": null,
8 "content": [
9 {
10 "result_type": "",
11 "event_code": 0,
12 "event_message": "",
13 "event_type": "function_call",
14 "event_id": "0",
15 "event_status": "done",
16 "content_type": "function_call",
17 "visible_scope": "all",
18 "outputs": {
19 "text": {
20 "arguments": {
21 "city": "深圳"
22 },
23 "component_code": "Workflow",
24 "component_name": "TianQiChaXun"
25 }
26 }
27 },
28 {
29 "result_type": "",
30 "event_code": 0,
31 "event_message": "",
32 "event_type": "Workflow",
33 "event_id": "1",
34 "event_status": "preparing",
35 "content_type": "status",
36 "visible_scope": "llm",
37 "outputs": {}
38 },
39 {
40 "result_type": "",
41 "event_code": 0,
42 "event_message": "",
43 "event_type": "Workflow",
44 "event_id": "2",
45 "event_status": "done",
46 "content_type": "text",
47 "visible_scope": "llm",
48 "outputs": {
49 "meta": {
50 "workflow_id": "4434c2c5-55b2-45de-b917-c210aca814b2",
51 "workflow_code": "TianQiChaXun",
52 "workflow_name": "天气查询",
53 "desc": "一个天气查询组件"
54 },
55 "text": "{\"value\":\"## 广东深圳当前的天气信息\\n当前时间：2025-08-04 15:35当前气温：25°C 当前天气：晴 当前风像：东北风 2级 当前湿度：27 当前可见度：10000 当前气压：1021.0 \\n\\n## 广东深圳未来几小时的天气信息\\n时间: 2025032016 降水概率：0 降水量：0.0 气温：21°C 天气：晴 \\n时间: 2025032017 降水概率：0 降水量：0.0 气温：21°C 天气：晴 \\n时间: 2025032018 降水概率：0 降水量：0.0 气温：20°C 天气：晴 \\n\\n## 广东深圳未来若干天的天气信息\\n日期：2025-08-04 日间天气：晴 夜间天气：晴 日间气温：25°C 夜间气温：14°C \\n日期：2025-08-04 日间天气：晴 夜间天气：晴 日间气温：25°C 夜间气温：15°C \\n日期：2025-08-04 日间天气：晴 夜间天气：晴 日间气温：26°C 夜间气温：16°C \\n日期：2025-08-04 日间天气：晴 夜间天气：晴 日间气温：27°C 夜间气温：17°C \\n日期：2025-08-04 日间天气：多云 夜间天气：多云 日间气温：28°C 夜间气温：18°C \\n日期：2025-08-04 日间天气：多云 夜间天气：多云 日间气温：28°C 夜间气温：19°C \\n日期：2025-08-04 日间天气：晴 夜间天气：晴 日间气温：27°C 夜间气温：20°C \\n日期：2025-08-04 日间天气：小雨 夜间天气：小雨 日间气温：27°C 夜间气温：17°C \\n日期：2025-08-04 日间天气：阴 夜间天气：小雨 日间气温：21°C 夜间气温：14°C \\n日期：2025-08-04 日间天气：小雨 夜间天气：小雨 日间气温：19°C 夜间气温：16°C \\n日期：2025-08-04 日间天气：小雨 夜间天气：阴 日间气温：20°C 夜间气温：15°C \\n日期：2025-08-04 日间天气：小雨 夜间天气：小雨 日间气温：17°C 夜间气温：14°C \\n日期：2025-08-04 日间天气：阴 夜间天气：阴 日间气温：21°C 夜间气温：16°C \\n日期：2025-08-04 日间天气：阴 夜间天气：小雨 日间气温：22°C 夜间气温：19°C \\n日期：2025-08-04 日间天气：小雨 夜间天气：阴 日间气温：20°C 夜间气温：19°C \\n深圳天气 中国天气网深圳天气官方发布账号 深圳天气预报\\n「深圳罗湖」3/20，多云，13~24℃，东北风2级，空气质量良\\n「深圳宝安」3/20，多云，13~24℃，东北风2级，空气质量良\\n「深圳盐田」3/20，多云，13~23℃，东北风2级，空气质量良\\n「深圳龙岗」3/20，多云，13~24℃，东北风2级，空气质量良\\n「深圳」3/20，晴，14~24℃，东北风2级，空气质量优\\n「深圳南山」明日（3/20），晴，13~24℃，东北风2级，空气质量优\\n深圳 2025/03/18 ~ 2025/04/01 未来15天,平均高温23℃,平均低温17℃ 2次降水 今天 03/18 阴转多云 18/13℃ 周三 03/19 多云转晴 21/14℃ 周四 03/20 晴 23/15℃ 周五 03/21 晴 25/17℃ 周六 03/22 晴转多云 26/18℃ 周日 03/23 多云 27/19℃ 周一 03/24 多云 28/19℃ 周二 03/25 多云 28/20℃ 周三 03/26 晴转阴 26/21℃ 周四 03/27 雨 27/18℃ 周五 03/28 多云转阴 26/19℃ 周六 03/29 雨转阴 21/17℃ 周日 03/30 阴 19/16℃ 周一 03/31 多云转阴 20/16℃ 周二 04/01 多云转阴 22/18℃40天预报 温度趋势 温暖 降水趋势 7次降水 天气雷达 我的天空 精彩推荐 本周全国大部抽中“阳光升温卡”! 新闻联播天气预报 全国乱穿衣预警地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 大雾预警信号需要注意什么? 本周全国大部抽中“阳光升温卡”! 新闻联播天气预报 全国乱穿衣预警地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 大雾预警信号需要注意什么? 本周全国大部抽中“阳光升温卡”! 新闻联播天气预报 全国乱穿衣预警地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 大雾预警信号需要注意什么? 未来3天公报 未来10天公报 气象数据来源:中央气象台 预报更新时间:每日06、08、12、16、20时\\n天气加 为您提供贴心的生活天气服务 \\n深圳 2025/03/12 ~ 2025/03/26 未来15天,平均高温22℃,平均低温15℃ 3次降水 今天 03/12 多云 26/20℃ 周四 03/13 多云 27/20℃ 周五 03/14 多云转雷阵雨 25/20℃ 周六 03/15 阵雨 26/15℃ 周日 03/16 阵雨转晴 19/13℃ 周一 03/17 晴 20/12℃ 周二 03/18 阴 16/12℃ 周三 03/19 多云转晴 20/13℃ 周四 03/20 晴 23/13℃ 周五 03/21 晴 24/14℃ 周六 03/22 阴 24/16℃ 周日 03/23 阴 22/17℃ 周一 03/24 晴转阴 23/18℃ 周二 03/25 多云转晴 23/18℃ 周三 03/26 阴转晴 26/18℃40天预报 温度趋势 升温 降水趋势 7次降水 天气雷达 我的天空 精彩推荐 春天能想到的天气,这周都集齐了 新闻联播天气预报 全国春捂地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 ?七九气温多起伏 春天能想到的天气,这周都集齐了 新闻联播天气预报 全国春捂地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 ?七九气温多起伏 春天能想到的天气,这周都集齐了 新闻联播天气预报 全国春捂地图出炉 北京天暖冰消融 迎春花开春将至 惊蛰:春雷乍动 万物复苏 晨味时节——惊蛰 ?七九气温多起伏 未来3天公报 未来10天公报 推荐 直播 图集 短视频 生活 中东部大部开启降温模式 南方雨势增强多地或现强对流2025-08-04 08:10 两会气象服务专报:今天白天北京风力较大 14日降温明显2025-08-04 08:03 北京今日能见度好转阵风可达七级左右 最高温将升至18℃2025-08-04 07:17 大风蓝色预警:内蒙古新疆等地局地阵风可达9至11级2025-08-04 07:09 大雾黄色预警:河北山东江苏等地局地有能见度不足200米的强浓雾2025-08-04 07:09 早安!节气中国:待春风叩窗时 花开枝头天地暖2025-08-04 07:00 晚安天气2025-08-04 20:00 暴雪、暴雨、大风、沙尘、降温、回南天...春天大概能想到的天气,这周都集齐了2025-08-04 18:09 大雾黄色预警:江苏浙江四川广西等部分地区有大雾2025-08-04 18:04 暴雪黄色预警:内蒙古黑龙江等部分地区有大到暴雪2025-08-04 18:02 大风黄色预警:内蒙古河北等7省区部分地区有5至6级风2025-08-04 18:02 沙尘暴蓝色预警:新疆内蒙古等12省区市有扬沙或浮尘天气2025-08-04 18:02 南方将有大范围降雨并伴强对流 西北华北等地有雨雪天气2025-08-04 17:31 未来一周南方气温偏低多降水 春耕春播或受影响2025-08-04 17:23 四川今夜到后天雨雪频繁 川西高原降雪连连 \\n\"}"
56 },
57 "usage": {
58 "prompt_tokens": 0,
59 "completion_tokens": 0,
60 "total_tokens": 0,
61 "nodes": []
62 }
63 },
64 {
65 "result_type": "",
66 "event_code": 0,
67 "event_message": "",
68 "event_type": "Workflow",
69 "event_id": "3",
70 "event_status": "success",
71 "content_type": "status",
72 "visible_scope": "all",
73 "outputs": {}
74 },
75 {
76 "result_type": "",
77 "event_code": 0,
78 "event_message": "",
79 "event_type": "function_call",
80 "event_id": "4",
81 "event_status": "done",
82 "content_type": "function_call",
83 "visible_scope": "all",
84 "outputs": {
85 "text": {
86 "arguments": {
87 "origin_query": "今天天气如何"
88 },
89 "component_code": "ChatAgent",
90 "component_name": "聊天助手"
91 }
92 }
93 },
94 {
95 "result_type": "",
96 "event_code": 0,
97 "event_message": "",
98 "event_type": "ChatAgent",
99 "event_id": "5",
100 "event_status": "preparing",
101 "content_type": "status",
102 "visible_scope": "",
103 "outputs": {}
104 },
105 {
106 "result_type": "",
107 "event_code": 0,
108 "event_message": "",
109 "event_type": "ChatAgent",
110 "event_id": "6",
111 "event_status": "done",
112 "content_type": "text",
113 "visible_scope": "all",
114 "outputs": {
115 "text": "根据查询结果，今天深圳的天气情况如下：\n\n- 当前时间：2025-08-04 15:35\n- 当前气温：25°C\n- 天气状况：晴\n- 风向风速：东北风 2级\n- 湿度：27%\n- 可见度：10000米\n- 气压：1021.0 hPa\n\n未来几小时的天气预报：\n\n- 16时：晴，气温21°C\n- 17时：晴，气温21°C\n- 18时：晴，气温20°C\n\n未来若干天的天气预报：\n\n- 3月20日：日间晴，夜间晴，气温范围25°C - 14°C\n- 3月21日：日间晴，夜间晴，气温范围25°C - 15°C\n- 3月22日：日间晴，夜间晴，气温范围26°C - 16°C\n- ...（省略部分日期）\n\n请注意，以上天气信息仅供参考，实际天气情况可能会有所不同。如需更多信息，请查询相关天气预报网站或应用。"
116 },
117 "usage": {
118 "prompt_tokens": 2628,
119 "completion_tokens": 267,
120 "total_tokens": 2895,
121 "name": "Qianfan-Agent-Speed-32K",
122 "type": "chat"
123 }
124 },
125 {
126 "result_type": "",
127 "event_code": 0,
128 "event_message": "",
129 "event_type": "ChatAgent",
130 "event_id": "7",
131 "event_status": "success",
132 "content_type": "status",
133 "visible_scope": "all",
134 "outputs": {}
135 }
136 ]
137}4.如果你希望组件执行后的原始输出可以直接返回给用户（想绕过问答模型），请在自主规划Agent的应用回复设置中将该组件设置成回复节点。之后可以再次执行前面的 【1 - 3 】步骤进行验证。
注意：含有百度搜索节点的组件，不支持获取组件原始输出。
