安全公告 — 恶意 litellm 版本 1.82.7 与 1.82.8 已从 PyPI 移除（存在 API 密钥外泄风险）。请卸载、轮换已暴露凭据，并升级至安全版本（如 1.82.9+）。运行 pip show litellm 以确认。 PyPI · README

指南

Python / Near 路径上的 HOWTO。

指南

这些页是第一次跑通。概念页讲循环；指南是最短的能用路径。

示意图：每篇指南只做一件事——SDK 智能体、路由、Studio、知识库、扩展或部署。

指南	什么时候用
第一个智能体	要用 `AgentExecutor(llm_provider=).run(agent=, task=)` 产出报告
多智能体	Meta 该路由 `@`、`delegate_to_avatar` 或 `spawn_subagent`
Studio 服务	Near 或 HTTP 客户端必须连 `agx serve`
知识库与 RAG	文档要走 LiteParse → 向量化 → `knowledge_search`
扩展与技能生态	技能、MCP 或 AGX Bundle 要进入可见集
部署	`create_studio_app()` 要稳住，并把 `~/.agenticx` 留在磁盘