零代码玩转LLM应用：Bisheng可视化API与用户操作指南

【免费下载链接】bisheng Bisheng is an open LLM devops platform for next generation AI applications. 项目地址: https://gitcode.com/GitHub_Trending/bi/bisheng

项目简介

Bisheng毕昇是一款开源LLM应用开发平台，主攻企业场景，已有大量行业头部组织及世界500强企业在使用。"毕昇"取自活字印刷术发明人，象征着知识传播的革新。该平台提供了从文档解析到多智能体协作的完整解决方案，支持数百个组件与数千个参数的深度调优。

快速上手

环境准备

安装前请确保满足以下条件：

• CPU ≥ 8核
• RAM ≥ 32GB
• Docker 19.03.9+
• Docker Compose 1.25.1+

一键部署

git clone https://gitcode.com/GitHub_Trending/bi/bisheng
cd bisheng/docker
docker compose -f docker-compose.yml -p bisheng up -d

启动后访问 http://IP:3001 即可开始使用，默认第一个注册用户将成为系统管理员。

API文档体系

API架构概览

Bisheng提供了完整的RESTful API接口，主要包含以下模块：

• 用户认证与授权
• 工作流管理
• 知识库操作
• 模型服务
• 助手配置

核心API定义在src/backend/bisheng/api/router.py中，包含了从V1到V2的版本演进。

常用API示例

1. 创建知识库

# 请求示例
POST /api/v1/knowledge
{
  "name": "企业规章制度",
  "description": "公司内部管理文件集合",
  "type": 1
}

# 响应示例
{
  "code": 200,
  "message": "SUCCESS",
  "data": {
    "id": 1,
    "name": "企业规章制度",
    "create_time": "2025-10-16T09:23:45Z"
  }
}

2. 上传知识库文件

POST /api/v1/knowledge/{knowledge_id}/file
Content-Type: multipart/form-data

file: [二进制文件流]
separator: ["。", "！", "？"]
chunk_size: 500
chunk_overlap: 50

API权限控制

Bisheng实现了细粒度的权限管理系统，通过src/backend/bisheng/api/utils.py中的check_permissions函数进行权限验证：

def check_permissions(Authorize: AuthJWT, roles: List[str]):
    # 验证用户角色权限
    Authorize.jwt_required()
    user_roles = Authorize.get_raw_jwt().get("roles", [])
    if not any(role in user_roles for role in roles):
        raise HTTPException(status_code=403, detail="权限不足")

可视化工作流设计

工作流编辑器介绍

Bisheng提供了直观的拖拽式工作流编辑器，支持成环、并行、跑批、判断逻辑等复杂流程设计。用户无需编写代码，只需通过流程图即可构建企业级应用。

工作流创建步骤

1. 登录系统后，点击左侧导航栏"工作流"
2. 点击"新建工作流"按钮
3. 从组件库拖拽所需节点到画布
4. 连接节点并配置参数
5. 保存并发布工作流

核心工作流处理逻辑在src/backend/bisheng/workflow/workflow.py中实现，主要函数包括：

def get_all_flows(cls, user: UserPayload, name: str, status: int, tag_id: Optional[int], flow_type: Optional[int],
                 page: int = 1, page_size: int = 10) -> (list[dict], int):
    # 获取工作流列表
    pass

def run_once(cls, login_user: UserPayload, node_input: Dict[str, any], node_data: Dict[any, any]):
    # 单次运行工作流
    pass

知识库管理

文档上传与解析

Bisheng支持多种格式文档上传，包括PDF、DOCX、PPTX、Excel等，并提供高精度解析能力。系统会自动提取文本、表格、图片等内容，并进行结构化处理。

知识库创建流程

1. 点击"知识库"->"新建知识库"
2. 填写知识库名称和描述
3. 上传文档或输入URL
4. 配置解析参数（切分规则、块大小等）
5. 开始处理并等待完成

文档解析核心代码在src/backend/bisheng/knowledge/knowledge_imp.py中，主要函数：

def process_file_task(
    knowledge: Knowledge,
    db_files: List[KnowledgeFile],
    separator: List[str],
    separator_rule: List[str],
    chunk_size: int,
    chunk_overlap: int,
    callback_url: str = None,
    extra_metadata: str = None,
    preview_cache_keys: List[str] = None,
    retain_images: int = 1,
    enable_formula: int = 1,
    force_ocr: int = 0,
    filter_page_header_footer: int = 0,
):
    # 处理上传的文件并生成向量
    pass

企业级特性

权限管理

Bisheng提供基于角色的细颗粒度权限管理(RBAC)，支持用户组管理、分组流量控制、SSO/LDAP等企业级安全特性。

安全审计

系统内置完整的操作审计日志，记录用户的关键操作，确保合规性和可追溯性。审计日志功能在src/backend/bisheng/api/audit_log.py中实现：

def get_audit_log(cls, login_user: UserPayload, group_ids, operator_ids, start_time, end_time,
                 system_id, event_type, page, limit) -> Any:
    # 获取审计日志
    pass

def user_login(cls, user: UserPayload, ip_address: str):
    # 记录用户登录日志
    pass

应用场景示例

合同审核流程

1. 创建"合同审核"工作流
2. 添加"文件上传"节点接收合同文件
3. 添加"文档解析"节点提取合同内容
4. 添加"合同要素提取"节点识别关键信息
5. 添加"合规检查"节点验证合同条款
6. 添加"结果输出"节点生成审核报告

会议纪要生成

1. 上传会议录音或视频文件
2. 使用"语音转文字"节点生成文本
3. 通过"摘要提取"节点生成会议要点
4. 使用"行动项识别"节点提取待办事项
5. 最后通过"报告生成"节点输出格式化纪要

常见问题解答

系统要求

• 最低配置：CPU 8核，内存32GB
• 推荐配置：CPU 16核，内存64GB
• 支持Docker和Docker Compose环境

如何更新系统

cd bisheng
git pull
cd docker
docker compose -f docker-compose.yml -p bisheng up -d

如何迁移数据

数据迁移功能在src/backend/bisheng/script/convert_sys_embeddings.py中提供，可通过以下命令执行：

python -m bisheng.script.convert_sys_embeddings

资源与支持

• 官方文档
• 应用案例/场景库
• 经验技巧
• 功能使用说明

通过以上内容，您应该已经对Bisheng平台有了基本了解。如需深入学习，可以查看更多官方文档或参与社区讨论。

【免费下载链接】bisheng Bisheng is an open LLM devops platform for next generation AI applications. 项目地址: https://gitcode.com/GitHub_Trending/bi/bisheng