用地区、定位、天气和三甲医院接口构建本地服务查询 Agent

DevOpenClub

337人浏览 · 2026-08-01 11:56:00

DevOpenClub · 2026-08-01 11:56:00 发布

摘要：本地服务查询并不只是关键词搜索。本文演示如何把省市区数据、坐标转换、IP 定位、三甲医院主体信息、天气和空气质量接口组合起来，构建一个面向本地服务问答和就医信息查询的 Agent。

关键词：三甲医院 API、本地服务 Agent、省市区 API、天气 API、空气质量 API、位置查询

问题背景

用户问“附近有哪些三甲医院”“某个城市有哪些医院”“今天适不适合出门就医”时，系统需要理解地区、城市、距离、天气和空气质量等上下文。单纯让模型回答，容易出现地点不准、名称过时或建议过度的问题。

更稳妥的做法是让 Agent 先确认位置和行政区，再查询医院主体信息，并把天气和空气质量作为辅助信息展示。模型负责组织语言和提醒边界，不提供诊断结论。

Agent 工作流

Agent 工作流示意图

接口编排

步骤	接口	请求方式	用途
行政区查询	全国省市区街道村信息	GET	规范化省、市、区等地区字段
IP 定位	国内 IP 地址定位	GET	在用户未输入城市时提供粗定位参考
坐标转换	地理坐标系转换	GET	对接地图或定位系统时统一坐标
医院查询	全国三甲医院主体信息	GET	按省、市、区或关键词查询医院
天气信息	全国天气预报信息	GET	展示出行相关天气
空气质量	全国实时空气质量指数	GET	补充空气质量参考

调用示例

按城市查询三甲医院：

curl -G "https://api.gugudata.com/location/hospital-3a" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "province=江苏省" \
  --data-urlencode "city=南京市" \
  --data-urlencode "pageIndex=1" \
  --data-urlencode "pageSize=20"

查询行政区信息：

curl -G "https://api.gugudata.com/location/chinaregions" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "regioncode=320100" \
  --data-urlencode "version=3"

查询天气预报：

curl -G "https://api.gugudata.com/weather/weatherinfo" \
  --data-urlencode "appkey=YOUR_APPKEY" \
  --data-urlencode "city=南京"

Agent 可以先把位置字段规范化：

def normalize_location(input_text: str, fallback_city: str | None = None) -> dict:
    """Build a location query object for local service search."""
    return {
        "keyword": input_text.strip(),
        "city": fallback_city,
        "needs_region_lookup": bool(input_text and not fallback_city),
    }

输出怎么组织

本地服务类结果建议拆成三部分：

区块	内容
查询条件	用户输入、省市区、是否使用定位辅助
医院列表	医院名称、所在地区、主体信息、匹配原因
出行参考	天气、空气质量、数据更新时间

如果用于医疗服务入口，页面文案应保持谨慎。系统可以帮助用户查找医院主体信息，但不应替代医生诊断，也不应根据症状直接给治疗方案。

标准架构拆解

本地服务 Agent 可以拆成以下模块：

模块	责任
位置解析	处理用户输入、IP 定位、地图坐标和行政区字段
服务检索	查询医院主体信息或其他本地服务数据
环境补充	获取天气、空气质量等出行参考
结果排序	按地区匹配、关键词匹配和用户偏好排序
问答输出	生成清晰、克制、可复核的查询结果

位置解析应尽量结构化。比如“南京鼓楼附近”需要拆成城市、区县和关键词；如果用户只说“附近”，则需要明确是否允许使用 IP 或定位信息。

数据流与接口边界

推荐流程如下：

用户输入位置和服务需求。
Agent 判断是否需要补充城市或行政区。
使用省市区接口规范化地区字段。
根据城市、区县或关键词查询三甲医院。
根据城市补充天气和空气质量。
输出医院列表，并标明查询条件和数据来源。
如果结果为空，提示用户放宽地区或关键词。

接口边界上，医院接口返回的是主体信息；天气和空气质量只是出行参考。Agent 不应把天气或空气质量解释成医学建议。

错误处理

如果用户拒绝提供位置，Agent 应允许按城市或关键词检索。若 IP 定位和用户输入城市不一致，应优先使用用户明确输入，并在结果中说明查询条件。

如果医院查询无结果，可以尝试扩大到市级或省级范围。不要为了给出结果而返回无关城市的医院。

可靠性与观测

建议记录以下指标：

指标	用途
location_parse_success_rate	位置解析成功率
hospital_result_count	医院查询结果数量
fallback_to_city_count	区县无结果后回退市级的次数
weather_fetch_success_rate	天气接口成功率
user_refine_query_count	用户二次调整查询的次数

当回退次数过多时，说明用户输入和行政区字段匹配存在问题，需要优化位置解析和同义词处理。