cognizant-ai-lab/neuro-san-studio

# Neuro SAN Studio **您构建智能多智能体系统的跳板。** Neuro SAN Studio 是一个用于 [Neuro SAN](https://github.com/cognizant-ai-lab/neuro-san) 框架的实践演练场，提供可直接运行的示例、教程和 工具，让您能在几分钟而非几个月内设计、测试和部署复杂的智能体网络。无论您是 探索自适应 AI 系统的研究人员、进行生产解决方案原型的开发者，还是无需编写代码即可配置 智能体的领域专家，本工作室都能处理复杂的编排工作，让您可以专注于解决实际问题。

Neuro SAN 是支持 Cognizant Neuro® AI 多智能体加速器的开源库，允许领域专家、 研究人员和开发人员立即开始跨任何行业垂直领域进行智能体网络的原型设计和构建。

Neuro SAN library

## 什么是 Neuro SAN？ [**Neuro AI 智能体网络系统 (Neuro SAN)**](https://github.com/cognizant-ai-lab/neuro-san) 是一个开源的、 数据驱动的多智能体编排框架，旨在简化和加速协作式 AI 系统的开发。它允许用户——从机器学习工程师到业务领域专家——无需 大量编码，即可通过声明式配置文件（采用 HOCON 格式）快速构建复杂的 多智能体应用程序。 Neuro SAN 支持多个由大型语言模型 (LLM) 驱动的智能体协同解决复杂任务，并通过 自适应的智能体间通信协议动态委派子任务。这种方法解决了单智能体 系统固有的局限性，因为在单智能体系统中，没有任何单一模型能具备解决复杂问题 所需的所有专业知识或上下文背景。 | 几分钟内构建多智能体网络 | Neuro SAN 概述 | 快速启动 | |-------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------|--------------------------------------------------------------------------| | [](https://www.youtube.com/watch?v=wGxvPBN34Mk) | [](https://www.youtube.com/watch?v=NmniQWQT6vI) | [](https://youtu.be/gfem8ylphWA) | ### ✨ 核心功能 * **🗂️ 数据驱动配置**：整个智能体网络通过简单的 HOCON 文件进行声明式定义，使 技术和非技术相关人员都能直观地设计智能体交互。 * **🔀 自适应通信（[AAOSA 协议](https://arxiv.org/abs/cs/9812015)）**：智能体自主决定如何 委派任务，通过去中心化的决策实现流畅、动态的交互。 * **🔒 Sly-Data**：Sly Data 促进在智能体之间安全地处理和传输敏感数据，而不会将其 直接暴露给任何语言模型。 * **🧩 动态智能体网络设计器**：包含一个称为 Agent Network Designer 的元智能体——本质上，它是一个 用于创建其他智能体网络的智能体。作为 Neuro SAN 的示例提供，它可以接收用例的 高级描述作为输入，并为其生成新的自定义智能体网络。 * **🛠️ 灵活的工具集成**：将自定义的基于 Python 的“代码工具”、API、数据库甚至外部 智能体生态系统（Agentforce、Agentspace、CrewAI、MCP、A2A 智能体、LangChain 工具等）无缝集成到您的智能体工作流中。 * **📈 强大的可追溯性**：详细的日志记录、追踪和会话级指标增强了透明度、调试和 运营监控能力。 * **🌐 可扩展且与云平台无关**：兼容各种 LLM 提供商（OpenAI、Anthropic、Azure、Ollama 等），并可在各种环境（本地机器、容器或云基础设施）中部署。 ### 应用场景 以下是使用 Neuro SAN 实现的几个应用场景示例。 如需获取更多示例，请查看 [docs/examples.md](docs/examples.md)。

智能体网络	应用场景	描述
🧬 智能体网络设计器 (Agent Network Designer)	自动生成多智能体 HOCON 配置。	从自然语言输入生成复杂的多智能体配置，简化复杂 智能体工作流的创建过程。
🛫 航空公司政策助手	航空公司政策的客户支持。	智能体解释并说明航空公司政策，协助客户解答有关行李限额、取消航班 和与旅行相关的问题。
🏦 银行业务与合规	自动化金融操作和监管合规。	自动化交易监控、欺诈检测和合规报告等任务，确保遵守 法规并高效执行日常运营。
🛍️ 消费品 (CPG)	CPG 领域的市场分析和产品开发。	收集并分析市场趋势、客户反馈和销售数据，以支持产品开发和战略性 市场营销。
🛡️ 保险智能体	理赔处理和风险评估。	自动化理赔评估，评估风险因素，确保符合政策，并提高理赔处理效率 和客户满意度。
🏢 内网智能体	内部知识管理和员工支持。	为员工提供对政策、人力资源和 IT 支持的快速访问，加强内部沟通和资源 获取能力。
🛒 零售运营与客户服务	提升零售客户体验和运营效率。	处理客户咨询、管理库存并支持销售流程，以优化运营和服务 质量。
📞 电信网络支持	技术支持和网络问题解决。	诊断网络问题，指导故障排除并升级复杂问题，从而减少停机时间并提升 客户服务。
📞 治疗情境监督	为给定的治疗情境生成治疗计划。	这是多个不同的专家智能体协同工作以制定单一计划的优秀示例。

