KSADK Samples 是 AgentEngine / KSADK 的官方场景化代码工坊。仓库默认使用中文 README 和中文注释；Samples 和 Examples 都表示可运行、可部署、可对比框架写法的公开样例。
样例设计会持续参考 ADK Samples、VEADK Examples、AgentKit Samples、DeerFlow、SWE-agent / OpenHands / Aider 等优秀开源 Agent 项目；维护侧对标原则见 Agent 样例对标笔记。
| 场景 | 样例 |
|---|---|
| 基础 Agent（Basic Agent） | ADK / LangGraph / LangChain / DeepAgents |
| 工具调用 Agent（Tool-Using Agent） | ADK / LangGraph / LangChain / DeepAgents |
| 记忆增强 Agent（Memory-aware Agent） | ADK / LangGraph / LangChain / DeepAgents |
| 知识助手（Knowledge Assistant） | ADK / LangGraph / LangChain / DeepAgents |
| 工作流 Agent（Workflow Agent） | LangGraph |
| 深度研究 Agent（Deep Research Agent） | LangGraph |
| 编码 Agent（Coding Agent） | LangGraph |
| 浏览器 Agent（Browser Agent） | LangGraph |
| 数据分析 Agent（Data Analyst） | LangGraph |
| 客服 Agent（Customer Support） | LangGraph |
| 多 Agent 团队（Multi-Agent Team） | LangGraph |
| 运维告警 Agent（AIOps） | LangGraph / ADK / LangChain / DeepAgents |
| 财务审阅 Agent（Finance） | LangGraph / ADK / LangChain / DeepAgents |
| 内容生产 Agent（Content Production） | LangGraph / ADK / LangChain / DeepAgents |
| 企业知识运营 Agent（Knowledge Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 销售运营 Agent（Sales Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 合规审阅 Agent（Compliance Review） | LangGraph / ADK / LangChain / DeepAgents |
| 采购协同 Agent（Procurement Collaboration） | LangGraph / ADK / LangChain / DeepAgents |
| HR 招聘 Agent（HR Recruiting） | LangGraph / ADK / LangChain / DeepAgents |
| 项目管理 Agent（Project Management） | LangGraph / ADK / LangChain / DeepAgents |
| 法务合同 Agent（Legal Contract） | LangGraph / ADK / LangChain / DeepAgents |
| 研发效能 Agent（Dev Productivity） | LangGraph / ADK / LangChain / DeepAgents |
| 产品运营 Agent（Product Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 数据治理 Agent（Data Governance） | LangGraph / ADK / LangChain / DeepAgents |
| 安全审计 Agent（Security Audit） | LangGraph / ADK / LangChain / DeepAgents |
| 客户成功 Agent（Customer Success） | LangGraph / ADK / LangChain / DeepAgents |
| 教育培训 Agent（Education Training） | LangGraph / ADK / LangChain / DeepAgents |
| 供应链计划 Agent（Supply Chain Planning） | LangGraph / ADK / LangChain / DeepAgents |
| 长任务恢复 Agent（Long Task Resume） | LangGraph / ADK / LangChain / DeepAgents |
| 医疗运营 Agent（Healthcare Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 能源调度 Agent（Energy Dispatch） | LangGraph / ADK / LangChain / DeepAgents |
| 政务服务 Agent（Public Service） | LangGraph / ADK / LangChain / DeepAgents |
| 保险理赔 Agent（Insurance Claims） | LangGraph / ADK / LangChain / DeepAgents |
| 制造质量 Agent（Manufacturing Quality） | LangGraph / ADK / LangChain / DeepAgents |
| 零售运营 Agent（Retail Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 物流履约 Agent（Logistics Fulfillment） | LangGraph / ADK / LangChain / DeepAgents |
| 房地产运营 Agent（Real Estate Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 农业生产 Agent（Agriculture Production） | LangGraph / ADK / LangChain / DeepAgents |
| 通信运维 Agent（Telecom Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 旅游服务 Agent（Travel Service） | LangGraph / ADK / LangChain / DeepAgents |
| 设备维护 Agent（Equipment Maintenance） | LangGraph / ADK / LangChain / DeepAgents |
| 媒体运营 Agent（Media Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 金融风控 Agent（Financial Risk） | LangGraph / ADK / LangChain / DeepAgents |
| 城市交通 Agent（Urban Mobility） | LangGraph / ADK / LangChain / DeepAgents |
| 地产营销 Agent（Real Estate Marketing） | LangGraph / ADK / LangChain / DeepAgents |
| 公共安全 Agent（Public Safety） | LangGraph / ADK / LangChain / DeepAgents |
| 工业巡检 Agent（Industrial Inspection） | LangGraph / ADK / LangChain / DeepAgents |
| 环境监测 Agent（Environmental Monitoring） | LangGraph / ADK / LangChain / DeepAgents |
| 餐饮运营 Agent（Restaurant Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 游戏运营 Agent（Game Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 广告投放 Agent（Advertising Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 社群运营 Agent（Community Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 客服质检 Agent（Customer QA） | LangGraph / ADK / LangChain / DeepAgents |
| 门店客服 Agent（Store Service） | LangGraph / ADK / LangChain / DeepAgents |
| 售后服务 Agent（After-sales Service） | LangGraph / ADK / LangChain / DeepAgents |
| 内容安全 Agent（Content Safety） | LangGraph / ADK / LangChain / DeepAgents |
| 直播运营 Agent（Live Commerce Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 会员增长 Agent（Membership Growth） | LangGraph / ADK / LangChain / DeepAgents |
| 搜索推荐 Agent（Search Recommendation） | LangGraph / ADK / LangChain / DeepAgents |
| 支付风控 Agent（Payment Risk） | LangGraph / ADK / LangChain / DeepAgents |
| 智能导购 Agent（Shopping Assistant） | LangGraph / ADK / LangChain / DeepAgents |
| DevRel 运营 Agent（DevRel Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 品牌舆情 Agent（Brand Reputation） | LangGraph / ADK / LangChain / DeepAgents |
| 渠道运营 Agent（Channel Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 企业培训 Agent（Enterprise Training） | LangGraph / ADK / LangChain / DeepAgents |
| 合同履约 Agent（Contract Fulfillment） | LangGraph / ADK / LangChain / DeepAgents |
| 招投标协同 Agent（Tender Collaboration） | LangGraph / ADK / LangChain / DeepAgents |
| 园区运营 Agent（Campus Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 物业招商 Agent（Property Leasing） | LangGraph / ADK / LangChain / DeepAgents |
| 客服知识运营 Agent（Support Knowledge Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 活动会务运营 Agent（Event Operations） | LangGraph / ADK / LangChain / DeepAgents |
| 会议纪要 Agent（Meeting Minutes） | LangGraph / ADK / LangChain / DeepAgents |
| 企业 OKR Agent（Enterprise OKR） | LangGraph / ADK / LangChain / DeepAgents |
| 组织知识图谱 Agent（Organization Knowledge Graph） | LangGraph / ADK / LangChain / DeepAgents |
| 目标 | 样例 |
|---|---|
| Deep Research 报告生成 | LangGraph / ADK / LangChain / DeepAgents |
| Coding Workspace + Sandbox | LangGraph / ADK / LangChain / DeepAgents |
| Browser DOM 诊断 | LangGraph / ADK / LangChain / DeepAgents |
| Data Analyst CSV 洞察 | LangGraph / ADK / LangChain / DeepAgents |
| Customer Support 工单分级 | LangGraph / ADK / LangChain / DeepAgents |
| Multi-Agent Team 协作交付 | LangGraph / ADK / LangChain / DeepAgents |
| AIOps 告警分诊 | LangGraph / ADK / LangChain / DeepAgents |
| Finance 报表审阅 | LangGraph / ADK / LangChain / DeepAgents |
| Content Production 传播计划 | LangGraph / ADK / LangChain / DeepAgents |
| Knowledge Operations 知识运营 | LangGraph / ADK / LangChain / DeepAgents |
| Sales Operations Pipeline | LangGraph / ADK / LangChain / DeepAgents |
| Compliance Review 合规审阅 | LangGraph / ADK / LangChain / DeepAgents |
| Procurement Collaboration 采购协同 | LangGraph / ADK / LangChain / DeepAgents |
| HR Recruiting 面试计划 | LangGraph / ADK / LangChain / DeepAgents |
| Project Management 交付计划 | LangGraph / ADK / LangChain / DeepAgents |
| Legal Contract 合同谈判 | LangGraph / ADK / LangChain / DeepAgents |
| Dev Productivity 研发效能 | LangGraph / ADK / LangChain / DeepAgents |
| Product Operations 实验复盘 | LangGraph / ADK / LangChain / DeepAgents |
| Data Governance 质量审计 | LangGraph / ADK / LangChain / DeepAgents |
| Security Audit 威胁评审 | LangGraph / ADK / LangChain / DeepAgents |
| Customer Success 健康复盘 | LangGraph / ADK / LangChain / DeepAgents |
| Education Training 学习辅导 | LangGraph / ADK / LangChain / DeepAgents |
| Supply Chain Planning 需求计划 | LangGraph / ADK / LangChain / DeepAgents |
| Long Task Resume 长任务恢复 | LangGraph / ADK / LangChain / DeepAgents |
| Healthcare Operations 护理协同 | LangGraph / ADK / LangChain / DeepAgents |
| Energy Dispatch 负荷平衡 | LangGraph / ADK / LangChain / DeepAgents |
| Public Service 事项协同 | LangGraph / ADK / LangChain / DeepAgents |
| Insurance Claims 理赔审核 | LangGraph / ADK / LangChain / DeepAgents |
| Manufacturing Quality 缺陷分析 | LangGraph / ADK / LangChain / DeepAgents |
| Retail Operations 门店优化 | LangGraph / ADK / LangChain / DeepAgents |
| Logistics Fulfillment 履约异常 | LangGraph / ADK / LangChain / DeepAgents |
| Real Estate Operations 资产服务 | LangGraph / ADK / LangChain / DeepAgents |
| Agriculture Production 农事计划 | LangGraph / ADK / LangChain / DeepAgents |
| Telecom Operations 网络割接 | LangGraph / ADK / LangChain / DeepAgents |
| Travel Service 行程恢复 | LangGraph / ADK / LangChain / DeepAgents |
| Equipment Maintenance 维修计划 | LangGraph / ADK / LangChain / DeepAgents |
| Media Operations 内容分发 | LangGraph / ADK / LangChain / DeepAgents |
| Financial Risk 风险预警 | LangGraph / ADK / LangChain / DeepAgents |
| Urban Mobility 交通响应 | LangGraph / ADK / LangChain / DeepAgents |
| Real Estate Marketing 线索转化 | LangGraph / ADK / LangChain / DeepAgents |
| Public Safety 事件联动 | LangGraph / ADK / LangChain / DeepAgents |
| Industrial Inspection 安全巡检 | LangGraph / ADK / LangChain / DeepAgents |
| Environmental Monitoring 污染响应 | LangGraph / ADK / LangChain / DeepAgents |
| Restaurant Operations 门店协同 | LangGraph / ADK / LangChain / DeepAgents |
| Game Operations 版本复盘 | LangGraph / ADK / LangChain / DeepAgents |
| Advertising Operations 投放优化 | LangGraph / ADK / LangChain / DeepAgents |
| Community Operations 社群增长 | LangGraph / ADK / LangChain / DeepAgents |
| Customer QA 服务质检 | LangGraph / ADK / LangChain / DeepAgents |
| Store Service 门店客服 | LangGraph / ADK / LangChain / DeepAgents |
| After-sales Service 售后协同 | LangGraph / ADK / LangChain / DeepAgents |
| Content Safety 内容审核 | LangGraph / ADK / LangChain / DeepAgents |
| Live Commerce Operations 直播场控 | LangGraph / ADK / LangChain / DeepAgents |
| Membership Growth 会员增长 | LangGraph / ADK / LangChain / DeepAgents |
| Search Recommendation 相关性诊断 | LangGraph / ADK / LangChain / DeepAgents |
| Payment Risk 支付风控 | LangGraph / ADK / LangChain / DeepAgents |
| Shopping Assistant 智能导购 | LangGraph / ADK / LangChain / DeepAgents |
| DevRel Operations 开发者运营 | LangGraph / ADK / LangChain / DeepAgents |
| Brand Reputation 品牌舆情 | LangGraph / ADK / LangChain / DeepAgents |
| Channel Operations 渠道运营 | LangGraph / ADK / LangChain / DeepAgents |
| Enterprise Training 企业培训 | LangGraph / ADK / LangChain / DeepAgents |
| Contract Fulfillment 合同履约 | LangGraph / ADK / LangChain / DeepAgents |
| Tender Collaboration 招投标协同 | LangGraph / ADK / LangChain / DeepAgents |
| Campus Operations 园区运营 | LangGraph / ADK / LangChain / DeepAgents |
| Property Leasing 物业招商 | LangGraph / ADK / LangChain / DeepAgents |
| Support Knowledge Operations 客服知识运营 | LangGraph / ADK / LangChain / DeepAgents |
| Event Operations 活动会务运营 | LangGraph / ADK / LangChain / DeepAgents |
| Meeting Minutes 会议纪要 | LangGraph / ADK / LangChain / DeepAgents |
| Enterprise OKR 企业 OKR | LangGraph / ADK / LangChain / DeepAgents |
| Organization Knowledge Graph 组织知识图谱 | LangGraph / ADK / LangChain / DeepAgents |
长任务恢复是横向 Runtime 能力样例，见 LangGraph、ADK、LangChain、DeepAgents。它重点演示 checkpoint 列表、ResumeRun、tool receipt 去重、CancelRun 和未配置持久化后端时的降级行为。
cd 02-use-cases/agentengine-toolsets/langgraph
uv pip install -r requirements.txt
uv run agentengine run -i .这个 demo 展示 LangGraph 如何绑定 AgentEngine Toolsets，并覆盖 Skill Space、Skill Runtime、Workspace、Sandbox、知识库和长期记忆的配置边界。未配置平台能力时，demo 会解释缺失项和降级行为，不伪造平台结果。
下面是 02-use-cases/deep-research/langgraph 在本地 agentengine web 中的真实问答录制，展示了一个 LangGraph Deep Research Agent 如何输出研究计划、执行轨迹、证据卡片、反思补查和交付物。
仓库根目录开发：
uv venv
uv pip install -e ".[test]"单个样例运行：
cd 01-tutorials/hello-world/adk
cp ../../../.env.example .env
uv pip install -r requirements.txt
uv run agentengine run -i .
uv run agentengine web .uv pip install -U "ksadk[all]"每个样例默认读取“当前样例目录”的 .env。如果你习惯在仓库根目录维护一份 .env，请先 source .env 或把它复制到要运行的样例目录。
最小 .env：
OPENAI_API_KEY=your-openai-compatible-api-key
OPENAI_MODEL_NAME=gpt-4o-mini非默认 OpenAI endpoint 时再设置 OPENAI_BASE_URL；完整能力集可直接安装 ksadk[all]。
只配置模型时，大多数基础样例可运行；下面变量只在对应能力需要时填写。
| 能力 | 关键环境变量 | 未配置时 |
|---|---|---|
| 云账号 | KSYUN_ACCESS_KEY、KSYUN_SECRET_KEY、KSYUN_REGION=cn-beijing-6 |
不能部署或调用云服务 |
| Skill Space | KSADK_SKILL_SPACE_IDS / SKILL_SPACE_ID、KSADK_PUBLIC_SKILL_SPACE_IDS、KSADK_SKILL_SERVICE_URL、KSADK_SKILL_SERVICE_ACCESS_KEY |
只能提示缺少 Space、endpoint 或凭证 |
| Skill Runtime | local_process 配 KSADK_SKILL_RUNTIME_AGENT_PATH；e2b 配 KSADK_SANDBOX_TEMPLATE_ID、E2B_API_URL、E2B_API_KEY |
可发现 Skill，但不执行 workflow |
| Workspace | 本地 agentengine run/web 自动注入；远端由 AgentEngine runtime 注入 |
不能读写会话 workspace 文件 |
| Sandbox | KSADK_SANDBOX_BACKEND=e2b、KSADK_SANDBOX_TEMPLATE_ID、E2B_API_URL、E2B_API_KEY |
run_command / run_code 返回不可用 |
| 知识库 | KSADK_KB_DATASET_ID、KSADK_KB_ENDPOINT、KSADK_KB_REGION、KSADK_KB_TOP_K |
RAG demo 使用本地 corpus |
| 长期记忆 | KSADK_LTM_BACKEND、KSADK_LTM_INDEX、KSADK_LTM_NAMESPACE、KSADK_LTM_HTTP_URL |
记忆 demo 使用本地示例记忆 |
完整解释见主推 demo：02-use-cases/agentengine-toolsets/langgraph/README.md。
- 文档：https://kingsoftcloud.github.io/ksadk-python/
- KSADK 仓库：https://github.com/kingsoftcloud/ksadk-python
- Wiki：https://zread.ai/kingsoftcloud/ksadk-python
- Web UI 仓库：https://github.com/kingsoftcloud/ksadk-web
- PyPI：https://pypi.org/project/ksadk/
- 开源协议：Apache-2.0
uv run python scripts/validate_samples.py
uv run pytest -q
make public-preflightvalidate_samples.py 会检查样例结构、README 必备章节、Python 语法 smoke 和敏感内容扫描；public-preflight 是公开同步或发布前门禁。
后续会继续补充更多框架版本和更重的行业样例。新增样例只有在本地可运行、可部署、可脱敏验证、README 足够完整时，才会加入代码目录。
- 为更多场景补充框架版本；当前报告生成、工作区沙箱、浏览器 DOM 诊断、CSV 洞察、工单分级、团队协作、AIOps 告警分诊、财务报表审阅、内容生产、企业知识运营、销售运营、合规审阅、采购协同、HR 招聘、项目管理、法务合同、研发效能、产品运营、数据治理、安全审计、客户成功、教育培训、供应链计划、长任务恢复、医疗运营、能源调度、政务服务、保险理赔、制造质量、零售运营、物流履约、房地产运营、农业生产、通信运维、旅游服务、设备维护、媒体运营、金融风控、城市交通、地产营销、公共安全、工业巡检、环境监测、餐饮运营、游戏运营、广告投放、社群运营、客服质检、门店客服、售后服务、内容安全、直播运营、会员增长、搜索推荐、支付风控、智能导购、DevRel 运营、品牌舆情、渠道运营、企业培训、合同履约、招投标协同、园区运营、物业招商、客服知识运营、活动会务运营、会议纪要、企业 OKR 和组织知识图谱已覆盖 LangGraph / ADK / LangChain / DeepAgents。
- 增加更多真实 Web UI GIF 和端到端部署录屏；当前已提供 Deep Research Web UI 演示。
- 增加更多行业场景，如预算管理、成本优化和供应商绩效。
- 长任务恢复已补多框架工程版本；后续可继续接真实 Postgres session backend 和平台 run/session 事件。