天气

功能介绍

本接口用于借助实时天气信息，回答天气相关问题，预报未来天气状况。

服务后缀名称说明

配置插件应用服务成功后，可以查看服务后缀名称、服务地址等信息。如何配置插件应用服务，详见插件编排使用说明。

配置插件应用成功后，查看服务地址、服务后缀名称。

说明：只有服务状态为上线状态，才可以查看自动生成的服务地址、服务后缀名称。

• 在插件的详情页中，查看完整的服务地址。
• 

返回说明

注意 ：同步模式和流式模式，响应参数返回不同，详细内容参考示例描述。

• 同步模式下，响应参数为以上字段的完整json包。
• 流式模式下，各字段的响应参数为 data: {响应参数}。

请求示例（流式）

• bash
• Python

# 步骤一，获取access_token，替换下列示例中的API Key与Secret Key
curl 'https://aip.baidubce.com/oauth/2.0/token?grant_type=client_credentials&client_id=[API Key]&client_secret=[Secret Key]'

# 步骤二，调用本文API，使用步骤一获取的access_token，替换下列示例中的“调用接口获取的access_token”
curl 'https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop/plugin/[服务后缀名称]/?access_token=[步骤一调用接口获取的access_token]' 
    --data '{"query": "北京今天天气怎么样","plugins":["uuid-weatherforecast"], "stream": true}'
    -H 'Content-Type: application/json'

响应示例（流式）

{'id': 'as-mubgd52bq6', 'object': 'chat.completion', 'created': 1689076948, 'sentence_id': 0, 'is_end': False, 'is_truncated': False, 'result': '北京当前天气：阴，气温22℃，西南风1级，空气质量优，空气质量指数11，',"meta_info": "", 'need_clear_history': False, 'usage': {'prompt_tokens': 11, 'completion_tokens': 65, 'total_tokens': 76}}
{'id': 'as-mubgd52bq6', 'object': 'chat.completion', 'created': 1689076950, 'sentence_id': 1, 'is_end': False, 'is_truncated': False, 'result': '湿度96.0%，气压982.5hPa。体感温度：23℃，人体感觉较为舒适。', "meta_info": "",'need_clear_history': False, 'usage': {'prompt_tokens': 11, 'completion_tokens': 79, 'total_tokens': 155}}
{'id': 'as-mubgd52bq6', 'object': 'chat.completion', 'created': 1689076951, 'sentence_id': 2, 'is_end': False, 'is_truncated': False, 'result': '紫外线最弱，落日西沉，无需防护。',"meta_info": "", 'need_clear_history': False, 'usage': {'prompt_tokens': 11, 'completion_tokens': 65, 'total_tokens': 220}}
{'id': 'as-mubgd52bq6', 'object': 'chat.completion', 'created': 1689076954, 'sentence_id': 3, 'is_end': False, 'is_truncated': False, 'result': 'Tips：空气很好，可以外出活动，呼吸新鲜空气。', "meta_info": "",'need_clear_history': False, 'usage': {'prompt_tokens': 11, 'completion_tokens': 160, 'total_tokens': 380}}
{'id': 'as-mubgd52bq6', 'object': 'chat.completion', 'created': 1689076955, 'sentence_id': 4, 'is_end': True, 'is_truncated': False, 'result': '', "meta_info": "",'need_clear_history': False, 'usage': {'prompt_tokens': 11, 'completion_tokens': 0, 'total_tokens': 380}}

错误码

错误码	错误信息	描述
337009	请求天气插件失败	连接异常，请在百度智能云控制台提交工单咨询

回包类型。 chat.completion：多轮对话返回

表示用户输入是否存在安全，是否关闭当前会话，清理历史会话信息 true：是，表示用户输入存在安全风险，建议关闭当前会话，清理历史会话信息 false：否，表示用户输入无安全风险

{
  "id": "as-m4ntrjmcd7",
  "object": "chat.completion",
  "created": 1693881770,
  "result": "北京当前天气：阴，气温22℃，西南风1级，空气质量优，空气质量指数11，湿度96.0%，气压982.5hPa。",
  "meta_info": "",
  "is_truncated": false,
  "need_clear_history": false,
  "usage": {
    "prompt_tokens": 237,
    "completion_tokens": 8,
    "total_tokens": 245
  }
}

是否以流式接口的形式返回数据，默认false，可选值如下： （1）true: 是，以流式接口的形式返回数据 （2）false：否，非流式接口形式返回数据

说明： （1）如果prompt中使用了变量，推理时可以填写具体值； （2）如果prompt中未使用变量，该字段不填。 参数示例："input_variables"：{"key1":"value1","key2":"value2",} key1、key2为配置时prompt中使用了变量key

是否返回插件的原始请求信息，默认false，可选值如下： true：是，返回插件的原始请求信息meta_info false：否，不返回插件的原始请求信息meta_info

{
  "id": "as-m4ntrjmcd7",
  "object": "chat.completion",
  "created": 1693881770,
  "result": "北京当前天气：阴，气温22℃，西南风1级，空气质量优，空气质量指数11，湿度96.0%，气压982.5hPa。",
  "meta_info": "",
  "is_truncated": false,
  "need_clear_history": false,
  "usage": {
    "prompt_tokens": 237,
    "completion_tokens": 8,
    "total_tokens": 245
  }
}