内容
# 工具列表
> 1С:企业 8.3 配置扩展，用于集成语言模型（LLM）：
> 统一的提供商连接器、工具代理循环、RAG、MCP 服务器、
> 使用 AI 分析的错误监控和图表生成器。
[](https://opensource.org/licenses/MIT)
[](https://1c.ru)
[](https://github.com/andromanpro/1c-ai-connector/releases)
[](#-代码质量)
## 🎯 关于项目
**AI 连接器（KIИ - 人工智能连接器）** 是一个 1С 扩展，用于直接从 1С 使用语言模型。从 1.3.0 版本开始，它是一个 AI 子系统平台：
在连接器之上运行的代理循环、知识库语义搜索（RAG）、外部 AI 代理的 MCP 服务器、错误监控和图表生成器。
作为配置扩展安装，不会更改主配置。
**开箱即用的场景：**
- 🚨 数据库错误监控：从注册日志中收集、AI 诊断、Telegram 通知
- 🔍 代码审计：错误位置 + 原因解释
- 🛠 1С 数据库作为 Claude/Cursor 工具集（MCP）
- 📊 根据文本描述生成图表（mermaid/plantuml/graphviz/bpmn）
**API 用于您自己的解决方案：**
- 🤖 客户支持聊天机器人
- 📝 内容生成（产品描述、文档）
- 🔍 文本分类和结构化数据提取
- 📚 基于知识库的答案（RAG）
- 🎯 使用 1С 工具自行处理数据的代理
## ✨ 功能
### 连接器（核心）
- **五种提供商格式**，每种格式都有单独的连接器：OpenAI 兼容 API、Anthropic、Google Gemini、YandexGPT、GigaChat - 以及预设中 25+ 个现成的模型。
- **同步和异步请求**（后台任务）、消息历史、系统提示。
- **多模态**：请求附件中的图像和文档、响应中的图像生成。
- **答案缓存**，带有 TTL（每个模型，开启时）、完整的请求日志记录（令牌、时间、错误）、代理支持、OAuth2（GigaChat）、IAM（Yandex）。
- **具有指数回退的重试** - 仅限瞬时代码（429/5xx），无重复 POST。
### 代理循环（function calling）
模型调用 1С 工具并根据结果继续推理 - 支持所有五种提供商格式。轮次和调用限制、重复调用去重、强制最终输出、每个调用的审计。
> 所有提供商格式适配器都经过测试；使用自己的密钥在 OpenAI 兼容模型上进行了实时测试。其他提供商的“支持工具”标志在与自己的密钥进行 smoke 测试后启用。
### RAG - 知识库
知识类别、文档自动切片、带有版本控制的嵌入。知识与专家绑定并自动混合到系统提示中。两种搜索后端：内置（纯 1С，无依赖）和 [Qdrant](https://qdrant.tech) - 带有同步队列和后台检查。
出口策略不会将机密片段释放到知识库之外。
### MCP 服务器
HTTP 服务（JSON-RPC 2.0）：外部 AI 代理将 1С 数据库视为工具集 - 元数据、对象结构、只读查询、图表。
基本身份验证、频率限制、请求白名单、机密隐藏、自动清理审计。 ⚠ 请仅通过 HTTPS（带有 TLS 的反向代理）发布到外部。
### 错误监控
定期从注册日志中收集、规范化和重复数据删除、批量 AI 分析和深入代理分析、带有反垃圾邮件的 Telegram 通知、忽略规则、统计数据、HTML 仪表盘。 此外，代码审计：根据错误查找源代码位置并解释原因。
### 图表生成器
用文字描述生成图表（mermaid / plantuml / graphviz / bpmn）。 Mermaid 使用内置的 mermaid.js 库本地渲染 - 无需外部服务；
其他格式和服务器端渲染（PNG/SVG，MCP 工具）- 通过 [kroki](https://kroki.io)。 带有工具的模型本身读取配置元数据并绘制真实属性。
## 🌐 支持的提供商
| 提供商 | API 格式 | Function calling | 状态 |
|-----------|------------|------------------|--------|
| **OpenAI** (GPT-4/5.x) | OpenAI Compatible | ✅ | ✅ |
| **Anthropic** (Claude) | Anthropic Messages | ✅ 格式已准备 | ✅ |
| **Google** (Gemini) | Google AI | ✅ 格式已准备 | ✅ |
| **DeepSeek** | OpenAI Compatible | ✅ | ✅ |
| **GigaChat** (Сбер) | OAuth2 + legacy functions | ✅ 格式已准备 | ✅ |
| **Yandex** (YandexGPT) | Yandex Cloud | ✅ 格式已准备 | ✅ |
| **Mistral / Qwen / Groq / Grok** | OpenAI Compatible | ✅ | ✅ |
| **Ollama / LM Studio / LiteLLM** (本地) | OpenAI Compatible | 取决于模型 | ✅ |
| **OpenRouter / Together / Fireworks 等** | OpenAI Compatible | ✅ | ✅ |
## 📦 安装
### 要求
- **1С:企业 8.3.24+** - 1.3.0 版本是在 **8.3.27** 上开发和测试的
- **BSP（标准子系统库）3.1.10+** - 在 BSP 3.1.11.392 演示数据库上进行了测试
- 云提供商的互联网访问（本地模型离线工作）
- 可选： [Qdrant](https://qdrant.tech) 用于快速向量搜索， [kroki](https://kroki.io) 用于图表渲染
> 1.0.x 版本也在 1С:ERP 2.5.17 上进行了验证。 1.3.0 版本未在 ERP 上重新验证 - 欢迎在 [Issues](https://github.com/andromanpro/1c-ai-connector/issues) 上报告其他配置的工作报告。
### 安装步骤
1. 从 [Releases](https://github.com/andromanpro/1c-ai-connector/releases) 下载 `.cfe`
2. 连接扩展（管理 → 配置扩展）
3. 更新数据库
4. 打开“AI 模型”目录并点击“填充模型” - 将加载 25+ 个预设
5. 指定所需模型的 API 密钥（存储在 1С 的安全存储中，不会掉落到转储中）；模型表单上的连接测试按钮
6. 创建“AI 专家”：模型 + 系统提示
7. 通过填写其设置来启用新子系统：用于监控的 Telegram 令牌、用于 RAG 的 Qdrant 地址、用于图表的 kroki 地址、用于 MCP 的 API 用户 - 未配置的内容不会工作，但不会干扰其他内容
### 从 1.0.x 升级
标准：模型和专家数据保留，公共 API 兼容（`请求模型`、`请求模型后台`、`模型参数` - 保留签名）。
唯一的行为变化：`KIИ 完全权限` 角色不再授予对主配置对象的权限 - 仅限于扩展对象（关闭多余的权限分配）。
## 🚀 快速开始
### 最简单的请求（3 行代码）
```bsl
模型 = 目录.КИИ_人工智能模型.查找按名称("gpt-4");
回答 = KIИ_人工智能连接器.请求模型(模型, "你好！ 最近怎么样？");
如果 回答.这是错误 那么
通用目的.通知用户(回答.文本回答);
结束如果；
```
### 带有系统提示和历史记录
```bsl
提示 = 新的结构;
提示.插入("系统提示", "你是 1С 程序员助手");
提示.插入("用户提示", "如何创建新文档？");
提示.插入("消息历史", 历史记录); // 可选
回答 = KIИ_人工智能连接器.请求模型(模型, 提示);
```
### 异步请求（后台任务）
```bsl
长时间操作 = KIИ_人工智能连接器.请求模型后台(模型, 提示);
长时间操作.等待完成(长时间操作);
回答 = 从临时存储中获取(长时间操作.结果地址);
```
### Markdown → HTML
```bsl
HTML = KIИ_Markdown解析器客户端服务器.转换为HTML(回答.文本回答);
```
### 无需代码的测试
**“AI 测试”** 处理：与专家聊天、附件（图像/文档）、对话历史、日志查看 - 所有操作均交互式。
## 📚 文档和开发
- **用户指南（wiki）** - [1c-ai-connector-guide](https://github.com/andromanpro/1c-ai-connector-guide)：模型和提供商设置、RAG 和知识库、错误监控和代码审计、MCP 服务器和安全、图表生成器。
- **自动测试（398 个 YAxUnit 测试）** - [1c-ai-connector-tests](https://github.com/andromanpro/1c-ai-connector-tests)；运行测试需要 [YAxUnit](https://github.com/bia-technologies/yaxunit) 在数据库和测试扩展中。
- **用于 stdio 客户端的 MCP 代理** - [1c-ai-connector-mcp-proxy](https://github.com/andromanpro/1c-ai-connector-mcp-proxy)（Claude Desktop 等无 HTTP 传输的客户端）。
## 🔑 获取 API 密钥
<details>
<summary>提供商说明</summary>
### OpenAI
1. [platform.openai.com](https://platform.openai.com) → API 密钥 → 创建密钥
2. 充值余额
### Anthropic (Claude)
1. [console.anthropic.com](https://console.anthropic.com) → API 密钥
### Google (Gemini)
1. [Google AI Studio](https://aistudio.google.com) → 获取 API 密钥
### DeepSeek
1. [platform.deepseek.com](https://platform.deepseek.com) → API 密钥
### GigaChat (Сбер)
1. [developers.sber.ru/gigachat](https://developers.sber.ru/gigachat)
2. 获取 Authorization 密钥（或 ClientId:ClientSecret）- 模块将自行兑换为 OAuth2 令牌
### Yandex GPT
1. [Yandex Cloud](https://console.cloud.yandex.ru) → 服务账户 → API 密钥
2. 在模型中指定文件夹 ID
</details>
## 🔍 代码质量
- ✅ **398 个单元测试**（YAxUnit）：连接器、代理循环、RAG、监控、MCP、解析器
- ✅ **SonarQube（BSL Language Server）：0 个备注**，A/A 评级，技术债务 0；有根据的例外已在代码中用抑制文档记录
- ✅ 通过 EDT 检查（文档注释、区域、角色）
- ✅ 在 BSP 3.1.11.392 演示数据库/8.3.27 平台上测试
## 🗺️ 路线图
### 已完成（v1.3.0）
- [x] Vision API - 附件中的图像和文档 + 图像生成
- [x] 改进的速率限制处理 - 回退，仅重试瞬时代码
- [x] Function calling - 所有五种提供商格式的代理循环
- [x] 嵌入 API - 以及整个 RAG
- [x] 除计划外：MCP 服务器、带有 AI 分析的错误监控、代码审计、图表生成器、397 个自动测试
### 计划
- [ ] 流式传输 - 在纯 BSL 中无法实现（平台一次提供整个 HTTP 响应）；正在研究通过带有轮询的后台任务进行仿真
- [ ] Anthropic/Google/Yandex/GigaChat 上的实时测试调用以及在预设中启用标志
- [ ] CI：每次提交的构建 `.cfe`、测试运行和 Sonar
- [ ] 扩展测试覆盖（工具测量覆盖）
## ❓ 常见问题
<details>
<summary>常见问题</summary>
### 支持哪些 1С 平台？
8.3.24+；1.3.0 版本是在 8.3.27 上开发和测试的。
### 需要 BSP 吗？
是的，BSP 3.1.10+（测试版本为 3.1.11.392）。
### 支持发送图像吗？
是的，从 1.3.0 版本开始：图像和文档作为请求附件，支持生成图像。
### 可以在没有互联网的情况下使用吗？
是的 - 通过 Ollama/LM Studio 的本地模型、内置 RAG 搜索和本地 mermaid 图表渲染也可以在没有外部服务的情况下工作。
### API 密钥存储在哪里？
在 1С 的安全存储中；不会掉落到配置的转储中。
### 如何控制成本？
所有请求都记录在具有令牌和时间的寄存器中；答案缓存减少了重复请求。
### 可以添加自己的提供商吗？
任何 OpenAI 兼容的 API 都开箱即用：创建模型，指定地址，`OpenAI_Compatible` 格式，模型名称和密钥。
### 可以在商业项目中使用吗？
是的，MIT 许可证。
</details>
## 🤝 参与项目
- 🐛 **发现了错误？** - [问题](https://github.com/andromanpro/1c-ai-connector/issues)
- 💡 **有想法？** - [讨论](https://github.com/andromanpro/1c-ai-connector/discussions)
- 🔧 **想帮忙？** - 拉取请求
## 📄 许可证
[MIT](LICENSE) © 2026 安德烈亚诺夫 罗曼 ([androman.pro](https://androman.pro))
## 📞 联系方式
- 🌐 **网站**: [androman.pro](https://androman.pro)
- 💬 **Telegram**: [@andromanpro1c](https://t.me/andromanpro1c)
- 📧 **邮箱**: andromanpro@gmail.com
---
<div align="center">
**由 ❤️ 为 1С 社区制作**
[⭐ 标星](https://github.com/andromanpro/1c-ai-connector) • [💬 讨论](https://github.com/andromanpro/1c-ai-connector/discussions) • [🐛 报告错误](https://github.com/andromanpro/1c-ai-connector/issues)
</div>
连接信息
猜你喜欢
暂无推荐服务器