Eigenwise/atomic-agents

这是什么？

核心功能

• 01智能体由系统提示词、Pydantic 输入输出 Schema 和对话历史定义。
• 02上下文提供者可在运行时向系统提示词注入动态信息。
• 03通过对齐输出与输入 Schema，智能体与工具可以直接串联。
• 04兼容 Instructor 支持的模型服务商，包括 OpenAI、Anthropic、Groq、Gemini 和 Ollama。
• 05Atomic Forge 提供搜索、网页抓取、PDF 读取等现成工具。
• 06每次智能体和工具运行都会生成 OpenTelemetry span，便于监控。

适用场景

• 构建需要稳定结构化输出的聊天机器人或信息抽取流水线。
• 基于可复用的工具组件快速搭建 RAG 或网页搜索智能体。
• 在不改动应用逻辑的前提下更换大模型服务商或搜索后端。
• 通过兼容 OpenTelemetry 的后端为大模型应用添加链路追踪。

快速上手

1. 1

   从 PyPI 安装框架

   pip install atomic-agents
2. 2

   如需 OpenAI 以外的模型提供商，安装对应的 SDK（例如 Anthropic）

   pip install instructor[anthropic]
3. 3

   参考 README 中的快速示例编写智能体并用 Python 运行

使用前须知

• !运行智能体需要 OpenAI、Groq、Anthropic 或 Gemini 等模型提供商的 API 密钥。

收录于专题

标签

常见问题

atomic-agents 是什么？

基于 Instructor 与 Pydantic 的轻量级 Python 框架，用于构建模块化、结构化输入输出的 AI 智能体流水线。 Atomic Agents 是一个 Python 框架，用于把基于大模型的智能体和流水线拆分成职责单一的小组件来搭建。每个智能体由系统提示词、输入 Schema、输出 Schema、对话历史以及可选的上下文提供者组成，上下文提供者可以在运行时把动态信息注入提示词。Schema 基于 Pydantic 模型，输入输出都经过校验，行为更可预测。

atomic-agents 可以免费使用吗？用的什么许可证？

atomic-agents 以 MIT 许可证开源。用于商业产品前，请先确认许可证条款。

atomic-agents 还在维护吗？

活跃维护中。atomic-agents 最近一次提交是在 2026年10月29日。

atomic-agents 适合用来做什么？

构建需要稳定结构化输出的聊天机器人或信息抽取流水线。 基于可复用的工具组件快速搭建 RAG 或网页搜索智能体。 在不改动应用逻辑的前提下更换大模型服务商或搜索后端。 通过兼容 OpenTelemetry 的后端为大模型应用添加链路追踪。

atomic-agents 怎么安装和运行？

从 PyPI 安装框架: pip install atomic-agents 如需 OpenAI 以外的模型提供商，安装对应的 SDK（例如 Anthropic）: pip install instructor[anthropic] 参考 README 中的快速示例编写智能体并用 Python 运行

在哪里获取 atomic-agents？

源代码和安装说明在 GitHub 上：https://github.com/Eigenwise/atomic-agents