内容
# 用纽约公开数据构建可靠的AI
> **状态：草案**。该仓库是新启动的（2026-07-06）。其中的所有内容，包括结构、指南和目录，都是一次初步尝试，正在积极审查中，尚未完成。
一个实用的资源，用于在真实、可验证的纽约市和纽约州公开数据中构建可靠的AI代理，而不是让它们自行猜测。
AI代理的可靠性取决于其基础数据。该仓库记录了BetaNYC如何通过[Socrata](https://dev.socrata.com/) MCP（模型上下文协议）工具，将AI代理连接到真正的政府公开数据门户，以便有关城市和州数据的答案来自实际的公共记录，而不是语言模型对这些记录的记忆。
---
## 由BetaNYC构建
[**BetaNYC**](https://beta.nyc) 是纽约市的一家公民组织，致力于通过公共利益技术、公开数据和公民设计改善人们的生活。我们构建工具，培训公众，并倡导一个更加透明、负责和参与的城市政府。
该仓库是我们为使政府数据可用于查询而付出的更大努力的一部分 - 请参见我们的相关工作：
- **[BetaNYC/New-York-City-Budget](https://github.com/BetaNYC/New-York-City-Budget)** - 从官方PDF文件中确定性地提取的、协调一致的纽约市议会预算数据（附表C、条款和条件、第254节）。
- **BetaNYC的六个公开MCP服务器** - [nyc-council-mcp](https://github.com/BetaNYC/nyc-council-mcp)，[nyc-record-mcp](https://github.com/BetaNYC/nyc-record-mcp)，[nyc-checkbook-mcp](https://github.com/BetaNYC/nyc-checkbook-mcp)，[nyc-311-mcp](https://github.com/BetaNYC/nyc-311-mcp)，[nyc-charter-laws-rules](https://github.com/BetaNYC/nyc-charter-laws-rules)，[nys-openlegislation-mcp](https://github.com/BetaNYC/nys-openlegislation-mcp) - 针对特定的纽约市/纽约州政府数据领域的定制代理工具。
**支持公开公民数据：** [beta.nyc](https://beta.nyc) · [捐赠](https://beta.nyc/donate) · [新闻通讯](https://beta.nyc)
---
## 目录
| 文件 | 内容 |
|---|---|
| [`mcp-configs/socrata-nyc-nys.mcp.json`](mcp-configs/socrata-nyc-nys.mcp.json) | 用于在纽约市和纽约州公开数据门户之间切换的MCP配置 |
| [`guides/when-to-use-which-portal.md`](guides/when-to-use-which-portal.md) | 每个门户（以及每个BetaNYC MCP）的实际覆盖范围 - 决策指南 |
| [`guides/query-patterns.md`](guides/query-patterns.md) | 可复制的SoQL查询模式：目录搜索、数据集获取、跨门户查找 |
| [`guides/grounding-ai-agents.md`](guides/grounding-ai-agents.md) | 为什么构建可靠的基础很重要，以及AI代理构建者的提示/验证模式 |
| [`guides/training-resources.md`](guides/training-resources.md) | BetaNYC和合作伙伴的培训 - 开放数据导论、开放数据大使等 |
| [`resources/ny-open-data-portals.md`](resources/ny-open-data-portals.md) | 由纽约县和市政府运行的公开数据门户目录，附有API和平台说明 |
| [`resources/research-plan-ny-open-data-portals.md`](resources/research-plan-ny-open-data-portals.md) | 目录背后的扫描计划（目标、范围、方法论） - 为透明度而保留 |
---
## 快速开始
1. 将[`mcp-configs/socrata-nyc-nys.mcp.json`](mcp-configs/socrata-nyc-nys.mcp.json)中的配置复制到您自己的`.mcp.json`中。
2. 阅读[`guides/when-to-use-which-portal.md`](guides/when-to-use-which-portal.md)，以了解哪个门户（或哪个BetaNYC MCP）实际上拥有您需要的数据集。
3. 使用[`guides/query-patterns.md`](guides/query-patterns.md)获取实际查询语法。
两个门户都不需要API密钥。可选的`SOCRATA_APP_TOKEN`会提高速率限制 - 有关放置位置，请参见配置文件。
---
## 仓库布局
```
grounding-ai-with-ny-open-data/
├── README.md ← 您当前所在的文件
├── LICENSE ← CC BY-SA 4.0
├── mcp-configs/
│ └── socrata-nyc-nys.mcp.json ← 双重纽约市/纽约州Socrata MCP别名
├── guides/
│ ├── when-to-use-which-portal.md ← 草案 - 数据集覆盖范围 + 决策指南
│ ├── query-patterns.md ← 草案 - SoQL示例
│ ├── grounding-ai-agents.md ← 草案 - 构建可靠基础的理由 + 提示模式
│ └── training-resources.md ← 草案 - 课程和项目
└── resources/
├── ny-open-data-portals.md ← 草案 - 县/市政府门户目录
└── research-plan-ny-open-data-portals.md ← 目录背后的扫描计划
```
---
## 许可
该仓库是文档和参考资料，而不是软件。它在**知识共享署名-相同方式共享4.0国际（CC BY-SA 4.0）**下发布 - 请参见[`LICENSE`](LICENSE)。只要您给予适当的署名，并以相同的条款许可您的贡献，您就可以出于任何目的（包括商业目的）自由分享和改编这些材料。
如果您使用或改编这些材料，请注明**BetaNYC**并链接回此仓库。
---
## 贡献
这是一个正在进行的草案。问题和拉取请求是受欢迎的，特别是门户目录的更正 - 如果列出的门户错误、失效或缺失，请标记它。
## 支持我们的工作
自由不是免费的。[支持BetaNYC](https://beta.nyc/donate/)。
## 许可
CC BY-SA 4.0 - 版权所有（c）2026 BetaNYC。请参见[`LICENSE`](LICENSE)获取完整条款。
