SuperAPI AI 工具集

places_search

通用与其它

查看项目

更新于 10-26 18:14

技能介绍

用途 places_search 用于查找、比较和分享实体地点信息,包括餐厅、咖啡馆、酒吧、酒店、公园、步道、景点、商店和本地服务等。

主要能力 地点发现:借助 browser.search 检索用户附近或指定区域内可供到访或在地图上引用的场所。 丰富详情:通过 places details 获取营业时间、价格、照片、评价和提供的服务等更新的详细信息;该命令只接受数字地点 ID,不支持按名称或地址搜索。 照片识地点:places detect 根据拍摄画面与 GPS 判断用户所在位置,返回按置信度排序的候选 {place_id, place_name, confidence},可再用 places details 深入查看。 地图呈现:在取得数字地点 ID 与坐标后,通过 widget.create 创建一个 local_map 组件,将相关地点以 rich_place 元素展示。

使用方式 所有地点发现和名称/地址查询使用 browser.search,通过 muse.exec 运行 places 命令获取更丰富详情和照片识别,无需登录。查询时应把完整用户意图写入 primary_query.query,包含场所类别或名称、区域、半径和排序偏好,例如检索“best sushi restaurants in San Francisco within five miles”而非仅“sushi”。用户说“near me”或“nearby”时保留该表述以使用设备定位,不得自行编造位置;用户提及多个城市或街区时,应分别调用并逐一覆盖。对于“best”、趋势或细分类需求,应结合检索返回的网页证据与地点结果,每个点名场所都必须来自实际返回结果。只有在 browser.search 明确返回纯数字 place_id 时才调用 places details;比较多个地点时可批量传入 ID,并用 --motivation 传入用户意图以对引文和照片排序。创建地图前需先对选中的数字 ID 运行 places details,仅当至少一条返回记录同时含数字地点 ID 和坐标时才创建一张地图,坐标必须取自同一记录,不得推断 ID 或对名称做地理编码。若创建失败则仅以文字回答,不重试、不构建 HTML 或图片地图。

响应格式 不得提及任何未由工具返回的场所。推荐类请求给出两到三个地点,宽泛请求可列几个作为起点。文本中用“名称,一两句推荐理由”的格式逐行列出两到三个地点,开头用一句简短的话总起,整体作为一条消息发送,地图之后不再追加消息。正文中不出现地址、原始地点 ID、坐标、星级评分、评价数或价格等级。基于 browser.search 的事实陈述按其常规引用格式标注。

适用场景 适合对话内的本地场所推荐、多地点比较、按名称查找地点、从照片判断所在场所,以及为推荐结果生成地图锚点。

限制 不提供路线指引、逐向导航、地图链接或导航控件;不估算出行时间或距离,仅使用工具返回的数值。地图只创建一张,且需包含返回的 embed_token;回答中不叙述或引用地图本身。