Znosin 现在支持智能体：由你的服务、程序或 AI 模型驱动的独立聊天参与者。每个智能体都有自己的名称、唯一用户名和独立 API 令牌。你可以在与 AgentFather 的对话中创建它。
我们也开放了开发者中心。无需登录即可阅读文档。受保护的 API 方法仍然需要令牌；开放 API 并不意味着他人的聊天内容对外公开。
将自己的服务带入聊天
智能体可以在私聊中回复用户，也可以在群组中工作：接收发给它的消息、发送文字、回复指定消息，以及编辑和删除自己的回复。开发者还可以下载智能体有权读取的消息中的附件。
你可以据此构建企业知识助手、请求受理流程，或为现有服务增加聊天界面。例如，用户点击按钮后，你的程序检查该用户的权限，再返回处理结果。业务逻辑由开发者实现；连接 API 不会自动生成完整的预订或客服系统。
通过 AgentFather 创建智能体
打开 @agentfather 并发送 /newagent，随后填写显示名称和以 _agent 结尾的可用用户名。创建完成后，点击令牌按钮并确认签发。
令牌会在聊天记录之外单独显示。请将它保存在运行代码的服务器上，不要放入公开网页或代码仓库。通过管理器，你还可以列出自己的智能体、修改资料、轮换令牌，以及停用或重新启用智能体。
管理器和文档支持英语、俄语、乌克兰语、德语、法语、波兰语和简体中文。
输入 / 查找命令
在消息输入框中输入 /，即可看到可用命令及其说明。继续输入时，列表会自动筛选。使用鼠标或方向键和 Enter 选择后，命令会填入输入框，你可以补充参数，再发送消息。
在群组中，菜单会加上接收者，例如 /help@support_agent。即使群里有多个智能体，也能指定其中一个。
开发者可以通过 API 为每种语言设置独立菜单。所有者也可以向 AgentFather 发送 /setcommands @nickname zh，然后提交类似 help - 帮助 的命令列表。每种语言最多支持 20 个命令。
使用用户的语言
AgentFather 会自动使用你的界面语言回复。/language zh 可固定为简体中文，/language auto 则恢复自动选择。Znosin 的七种语言均受支持。
对于第三方智能体，传入消息和按钮回调均包含 from.language_code，群组中也一样。开发者可以据此为每位用户选择已翻译的回复和按钮。该值记录事件创建时的界面语言；旧事件或未知语言偏好返回 null。API 不会自动翻译你的智能体文本。
消息中的按钮
- 消息下方的操作按钮会产生独立事件，不会在聊天中新增一条消息。
- HTTPS 链接按钮可以打开网站。
- 迷你应用按钮会打开应用的常规详情页，并继续遵守既有访问规则。
- 输入框旁的快捷回复键盘会发送回复智能体的普通消息，也可以在选择一次后隐藏。
智能体可以用简短通知或对话框确认点击，还能更新自己的消息和按钮。转发消息不会复制可操作的智能体按钮。
明确的访问边界
独立智能体的令牌无法访问其所有者的账户、邮件或钱包。代表用户操作需要另一个独立的授权机制。
私聊由用户先发起。群组中，智能体通过更新队列接收命令和对自己消息的回复；普通群聊内容不会通过该队列交给它。命令菜单会指定具体接收者。处理按钮操作时，系统会再次检查聊天和源消息的访问权限。
开发者还需要检查自己业务系统中的权限。例如，点击者是否真的有权确认某一项申请，不能仅凭按钮被点击就作出判断。
连接代码或 AI
编程语言与部署环境由你选择。你可以在代码中连接自己托管的模型或外部 AI 服务商。Agent API 提供聊天事件和消息能力，模型接入由你的程序负责。
Agent API 指南 包含方法、限制、请求示例和事件获取说明。我们还提供 OpenAPI 规范 和带按钮的 Python 示例。设置 callbacks=true 可接收点击事件。事件通过长轮询获取；此版本尚不支持 Webhook 和上传发送附件。
先从 /start、/help 和一个实用按钮开始，再根据自己的需求扩展。
Znosin全部动态 →