# AgentScope Java: Chinese

## Chinese

### v2

#### 首页

- [AgentScope Java v2](https://java.agentscope.io/v2/zh/intro.md): 构建分布式企业级智能体

#### SDK

##### 快速开始

- [AgentScope 2.0 是什么？](https://java.agentscope.io/v2/zh/docs/index.md): Harness 工程化、企业级分布式部署、底层框架重构。
- [快速开始](https://java.agentscope.io/v2/zh/docs/quickstart.md): 快速上手 AgentScope Java 2.0 —— 用 HarnessAgent 跑通第一个长期运行的智能体

##### 核心组件

- [智能体](https://java.agentscope.io/v2/zh/docs/building-blocks/agent.md): 了解如何在 AgentScope Java 2.0 中定义和配置智能体
- [消息与事件](https://java.agentscope.io/v2/zh/docs/building-blocks/message-and-event.md): 智能体通信，与前端流式数据传输
- [Middleware](https://java.agentscope.io/v2/zh/docs/building-blocks/middleware.md): 在 agent 生命周期的关键位置拦截并扩展行为
- [Model](https://java.agentscope.io/v2/zh/docs/building-blocks/model.md): 在 AgentScope Java 中配置并连接 LLM 模型提供商
- [Permission System](https://java.agentscope.io/v2/zh/docs/building-blocks/permission-system.md): 精细控制 agent 可以执行哪些 tool、何时执行
- [Tool](https://java.agentscope.io/v2/zh/docs/building-blocks/tool.md): 定义、注册并管理 agent 可调用的能力
- [上下文与 AgentState](https://java.agentscope.io/v2/zh/docs/building-blocks/context.md): 无状态 Agent 引擎、AgentState 生命周期、状态持久化与 RuntimeContext

##### Harness

- [Harness 架构](https://java.agentscope.io/v2/zh/docs/harness/architecture.md): HarnessAgent 是什么、各能力如何协作、状态如何在一次 call() 中流转
- [上下文压缩](https://java.agentscope.io/v2/zh/docs/harness/compaction.md): 在不丢失关键信息的前提下,把对话上下文控制在模型的 token 预算内
- [工作区（Workspace）](https://java.agentscope.io/v2/zh/docs/harness/workspace.md): 智能体定义与进化的 source of truth：目录布局、工作区与 API 的等价关系、原生多租户隔离、filesystem 模式、重点内容深入
- [记忆（Memory）](https://java.agentscope.io/v2/zh/docs/harness/memory.md): 双层长期记忆、对话压缩、大工具结果卸载，prompt 与触发策略均可定制
- [文件系统（Filesystem）](https://java.agentscope.io/v2/zh/docs/harness/filesystem.md): 三种部署模式：本机 + shell / 共享存储 / 沙箱；IsolationScope 隔离维度；多用户隔离；技能与工具在各模式下的行为
- [沙箱（Sandbox）](https://java.agentscope.io/v2/zh/docs/harness/sandbox.md): 隔离执行 + 跨调用恢复 + 多副本部署
- [子 Agent（Subagent）](https://java.agentscope.io/v2/zh/docs/harness/subagent.md): 声明子 agent、同步/后台调用、自动反向通知、远程子 agent、流式转发
- [技能（Skill）](https://java.agentscope.io/v2/zh/docs/harness/skill.md): 四层技能合成、技能市场、自学习闭环
- [计划模式（Plan Mode）](https://java.agentscope.io/v2/zh/docs/harness/plan-mode.md): 动手前先想清楚：只读阶段写计划文件，HITL 后再进入执行阶段
- [Channel](https://java.agentscope.io/v2/zh/docs/harness/channel.md): 通过 Channel 路由消息、管理会话、流式传输事件

##### 参考

- [V1 迁移指南](https://java.agentscope.io/v2/zh/docs/change-log.md): 从 AgentScope Java 1.x 升级到 2.0 的完整迁移指南
- [Release Notes](https://java.agentscope.io/v2/zh/docs/others/release-notes.md): AgentScope Java 各版本变更记录
- [上生产（Going to Production）](https://java.agentscope.io/v2/zh/docs/others/going-to-production.md): 从单机原型到多副本分布式部署：AgentStateStore / Filesystem / Skill / Sandbox / 快照 / 观测的组件选型与配置清单
- [FAQ](https://java.agentscope.io/v2/zh/docs/others/faq.md): AgentScope Java 2.0 常见问题

#### 服务

##### 开始使用

- [什么是 AgentScope Service](https://java.agentscope.io/v2/zh/service/index.md)
- [快速开始](https://java.agentscope.io/v2/zh/service/first-session.md)

##### 安装与部署

- [本地安装](https://java.agentscope.io/v2/zh/service/quickstart.md)
- [生产安装](https://java.agentscope.io/v2/zh/service/kubernetes.md)

##### 智能体与任务管理

###### 注册或者创建 Agent

- [注册或者创建 Agent](https://java.agentscope.io/v2/zh/service/agents.md)
- [Managed Agent：创建与测试](https://java.agentscope.io/v2/zh/service/create-managed-agent.md)
- [AgentScope 框架：注册应用](https://java.agentscope.io/v2/zh/service/register-agentscope-agent.md)
- [Hosted：连接并创建 Agent](https://java.agentscope.io/v2/zh/service/connect-hosted-agent.md)

###### 给 Agent 分派任务

- [应用接入：Endpoint 与 SSE](https://java.agentscope.io/v2/zh/service/endpoints.md)
- [控制台创建 Issue 与分派任务](https://java.agentscope.io/v2/zh/service/issues.md)

###### 处理任务反馈

- [SSE 格式与任务反馈](https://java.agentscope.io/v2/zh/service/sse-events.md)
- [控制台信箱：通知、审批与验收](https://java.agentscope.io/v2/zh/service/inbox.md)

###### 多 Agent 编排

- [Team：创建与派发协作任务](https://java.agentscope.io/v2/zh/service/create-team.md)
- [Workflow：多 Agent 流程编排](https://java.agentscope.io/v2/zh/service/workflows.md)

###### 事件驱动与自动化任务

- [自动化任务：计划与 Webhook](https://java.agentscope.io/v2/zh/service/automation.md)
- [消息事件：Channel 接入与路由](https://java.agentscope.io/v2/zh/service/channels.md)

##### 场景案例

- [场景案例](https://java.agentscope.io/v2/zh/service/usecases.md)
- [研发提效：从 GitHub Issue 到 PR 合并](https://java.agentscope.io/v2/zh/service/cases/sdlc-team.md): 使用全 Hosted Team 完成需求分析、实现、Review、CI、返工与审批。
- [企业业务：订单履约异常处理](https://java.agentscope.io/v2/zh/service/cases/order-fulfillment.md): 将多个 AgentScope 应用组成 External Team，跨订单、库存、物流和售后系统协同处置。
- [托管与混合团队：从客户需求到售前方案](https://java.agentscope.io/v2/zh/service/cases/presales-team.md): 直接创建 Managed Team 交付方案和 PoC 计划，再接入 External 查询与 Hosted 实施。

##### 参考手册

###### Managed Agent

- [Managed Agent：概览与用法](https://java.agentscope.io/v2/zh/service/managed-agent.md)
- [Managed 参数与模型配置](https://java.agentscope.io/v2/zh/service/managed-agent-configuration.md)
- [Managed 支持的能力与接入类型](https://java.agentscope.io/v2/zh/service/managed-agent-capabilities.md)
- [Managed 工作原理与执行生命周期](https://java.agentscope.io/v2/zh/service/managed-agent-execution.md)
- [Managed 任务结果与失败处理](https://java.agentscope.io/v2/zh/service/managed-harness-task-outcomes.md)

###### External Agent

- [External Agent：概览与接入用法](https://java.agentscope.io/v2/zh/service/external-agent.md)
- [External 注册与连接参数](https://java.agentscope.io/v2/zh/service/external-agent-configuration.md)
- [External 支持的框架与自定义适配](https://java.agentscope.io/v2/zh/service/external-agent-frameworks.md)
- [External 工作原理与任务派发](https://java.agentscope.io/v2/zh/service/external-agent-execution.md)

###### Hosted Agent

- [Hosted Agent：概览与用法](https://java.agentscope.io/v2/zh/service/hosted-agent.md)
- [连接 Runtime Host](https://java.agentscope.io/v2/zh/service/runtime-host.md)
- [Hosted 主机与 Runtime 参数](https://java.agentscope.io/v2/zh/service/hosted-agent-configuration.md)
- [Hosted 支持的 Provider 与能力差异](https://java.agentscope.io/v2/zh/service/hosted-agent-providers.md)
- [Hosted 工作原理与恢复](https://java.agentscope.io/v2/zh/service/hosted-agent-execution.md)

###### Team

- [Team：概览与创建](https://java.agentscope.io/v2/zh/service/teams.md)
- [Team 协作：委派、汇总与扩展](https://java.agentscope.io/v2/zh/service/team-collaboration.md)
- [Team 角色、成员与策略参数](https://java.agentscope.io/v2/zh/service/team-configuration.md)
- [Team 工作原理与结果收敛](https://java.agentscope.io/v2/zh/service/team-execution.md)

###### 资源配置

- [Workspaces：共享指令与能力文件](https://java.agentscope.io/v2/zh/service/workspaces.md)
- [Environments：配置执行位置](https://java.agentscope.io/v2/zh/service/environments.md)
- [Memory：维护共享知识](https://java.agentscope.io/v2/zh/service/memory.md)
- [Vault：为工具提供凭据](https://java.agentscope.io/v2/zh/service/vault.md)

###### API 与 SDK

- [API 参考：认证、资源与调用](https://java.agentscope.io/v2/zh/service/api-reference.md)
- [SDK 与组件选择](https://java.agentscope.io/v2/zh/service/integrations.md)

###### 执行与权限

- [执行参考：Session、Run 与 Attempt](https://java.agentscope.io/v2/zh/service/sessions.md)
- [账号、Namespace 与权限](https://java.agentscope.io/v2/zh/service/access.md)

###### 配置与运维

- [配置参考](https://java.agentscope.io/v2/zh/service/configuration.md)
- [备份、升级与恢复](https://java.agentscope.io/v2/zh/service/operations.md)
- [排障](https://java.agentscope.io/v2/zh/service/troubleshooting.md)

##### 发布维护者

- [组件发布指南](https://java.agentscope.io/v2/zh/service/releasing.md)

#### 集成

##### 集成

- [概览](https://java.agentscope.io/v2/zh/integration/overview.md)

###### 模型提供商

- [模型提供商](https://java.agentscope.io/v2/zh/integration/model/index.md)
- [OpenAI](https://java.agentscope.io/v2/zh/integration/model/openai.md)
- [OpenAI Official](https://java.agentscope.io/v2/zh/integration/model/openai-official.md)
- [DeepSeek](https://java.agentscope.io/v2/zh/integration/model/deepseek.md)
- [GLM](https://java.agentscope.io/v2/zh/integration/model/glm.md)
- [Kimi](https://java.agentscope.io/v2/zh/integration/model/kimi.md)
- [MiniMax](https://java.agentscope.io/v2/zh/integration/model/minimax.md)
- [DashScope](https://java.agentscope.io/v2/zh/integration/model/dashscope.md)
- [Gemini](https://java.agentscope.io/v2/zh/integration/model/gemini.md)
- [Anthropic](https://java.agentscope.io/v2/zh/integration/model/anthropic.md)
- [Ollama](https://java.agentscope.io/v2/zh/integration/model/ollama.md)

###### 记忆

- [记忆](https://java.agentscope.io/v2/zh/integration/memory/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/memory/overview.md)
- [Mem0](https://java.agentscope.io/v2/zh/integration/memory/mem0.md)
- [百炼记忆](https://java.agentscope.io/v2/zh/integration/memory/bailian.md)
- [ReMe](https://java.agentscope.io/v2/zh/integration/memory/reme.md)

###### Agent 状态存储

- [Agent 状态存储](https://java.agentscope.io/v2/zh/integration/session/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/session/overview.md)
- [MySQL 状态存储](https://java.agentscope.io/v2/zh/integration/session/mysql.md)
- [Redis 状态存储](https://java.agentscope.io/v2/zh/integration/session/redis.md)
- [OSS 状态存储](https://java.agentscope.io/v2/zh/integration/session/oss.md)

###### RAG 知识库

- [RAG 知识库](https://java.agentscope.io/v2/zh/integration/rag/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/rag/overview.md)
- [Simple](https://java.agentscope.io/v2/zh/integration/rag/simple.md)
- [百炼知识库](https://java.agentscope.io/v2/zh/integration/rag/bailian.md)
- [Dify](https://java.agentscope.io/v2/zh/integration/rag/dify.md)
- [HayStack](https://java.agentscope.io/v2/zh/integration/rag/haystack.md)
- [RAGFlow](https://java.agentscope.io/v2/zh/integration/rag/ragflow.md)

###### 技能仓库

- [技能仓库](https://java.agentscope.io/v2/zh/integration/skill/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/skill/overview.md)
- [Git 技能仓库](https://java.agentscope.io/v2/zh/integration/skill/git-repository.md)
- [MySQL 技能仓库](https://java.agentscope.io/v2/zh/integration/skill/mysql-repository.md)
- [PostgreSQL 技能仓库](https://java.agentscope.io/v2/zh/integration/skill/postgresql-repository.md)

###### 智能体协议

- [智能体协议](https://java.agentscope.io/v2/zh/integration/protocol/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/protocol/overview.md)
- [A2A](https://java.agentscope.io/v2/zh/integration/protocol/a2a.md)
- [AG-UI](https://java.agentscope.io/v2/zh/integration/protocol/agui.md)
- [Agent Protocol](https://java.agentscope.io/v2/zh/integration/protocol/agent-protocol.md)

###### 基础设施

- [基础设施](https://java.agentscope.io/v2/zh/integration/infrastructure/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/infrastructure/overview.md)
- [Higress](https://java.agentscope.io/v2/zh/integration/infrastructure/higress.md)
- [Nacos](https://java.agentscope.io/v2/zh/integration/infrastructure/nacos.md)
- [Scheduler](https://java.agentscope.io/v2/zh/integration/infrastructure/scheduler.md)

###### 生态扩展

- [生态扩展](https://java.agentscope.io/v2/zh/integration/ecosystem/index.md)
- [概览](https://java.agentscope.io/v2/zh/integration/ecosystem/overview.md)
- [Chat Completions Web](https://java.agentscope.io/v2/zh/integration/ecosystem/chat-completions-web.md)
- [Studio](https://java.agentscope.io/v2/zh/integration/ecosystem/studio.md)
- [在线训练](https://java.agentscope.io/v2/zh/integration/ecosystem/training.md)

##### 渠道接入

- [Channel 适配器](https://java.agentscope.io/v2/zh/integration/channel/index.md)
- [钉钉 Channel](https://java.agentscope.io/v2/zh/integration/channel/dingtalk.md)
- [飞书 Channel](https://java.agentscope.io/v2/zh/integration/channel/feishu.md)
- [GitHub Channel](https://java.agentscope.io/v2/zh/integration/channel/github.md)
- [GitLab Channel](https://java.agentscope.io/v2/zh/integration/channel/gitlab.md)
- [企业微信 Channel](https://java.agentscope.io/v2/zh/integration/channel/wecom.md)

##### 分布式存储

- [分布式存储（Distributed Store）](https://java.agentscope.io/v2/zh/integration/distributed/index.md)
- [MySQL / JDBC](https://java.agentscope.io/v2/zh/integration/distributed/mysql.md)
- [MongoDB](https://java.agentscope.io/v2/zh/integration/distributed/mongodb.md)
- [阿里云 OSS](https://java.agentscope.io/v2/zh/integration/distributed/oss.md)
- [Redis](https://java.agentscope.io/v2/zh/integration/distributed/redis.md)

#### 博客

##### 博客

- [如何构建 Agent Harness（一）：架构范式与责任边界](https://java.agentscope.io/v2/zh/blogs/how-to-build-agent-harness/01-patterns.md)
- [如何构建 Agent Harness（二）：任务编排、长程推进与协作流转](https://java.agentscope.io/v2/zh/blogs/how-to-build-agent-harness/02-task-orchestration.md)
- [如何构建 Agent Harness（三）：上下文、状态与可复用能力资产](https://java.agentscope.io/v2/zh/blogs/how-to-build-agent-harness/03-context-and-state.md)
- [如何构建 Agent Harness（四）：受控执行、验证反馈与交付准备](https://java.agentscope.io/v2/zh/blogs/how-to-build-agent-harness/04-controlled-execution.md)
- [AgentScope 2.0 发布](https://java.agentscope.io/v2/zh/blogs/agentscope-v2-release.md)
- [AgentScope 2.0 生产可用，企业级 Harness 技术全解析](https://java.agentscope.io/v2/zh/blogs/agentscope-v2-explained.md)
- [AgentScope Java 1.1 · Harness](https://java.agentscope.io/v2/zh/blogs/agentscope-v1-harness.md)
- [AgentScope Builder 发布](https://java.agentscope.io/v2/zh/blogs/agentscope-v1-builder.md)
- [Coding Agent 的下半场：从个人提效到组织级研发体系](https://java.agentscope.io/v2/zh/blogs/agentscope-v2-coding-agent.md)
- [基于 AgentScope 2.0 运行时的 Managed Agents](https://java.agentscope.io/v2/zh/blogs/managed-agents-agentscope-rumtime.md)
- [AgentScope Service 发布](https://java.agentscope.io/v2/zh/blogs/agentscope-service-release.md)
- [AgentScope Service 技术解读：控制面、数据面与可恢复的 Agent 运行时](https://java.agentscope.io/v2/zh/blogs/agentscope-service-release-tech.md)

###### 客户实践案例

- [客户实践案例](https://java.agentscope.io/v2/zh/blogs/usecases/index.md)
- [FinXScope：基于 AgentScope 构建金融级智能体底座](https://java.agentscope.io/v2/zh/blogs/usecases/finxscope.md)
- [从配置驱动到业务原生：企业级 Agent 开发实践](https://java.agentscope.io/v2/zh/blogs/usecases/logistics.md)
- [AIDC 物流：企业级 Agent 开发实践](https://java.agentscope.io/v2/zh/blogs/usecases/aidc-logistics.md)

#### 社区

##### 社区

- [核心贡献者](https://java.agentscope.io/v2/zh/community/contributors.md)

#### JEV

##### JEV

- [Jev](https://java.agentscope.io/v2/zh/jev/index.md)

### v1

#### 首页

- [AgentScope Java v1](https://java.agentscope.io/v1/zh/intro.md): 构建分布式企业级智能体

#### SDK

##### 快速开始

- [安装](https://java.agentscope.io/v1/zh/docs/quickstart/installation.md)
- [核心概念](https://java.agentscope.io/v1/zh/docs/quickstart/key-concepts.md)
- [智能体](https://java.agentscope.io/v1/zh/docs/quickstart/agent.md)

##### 功能指南

- [模型集成](https://java.agentscope.io/v1/zh/docs/task/model.md)
- [工具系统](https://java.agentscope.io/v1/zh/docs/task/tool.md)
- [MCP](https://java.agentscope.io/v1/zh/docs/task/mcp.md)
- [Agent as Tool](https://java.agentscope.io/v1/zh/docs/task/agent-as-tool.md)
- [Agent Skill](https://java.agentscope.io/v1/zh/docs/task/agent-skill.md)
- [RAG](https://java.agentscope.io/v1/zh/docs/task/rag.md)
- [流式输出](https://java.agentscope.io/v1/zh/docs/task/streaming.md)
- [钩子系统](https://java.agentscope.io/v1/zh/docs/task/hook.md)
- [Human-in-the-Loop](https://java.agentscope.io/v1/zh/docs/task/hitl.md)
- [记忆管理](https://java.agentscope.io/v1/zh/docs/task/memory.md)
- [计划](https://java.agentscope.io/v1/zh/docs/task/plan.md)
- [状态管理](https://java.agentscope.io/v1/zh/docs/task/state.md)
- [会话管理](https://java.agentscope.io/v1/zh/docs/task/session.md)
- [多模态](https://java.agentscope.io/v1/zh/docs/task/multimodal.md)
- [结构化输出](https://java.agentscope.io/v1/zh/docs/task/structured-output.md)
- [可观测与调试](https://java.agentscope.io/v1/zh/docs/task/observability.md)
- [AG-UI 协议](https://java.agentscope.io/v1/zh/docs/task/agui.md)
- [A2A 协议](https://java.agentscope.io/v1/zh/docs/task/a2a.md)
- [MsgHub](https://java.agentscope.io/v1/zh/docs/task/msghub.md)
- [使用 AI 编程](https://java.agentscope.io/v1/zh/docs/task/ai-coding.md)
- [在线训练](https://java.agentscope.io/v1/zh/docs/task/online-training.md)
- [Agent 配置（Agent Configuration）](https://java.agentscope.io/v1/zh/docs/task/agent-config.md)
- [Text-to-Speech (TTS) 语音合成](https://java.agentscope.io/v1/zh/docs/task/tts.md)

##### 多智能体

- [概览](https://java.agentscope.io/v1/zh/docs/multi-agent/overview.md)
- [管道](https://java.agentscope.io/v1/zh/docs/multi-agent/pipeline.md)
- [自定义工作流](https://java.agentscope.io/v1/zh/docs/multi-agent/workflow.md)
- [Routing](https://java.agentscope.io/v1/zh/docs/multi-agent/routing.md)
- [Skills](https://java.agentscope.io/v1/zh/docs/multi-agent/skills.md)
- [Subagents](https://java.agentscope.io/v1/zh/docs/multi-agent/subagent.md)
- [Supervisor](https://java.agentscope.io/v1/zh/docs/multi-agent/supervisor.md)
- [Handoffs](https://java.agentscope.io/v1/zh/docs/multi-agent/handoffs.md)
- [多智能体辩论](https://java.agentscope.io/v1/zh/docs/multi-agent/multiagent-debate.md)

##### Harness

- [概览](https://java.agentscope.io/v1/zh/docs/harness/overview.md)
- [架构](https://java.agentscope.io/v1/zh/docs/harness/architecture.md)
- [工作区](https://java.agentscope.io/v1/zh/docs/harness/workspace.md)
- [文件系统](https://java.agentscope.io/v1/zh/docs/harness/filesystem.md)
- [会话](https://java.agentscope.io/v1/zh/docs/harness/session.md)
- [记忆](https://java.agentscope.io/v1/zh/docs/harness/memory.md)
- [工具](https://java.agentscope.io/v1/zh/docs/harness/tool.md)
- [技能](https://java.agentscope.io/v1/zh/docs/harness/skill.md)
- [子 Agent](https://java.agentscope.io/v1/zh/docs/harness/subagent.md)
- [子 Agent 流式](https://java.agentscope.io/v1/zh/docs/harness/streaming.md)
- [快速开始](https://java.agentscope.io/v1/zh/docs/harness/quickstart/index.md)
- [沙箱](https://java.agentscope.io/v1/zh/docs/harness/sandbox/index.md)
- [AgentRun 后端](https://java.agentscope.io/v1/zh/docs/harness/sandbox/agentrun.md)
- [示例](https://java.agentscope.io/v1/zh/docs/harness/example/index.md)

#### 集成

##### 集成

- [概览](https://java.agentscope.io/v1/zh/integration/overview.md)

#### 博客

##### 博客

- [全部文章](https://java.agentscope.io/v1/zh/blogs/index.md)
- [AgentScope Java 1.1 · Harness](https://java.agentscope.io/v1/zh/blogs/agentscope-v1-harness.md)
- [AgentScope Builder 发布](https://java.agentscope.io/v1/zh/blogs/agentscope-v1-builder.md)

#### 社区

##### 社区

- [社区](https://java.agentscope.io/v1/zh/community/overview.md)
- [核心贡献者](https://java.agentscope.io/v1/zh/community/contributors.md)