# Fóir：你的智能体在其上构建的后端

Fóir 通过一个配置文件为应用提供完整的后端：GraphQL API、供你的团队使用的控制台、登录和角色，以及你的客户数据之间的隔离。编程智能体可以编写配置，并通过 MCP 服务器运行项目，因此它构建的应用已准备好服务真实客户。

这是 foir.io 的纯文本版本，供智能体以及更愿意阅读而不是观看的人使用。

创建项目：[https://platform.foir.io/signup](https://platform.foir.io/signup)

## 从智能体开始

连接 MCP 服务器，并从那里读取契约。它会列出你的角色允许使用的工具，并可搜索文档。

```
foir mcp
```

- MCP 设置：[https://docs.foir.dev/ai/mcp](https://docs.foir.dev/ai/mcp)
- 面向智能体的文档索引：[https://docs.foir.dev/llms.txt](https://docs.foir.dev/llms.txt)
- 单个文件中的完整文档：[https://docs.foir.dev/llms-full.txt](https://docs.foir.dev/llms-full.txt)

## 团队为什么选择它

- 一个配置文件就能提供原本需要用多个独立服务拼装的后端：数据库规则、登录、内容编辑器、媒体分发、通知和计费。
- 客户隔离在数据库中强制执行。访问规则编译为行级安全，因此即使有人漏掉了某项检查，也不会泄露任何一行数据。
- API 由你的模型生成，因此不存在会出错的手写端点。
- 内容在每次请求时解析。新的语言或受众只是你设置的一个字段，无需重新构建任何东西。
- 它是全托管的。无需托管、打补丁或扩容。
- 你始终掌握控制权。你的代码运行在你自己的托管环境中，付款直接进入你自己的 Stripe 账户，每条记录都能导出到你拥有的 Postgres 数据库。
- 智能体可以在其中安全地工作。写入以草稿形式保存，令牌只携带你批准的权限，由人来确认哪些内容上线。
- 它的授权引擎 Demesne 是开源的：[https://foir.io/demesne](https://foir.io/demesne)

## 适用对象

- 卖给众多客户的产品。每个客户都是一个组织，在共享模型之上拥有自己的数据、成员和登录。
- 用编程智能体构建的应用，已准备好支持真实登录、角色和数据隔离。
- 在一个平台上运行众多客户项目的代理机构。
- 以内容为主导、需要草稿、定时活动和个性化的网站或应用。

## 你能得到什么

| Capability | 作用 |
| --- | --- |
| 生成的 API | 基于你的模型构建的 GraphQL API。 |
| 控制台 | 每个模型都有编辑器，带版本、实时协作编辑，以及以受众身份预览。 |
| Ask Fóir | 控制台中的助手，回答关于你数据的问题，并在你的角色范围内以草稿形式做出更改。 |
| 登录 | 一个托管登录：通行密钥、两步验证，以及 Google、Apple、Shopify 或任何 OIDC 提供方。 |
| 用户和角色 | 同一套用户按池组织，成员关系和角色都由同一份权限列表构建。 |
| 组织 | 把应用变成 SaaS：你的每个客户都有一道以行级安全强制执行的边界。 |
| 密钥 | 可公开密钥、服务器密钥和管理员密钥。一个密钥的 schema 只包含授予它的内容。 |
| 记录 | 记录可以设为私有，仅属于拥有它的用户。更新接受幂等键，因此重试是安全的。 |
| 发布 | 写入以草稿形式保存。发布无需重新构建。上线会把一个活动一起发布，并且可以回滚。 |
| 个性化 | 变体在服务器端根据位置、分群和你自定义的维度选择。一个变体可以替换整条记录或单个字段。 |
| 操作 | 你自己的代码，通过 API 调用，附带签名且限定作用域的令牌。每次运行都会被记录。 |
| 机密 | 一个保管库。函数和智能体只持有引用，从不持有密钥本身。 |
| 钩子 | 记录事件和操作事件会运行操作，投递可以重新发送。 |
| 付费墙 | 按用户或组织对任意操作设定配额，可通过在 Stripe 或应用商店购买的订阅提高。 |
| 通知和邮件 | 推送通知和收件箱通知，支持按人设置偏好。邮件模板在发送时用记录填充。 |
| 媒体、搜索、位置 | 图片以 WebP 和 AVIF 格式按每块屏幕的尺寸提供。按语义搜索。距离查询。 |
| 工作 | 在线上页面留下的备注会变成任务。智能体起草，人来审批。 |
| 智能体 | 长期运行的智能体通过 MCP 让内容保持最新，所用的密钥限定了它能更改的范围。 |
| 应用 | 控制台内你的应用自己的管理页面，以及让另一个系统的记录保持同步的集成。 |
| 导出 | 每条记录都能导出到你拥有的 Postgres 数据库。 |

每种情况在文档中都有对应页面：[https://docs.foir.dev](https://docs.foir.dev)

## 项目如何开始

1. 一个人在以下地址创建账户：[https://platform.foir.io/signup](https://platform.foir.io/signup)。这一步需要浏览器。
2. `foir workspaces create --name acme --select`
3. 编写 `foir.config.ts`，定义你的模型，然后运行 `foir push`。
4. 运行 `foir mcp`，让智能体能以已登录用户的身份在项目中工作。

## 须知

- 位置、登录状态和分群都在服务器端确定，因此无法通过修改请求来伪造个性化。
- 包含已解析变体的响应会被标记为私有，因此共享缓存永远不会把一位访客的版本提供给另一位访客。
- Fóir 与 Supabase、Firebase、Sanity、Payload 等产品的对比：[https://foir.io/compare](https://foir.io/compare)
- 定价：[https://foir.io/pricing](https://foir.io/pricing)