以及更多内容：请查看 [docs/examples.md](docs/examples.md)。 ## 高层架构

## 安装 以下说明适用于 Linux 和 macOS 系统。请针对 Windows 系统相应地调整命令。 ### 安装 `uv` [`uv`](https://docs.astral.sh/uv/) 是由 Astral 构建的快速 Python 包和项目管理器。 官方安装文档： 👉 [https://docs.astral.sh/uv/getting-started/installation/](https://docs.astral.sh/uv/getting-started/installation/) ### 创建新的 Python 项目 为您的项目创建一个文件夹： ``` mkdir my_project cd my_project ``` 创建虚拟环境，初始化 git 仓库并安装 `neuro-san-studio` ``` uv init uv venv source .venv/bin/activate uv add neuro-san-studio ``` ### 初始化 neuro-san-studio 运行 `ns init` 来初始化一个 Neuro SAN Studio 项目。`ns` 代表 Neuro SAN。您也可以使用长命令 `neuro-san-studio` 代替。它将： * 让您选择 LLM 提供商 * 创建一个 `config` 文件夹，包含您选择的 LLM 模型和插件配置 * 创建一个 `mcp` 文件夹，包含 MCP 工具列表 * 创建一个 `registries` 文件夹，包含一个简单的智能体网络 要了解有关 `ns` 命令的更多信息，请运行 `ns --help`。 ``` ns init ``` ``` Which LLM providers do you want to enable? # Provider Default model 1 OpenAI gpt-5.2 (default) 2 Anthropic claude-sonnet 3 Google Gemini gemini-3-flash Enter numbers separated by commas (default: 1): ``` ### 设置您的 LLM API 密钥 1. 设置您的提供商密钥，例如 `OPENAI_API_KEY`、`ANTHROPIC_API_KEY` 或 `GOOGLE_API_KEY` （或在当前目录下创建一个 `.env` 文件）。 详情和其他提供商请参见 [docs/api_key.md](docs/api_key.md)。 export OPENAI_API_KEY="XXX" 2. 检查您的 LLM API 密钥是否配置正确： ns check-llm-keys 3. 检查您的 `config/llm_config.hocon` 是否正常工作： ns check-config 如果配置有效，您将收到来自配置的 LLM 的 `hello` 响应。 ### 导入智能体网络 您可以使用 `ns import` 命令导入随 `neuro-san-studio` 附带的智能体网络。 它将运行一个交互式提示。例如，您可以导入 `root` 智能体网络，以使用 智能体网络设计器来创建您自己的智能体网络。 详情请参见 [`docs/cli/import.md`](docs/cli/import.md)。 ``` ns import ``` 显示以下提示： ``` [info] Discovering available agent networks... ? What do you want to import? (Use arrow keys) Basic (17) Experimental (9) Industry (22) » Root (6) Tools (28) --------------- Custom selection All (82) ``` 选择 `root` 并按回车键。输入 `Y` 确认导入列出的智能体网络。 从 `Experimental` 中，还需导入： ``` ● cruse_theme_agent » ● cruse_widget_agent ``` 以启用 CRUSE，这是一个能根据用户/智能体需求调整 UI 的交互式 UI。 ### 启动开发者 UI 您可以使用 `ns run` 命令启动 `neuro-san` 服务器和 `nsflow` UI： ``` ns run ``` Neuro SAN 服务器监听 `localhost:8080`。 nsflow UI 服务于 [http://localhost:4173/](http://localhost:4173/)。 日志位于 `logs/`（`server.log`、`nsflow.log`、`thinking_dir/`）目录下。 截图：  ### 智能体网络设计器 使用智能体网络设计器创建您自己的智能体网络。 1. 在 `nsflow` UI 中，点击屏幕顶部居中的 `NEW` 按钮。  2. 在打开的新窗口中，在屏幕右下角的文本框中 输入您的提示。然后智能体网络设计器将： * 创建智能体 * 将它们连接在一起 * 为每个智能体编写指令 * 生成一些您可以向该智能体网络提问的示例查询 * 将智能体网络保存在 `registries/generated` 文件夹中 3. 一旦智能体网络设计器完成并在聊天窗口中返回答案， 您可以通过要求其进行更改来继续设计 4. 一旦您对设计感到满意，就对其进行测试！点击屏幕顶部居中的 蓝色 `Launch` 按钮。它会打开一个新窗口，您可以从中与智能体网络进行聊天。 5. 如果您想进行修改，请返回编辑器窗口并要求更改。 6. 您也可以通过在主窗口中点击其名称旁边的笔形图标来编辑任何智能体网络。 ### 从文件导入项目 / 导出为文件 您可以使用 `ns import ` 从 .hocon 文件或 zip 文件导入项目。 ``` ns import ~/Downloads/my_project.hocon ``` 同样，您可以使用 `ns export` 命令导出智能体网络及其所有依赖项： ``` ns export my_project.hocon ``` 详情请参见 [`docs/cli/export.md`](docs/cli/export.md)。 ### 命令参考 | 命令 | 目的 | 关键标志 | |---------------------|------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | `ns init` | 在当前目录下搭建一个启动项目。 | `--providers openai,anthropic,google` | | `ns run` | 启动 Neuro SAN 服务器和 nsflow UI。 | `--server-host`, `--server-http-port`, `--nsflow-port`, `--log-level`, `--client-only`, `--server-only` | | `ns chat` | 直接与智能体网络聊天（无需服务器）。 | 位置参数：智能体名称，`--connection`, `--host`, `--port`, `--one-shot`, `--list`。 | | `ns import` | 将智能体网络导入到当前项目。 | 位置参数：以空格分隔的组名、网络名或 `all`；或者是本地 `.hocon` / `.zip` 路径（不要混合使用两者）。使用 `--force` 覆盖。省略参数则进入交互。 | | `ns export` | 将当前项目中的网络打包成可共享的文件。 | 位置参数：网络名称（例如 `music_nerd` 或 `basic/music_nerd`）。`-o` / `--output` 设置输出路径。省略参数则进入交互式选择器。 | | `ns check-llm-keys` | 验证 LLM API 密钥 / 环境变量。 | `--tier 1` (占位符), `--tier 2` (格式), `--tier 3` (实时 API 调用，默认值) | | `ns check-config` | 验证 HOCON 文件中的 LLM 配置。 | `--hocon-path` (默认为 `config/llm_config.hocon`) | 使用 `ns --help` 查看任何子命令的完整标志列表。 ## 用户指南 准备好深入了解了吗？请查看[用户指南](docs/user_guide.md)以获取关于 neuro-san 库 及其功能的详细概述。 ## 教程 如需详细教程，请参阅 [docs/tutorial.md](docs/tutorial.md)。 ## 示例 有关智能体网络的示例，请查看 [docs/examples.md](docs/examples.md)。 ## 开发者指南 如需开发指南，请查看 [docs/dev_guide.md](docs/dev_guide.md)。 ## 社区项目 ### 应用程序 * [气候变化](https://github.com/cognizant-ai-lab/neuro-san-cc)： 一个使用 UNFCCC 文档回答有关 COP、《巴黎协定》或《京都议定书》问题的工具。 * [企业访问门户](https://github.com/M-Elsaied/enterprise-access-portal)： 一个由 AI 驱动的多智能体系统，用于管理企业应用程序访问请求和 IT 运营。 * [F1 车迷评估](https://github.com/deepsaia/f1-fan-eval)： 一个评估 F1 车迷关于为什么他们是最大的 F1 车迷的提交内容的应用程序。 * [PDF 知识助手](https://github.com/M-Elsaied/neuro-san-studio/tree/pdf-knowledge-base/apps/pdf_knowledge_assistant)： 一个 Flask Web 应用程序，使用 RAG 查询 PDF，并通过基于主题的跨文档长期记忆合成技术。 * [循环智能体](https://github.com/babakatwork/loopy_agent)： 通过单独的服务连续或在触发时运行 Neuro SAN 智能体，并支持异步消息传递。 * [年度报告阅读器](https://github.com/shrushtiimehta/neuro-san-annual-report-reader)： 分析 LinkedIn 个人资料，并提供 Cognizant 2024 年度报告的个性化摘要， 呈现与用户所在行业和资历级别最相关的内容。 * [Tochiro 文件整理器](https://github.com/ofrancon/tochiro)： 一个带有专用 UI 的 macOS 文件整理助手，用于分析文件夹、 制定文件移动计划、请求批准并执行移动操作。 ### 实用工具 * [Neuro SAN Web 客户端](https://github.com/cognizant-ai-lab/neuro-san-web-client)： Neuro SAN 的基本 Flask Web 客户端界面。 * [Neuro SAN Slack 应用](./apps/slack/README.md) 一个 Slack 集成，允许您直接从工作区与 Neuro SAN 进行交互。 ## 链接 * 网站：[Cognizant AI Lab](https://www.cognizant.com/us/en/ai-lab) * YouTube：[Decision AI](https://www.youtube.com/@decision-ai) * X：[@cognizantailab](https://x.com/cognizantailab) * LinkedIn：[Cognizant AI Lab](https://www.linkedin.com/showcase/cognizant-ai-lab) ## 更多详情 欲了解更多信息，请查看 [Cognizant AI Lab Neuro SAN 着陆页](https://www.cognizant.com/us/en/ai-lab/neuro-san)。

标签：AI风险缓解, Petitpotam, 逆向工具