# AgentScope Java ## v2 ### Home - [AgentScope Java v2](https://java.agentscope.io/v2/en/intro.md): Build distributed, enterprise-grade agents ### SDK #### Quick Start - [What's AgentScope 2.0?](https://java.agentscope.io/v2/en/docs/index.md): Harness engineering, enterprise-grade distributed deployment, and a redesigned foundation. - [Quickstart](https://java.agentscope.io/v2/en/docs/quickstart.md): Get started with AgentScope Java 2.0 — bring up your first long-running agent with HarnessAgent #### Building Blocks - [Agent](https://java.agentscope.io/v2/en/docs/building-blocks/agent.md): Learn how to define and configure agents in AgentScope Java 2.0 - [Message & Event](https://java.agentscope.io/v2/en/docs/building-blocks/message-and-event.md): The core data abstractions for agent communication and streaming - [Middleware](https://java.agentscope.io/v2/en/docs/building-blocks/middleware.md): Intercept and extend agent behavior at key lifecycle points - [Model](https://java.agentscope.io/v2/en/docs/building-blocks/model.md): Configure and connect LLM model providers in AgentScope Java - [Permission System](https://java.agentscope.io/v2/en/docs/building-blocks/permission-system.md): Fine-grained control over which tools your agents can execute and when - [Tool](https://java.agentscope.io/v2/en/docs/building-blocks/tool.md): Define, register, and manage the capabilities an agent can call - [Context & AgentState](https://java.agentscope.io/v2/en/docs/building-blocks/context.md): Stateless agent engine, AgentState lifecycle, state persistence, and RuntimeContext #### Harness - [Harness Architecture](https://java.agentscope.io/v2/en/docs/harness/architecture.md): What HarnessAgent is, how its capabilities cooperate, and how state flows during a call() - [Context Compaction](https://java.agentscope.io/v2/en/docs/harness/compaction.md): Keep the conversation within the model's token budget without losing critical information - [Workspace](https://java.agentscope.io/v2/en/docs/harness/workspace.md): Source of truth for agent definition and evolution: directory layout, workspace-vs-API parity, native multi-tenant isolation, filesystem modes, and deep dive on key contents - [Memory](https://java.agentscope.io/v2/en/docs/harness/memory.md): Two-layer long-term memory, conversation compaction, large tool-result offloading; prompts and trigger policy are customizable - [Filesystem](https://java.agentscope.io/v2/en/docs/harness/filesystem.md): Three deployment modes: local + shell / shared store / sandbox; IsolationScope dimensions; multi-user isolation; how skills and tools behave in each mode - [Sandbox](https://java.agentscope.io/v2/en/docs/harness/sandbox.md): Isolated execution + cross-call recovery + multi-replica deployment - [Subagent](https://java.agentscope.io/v2/en/docs/harness/subagent.md): Declare subagents, sync/background calls, auto push-back, remote subagents, streaming forwarding - [Skill](https://java.agentscope.io/v2/en/docs/harness/skill.md): Four-layer skill composition, skill marketplaces, the self-learning loop - [Plan Mode](https://java.agentscope.io/v2/en/docs/harness/plan-mode.md): Think before acting: a read-only phase that writes a plan file and requires HITL approval before executing - [Channel](https://java.agentscope.io/v2/en/docs/harness/channel.md): Route messages, manage sessions, and stream events through Channel #### Reference - [V1 Migration Guide](https://java.agentscope.io/v2/en/docs/change-log.md): Complete migration guide from AgentScope Java 1.x to 2.0 - [Release Notes](https://java.agentscope.io/v2/en/docs/others/release-notes.md): Per-version change records for AgentScope Java - [Going to Production](https://java.agentscope.io/v2/en/docs/others/going-to-production.md): From single-node prototype to multi-replica deployment: component selection and configuration for the Agent State Store, Filesystem, Skill, Sandbox, Snapshot, and Observability - [FAQ](https://java.agentscope.io/v2/en/docs/others/faq.md): Frequently asked questions about AgentScope Java 2.0 ### Service #### Getting started - [What is AgentScope Service?](https://java.agentscope.io/v2/en/service/index.md) - [Quickstart](https://java.agentscope.io/v2/en/service/first-session.md) #### Installation and deployment - [Local installation](https://java.agentscope.io/v2/en/service/quickstart.md) - [Production installation](https://java.agentscope.io/v2/en/service/kubernetes.md) #### Agent and task management ##### Register or create an Agent - [Register or create an Agent](https://java.agentscope.io/v2/en/service/agents.md) - [Managed Agent: create and test](https://java.agentscope.io/v2/en/service/create-managed-agent.md) - [AgentScope framework: register an application](https://java.agentscope.io/v2/en/service/register-agentscope-agent.md) - [Hosted: connect and create an Agent](https://java.agentscope.io/v2/en/service/connect-hosted-agent.md) ##### Assign tasks to Agents - [Application integration: Endpoint and SSE](https://java.agentscope.io/v2/en/service/endpoints.md) - [Create console Issues and assign tasks](https://java.agentscope.io/v2/en/service/issues.md) ##### Handle task feedback - [SSE format and task feedback](https://java.agentscope.io/v2/en/service/sse-events.md) - [Console Inbox: notifications, approvals and reviews](https://java.agentscope.io/v2/en/service/inbox.md) ##### Multi-Agent orchestration - [Team: create and dispatch collaborative work](https://java.agentscope.io/v2/en/service/create-team.md) - [Workflow: multi-Agent process orchestration](https://java.agentscope.io/v2/en/service/workflows.md) ##### Events and automation - [Automated tasks: schedules and webhooks](https://java.agentscope.io/v2/en/service/automation.md) - [Message events: Channel integration and routing](https://java.agentscope.io/v2/en/service/channels.md) #### Use cases - [Use cases](https://java.agentscope.io/v2/en/service/usecases.md) - [Engineering: from GitHub Issue to merged PR](https://java.agentscope.io/v2/en/service/cases/sdlc-team.md): Use an all-Hosted Team for analysis, implementation, review, CI, rework, and approval. - [Enterprise operations: resolve order fulfillment exceptions](https://java.agentscope.io/v2/en/service/cases/order-fulfillment.md): Coordinate independently deployed AgentScope applications across orders, inventory, logistics, and after-sales systems. - [Managed and mixed Teams: from customer needs to a proposal](https://java.agentscope.io/v2/en/service/cases/presales-team.md): Create a Managed Team for a proposal and PoC plan, then add External queries and Hosted implementation. #### Reference ##### Managed Agent - [Managed Agent: overview and usage](https://java.agentscope.io/v2/en/service/managed-agent.md) - [Managed configuration and models](https://java.agentscope.io/v2/en/service/managed-agent-configuration.md) - [Managed capabilities and integration types](https://java.agentscope.io/v2/en/service/managed-agent-capabilities.md) - [How Managed execution works](https://java.agentscope.io/v2/en/service/managed-agent-execution.md) - [Managed task outcomes and failures](https://java.agentscope.io/v2/en/service/managed-harness-task-outcomes.md) ##### External Agent - [External Agent: overview and integration](https://java.agentscope.io/v2/en/service/external-agent.md) - [External registration and connection settings](https://java.agentscope.io/v2/en/service/external-agent-configuration.md) - [External frameworks and custom adapters](https://java.agentscope.io/v2/en/service/external-agent-frameworks.md) - [How External registration and dispatch work](https://java.agentscope.io/v2/en/service/external-agent-execution.md) ##### Hosted Agent - [Hosted Agent: overview and usage](https://java.agentscope.io/v2/en/service/hosted-agent.md) - [Connect a Runtime Host](https://java.agentscope.io/v2/en/service/runtime-host.md) - [Hosted host and Runtime settings](https://java.agentscope.io/v2/en/service/hosted-agent-configuration.md) - [Hosted providers and capability differences](https://java.agentscope.io/v2/en/service/hosted-agent-providers.md) - [How Hosted execution and recovery work](https://java.agentscope.io/v2/en/service/hosted-agent-execution.md) ##### Team - [Team: overview and creation](https://java.agentscope.io/v2/en/service/teams.md) - [Team collaboration: delegate, combine and extend](https://java.agentscope.io/v2/en/service/team-collaboration.md) - [Team roles, members and policy settings](https://java.agentscope.io/v2/en/service/team-configuration.md) - [How Team coordination and completion work](https://java.agentscope.io/v2/en/service/team-execution.md) ##### Resources - [Workspaces: shared instructions and capabilities](https://java.agentscope.io/v2/en/service/workspaces.md) - [Environments: execution locations](https://java.agentscope.io/v2/en/service/environments.md) - [Memory: shared knowledge](https://java.agentscope.io/v2/en/service/memory.md) - [Vault: credentials for tools](https://java.agentscope.io/v2/en/service/vault.md) ##### API and SDK - [API reference: identity, resources and invocation](https://java.agentscope.io/v2/en/service/api-reference.md) - [SDK and component selection](https://java.agentscope.io/v2/en/service/integrations.md) ##### Execution and access - [Execution reference: Sessions, Runs and Attempts](https://java.agentscope.io/v2/en/service/sessions.md) - [Accounts, Namespaces and permissions](https://java.agentscope.io/v2/en/service/access.md) ##### Configuration and operations - [Configuration reference](https://java.agentscope.io/v2/en/service/configuration.md) - [Backup, upgrade and recovery](https://java.agentscope.io/v2/en/service/operations.md) - [Troubleshooting](https://java.agentscope.io/v2/en/service/troubleshooting.md) #### Release maintainers - [Publishing components](https://java.agentscope.io/v2/en/service/releasing.md) ### Integration #### Integration - [Overview](https://java.agentscope.io/v2/en/integration/overview.md) ##### Model Providers - [Model Providers](https://java.agentscope.io/v2/en/integration/model/index.md) - [OpenAI](https://java.agentscope.io/v2/en/integration/model/openai.md) - [OpenAI Official](https://java.agentscope.io/v2/en/integration/model/openai-official.md) - [DeepSeek](https://java.agentscope.io/v2/en/integration/model/deepseek.md) - [GLM](https://java.agentscope.io/v2/en/integration/model/glm.md) - [Kimi](https://java.agentscope.io/v2/en/integration/model/kimi.md) - [MiniMax](https://java.agentscope.io/v2/en/integration/model/minimax.md) - [DashScope](https://java.agentscope.io/v2/en/integration/model/dashscope.md) - [Gemini](https://java.agentscope.io/v2/en/integration/model/gemini.md) - [Anthropic](https://java.agentscope.io/v2/en/integration/model/anthropic.md) - [Ollama](https://java.agentscope.io/v2/en/integration/model/ollama.md) ##### Memory - [Memory](https://java.agentscope.io/v2/en/integration/memory/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/memory/overview.md) - [Mem0](https://java.agentscope.io/v2/en/integration/memory/mem0.md) - [Bailian Memory](https://java.agentscope.io/v2/en/integration/memory/bailian.md) - [ReMe](https://java.agentscope.io/v2/en/integration/memory/reme.md) ##### Agent State Store - [Agent State Store](https://java.agentscope.io/v2/en/integration/session/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/session/overview.md) - [MySQL State Store](https://java.agentscope.io/v2/en/integration/session/mysql.md) - [Redis State Store](https://java.agentscope.io/v2/en/integration/session/redis.md) - [OSS State Store](https://java.agentscope.io/v2/en/integration/session/oss.md) ##### RAG Knowledge Base - [RAG Knowledge Base](https://java.agentscope.io/v2/en/integration/rag/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/rag/overview.md) - [Simple](https://java.agentscope.io/v2/en/integration/rag/simple.md) - [Bailian Knowledge](https://java.agentscope.io/v2/en/integration/rag/bailian.md) - [Dify](https://java.agentscope.io/v2/en/integration/rag/dify.md) - [HayStack](https://java.agentscope.io/v2/en/integration/rag/haystack.md) - [RAGFlow](https://java.agentscope.io/v2/en/integration/rag/ragflow.md) ##### Skill Repository - [Skill Repository](https://java.agentscope.io/v2/en/integration/skill/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/skill/overview.md) - [Git Skill Repository](https://java.agentscope.io/v2/en/integration/skill/git-repository.md) - [MySQL Skill Repository](https://java.agentscope.io/v2/en/integration/skill/mysql-repository.md) - [PostgreSQL Skill Repository](https://java.agentscope.io/v2/en/integration/skill/postgresql-repository.md) ##### Agent Protocols - [Agent Protocols](https://java.agentscope.io/v2/en/integration/protocol/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/protocol/overview.md) - [A2A](https://java.agentscope.io/v2/en/integration/protocol/a2a.md) - [AG-UI](https://java.agentscope.io/v2/en/integration/protocol/agui.md) - [Agent Protocol](https://java.agentscope.io/v2/en/integration/protocol/agent-protocol.md) ##### Infrastructure - [Infrastructure](https://java.agentscope.io/v2/en/integration/infrastructure/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/infrastructure/overview.md) - [Higress](https://java.agentscope.io/v2/en/integration/infrastructure/higress.md) - [Nacos](https://java.agentscope.io/v2/en/integration/infrastructure/nacos.md) - [Scheduler](https://java.agentscope.io/v2/en/integration/infrastructure/scheduler.md) ##### Ecosystem - [Ecosystem](https://java.agentscope.io/v2/en/integration/ecosystem/index.md) - [Overview](https://java.agentscope.io/v2/en/integration/ecosystem/overview.md) - [Chat Completions Web](https://java.agentscope.io/v2/en/integration/ecosystem/chat-completions-web.md) - [Studio](https://java.agentscope.io/v2/en/integration/ecosystem/studio.md) - [Online Training](https://java.agentscope.io/v2/en/integration/ecosystem/training.md) #### Channels - [Channel Adapters](https://java.agentscope.io/v2/en/integration/channel/index.md) - [DingTalk Channel](https://java.agentscope.io/v2/en/integration/channel/dingtalk.md) - [Feishu Channel](https://java.agentscope.io/v2/en/integration/channel/feishu.md) - [GitHub Channel](https://java.agentscope.io/v2/en/integration/channel/github.md) - [GitLab Channel](https://java.agentscope.io/v2/en/integration/channel/gitlab.md) - [WeCom Channel](https://java.agentscope.io/v2/en/integration/channel/wecom.md) #### Distributed storage - [Distributed Storage (Distributed Store)](https://java.agentscope.io/v2/en/integration/distributed/index.md) - [MySQL / JDBC](https://java.agentscope.io/v2/en/integration/distributed/mysql.md) - [MongoDB](https://java.agentscope.io/v2/en/integration/distributed/mongodb.md) - [Alibaba Cloud OSS](https://java.agentscope.io/v2/en/integration/distributed/oss.md) - [Redis](https://java.agentscope.io/v2/en/integration/distributed/redis.md) ### Blog #### Blogs - [让 Agent 学会判断：Jev 与结构化决策](https://java.agentscope.io/v2/zh/blogs/jev-structured-decision-for-agents.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 Release](https://java.agentscope.io/v2/en/blogs/agentscope-v2-release.md) - [AgentScope 2.0 Production-Ready - Enterprise Harness Explained](https://java.agentscope.io/v2/en/blogs/agentscope-v2-explained.md) - [AgentScope Java 1.1 · Harness](https://java.agentscope.io/v2/en/blogs/agentscope-v1-harness.md) - [AgentScope Builder Release](https://java.agentscope.io/v2/en/blogs/agentscope-v1-builder.md) - [The Second Half of Coding Agents: From Personal Efficiency to Org-Level Engineering](https://java.agentscope.io/v2/en/blogs/agentscope-v2-coding-agent.md) - [Managed Agents on the AgentScope 2.0 Runtime](https://java.agentscope.io/v2/en/blogs/managed-agents-agentscope-rumtime.md) - [AgentScope Service Release](https://java.agentscope.io/v2/en/blogs/agentscope-service-release.md) - [AgentScope Service Explained: Control Plane, Data Plane & Recoverable Runtime](https://java.agentscope.io/v2/en/blogs/agentscope-service-release-tech.md) ##### Customer Use Cases - [Customer Use Cases](https://java.agentscope.io/v2/en/blogs/usecases/index.md) - [FinXScope: A Financial-Grade Agent Foundation](https://java.agentscope.io/v2/en/blogs/usecases/finxscope.md) - [From Config-Driven to Business-Native: Enterprise Agent Practice](https://java.agentscope.io/v2/en/blogs/usecases/logistics.md) - [AIDC Logistics: Enterprise Agent Development Practice](https://java.agentscope.io/v2/en/blogs/usecases/aidc-logistics.md) ### Community #### Community - [Contributors](https://java.agentscope.io/v2/en/community/contributors.md) ### JEV #### JEV - [Jev](https://java.agentscope.io/v2/en/jev/index.md) ## v1 ### Home - [AgentScope Java v1](https://java.agentscope.io/v1/en/intro.md): Build distributed, enterprise-grade agents ### SDK #### Quick Start - [Installation](https://java.agentscope.io/v1/en/docs/quickstart/installation.md) - [Key Concepts](https://java.agentscope.io/v1/en/docs/quickstart/key-concepts.md) - [Agent](https://java.agentscope.io/v1/en/docs/quickstart/agent.md) #### Features - [Model Integration](https://java.agentscope.io/v1/en/docs/task/model.md) - [Tool System](https://java.agentscope.io/v1/en/docs/task/tool.md) - [Model Context Protocol](https://java.agentscope.io/v1/en/docs/task/mcp.md) - [Agent as Tool](https://java.agentscope.io/v1/en/docs/task/agent-as-tool.md) - [Agent Skill](https://java.agentscope.io/v1/en/docs/task/agent-skill.md) - [RAG](https://java.agentscope.io/v1/en/docs/task/rag.md) - [Streaming](https://java.agentscope.io/v1/en/docs/task/streaming.md) - [Hook System](https://java.agentscope.io/v1/en/docs/task/hook.md) - [Human-in-the-Loop](https://java.agentscope.io/v1/en/docs/task/hitl.md) - [Memory Management](https://java.agentscope.io/v1/en/docs/task/memory.md) - [Planning](https://java.agentscope.io/v1/en/docs/task/plan.md) - [State Management](https://java.agentscope.io/v1/en/docs/task/state.md) - [Session Management](https://java.agentscope.io/v1/en/docs/task/session.md) - [Multimodal](https://java.agentscope.io/v1/en/docs/task/multimodal.md) - [Structured Output](https://java.agentscope.io/v1/en/docs/task/structured-output.md) - [Observability & Studio](https://java.agentscope.io/v1/en/docs/task/observability.md) - [AG-UI Protocol](https://java.agentscope.io/v1/en/docs/task/agui.md) - [A2A Protocol](https://java.agentscope.io/v1/en/docs/task/a2a.md) - [MsgHub](https://java.agentscope.io/v1/en/docs/task/msghub.md) - [Coding with AI](https://java.agentscope.io/v1/en/docs/task/ai-coding.md) - [Online Training](https://java.agentscope.io/v1/en/docs/task/online-training.md) - [Agent Configuration](https://java.agentscope.io/v1/en/docs/task/agent-config.md) - [Text-to-Speech (TTS)](https://java.agentscope.io/v1/en/docs/task/tts.md) #### Multi Agent - [Overview](https://java.agentscope.io/v1/en/docs/multi-agent/overview.md) - [Pipeline](https://java.agentscope.io/v1/en/docs/multi-agent/pipeline.md) - [Custom Workflow](https://java.agentscope.io/v1/en/docs/multi-agent/workflow.md) - [Routing](https://java.agentscope.io/v1/en/docs/multi-agent/routing.md) - [Skills](https://java.agentscope.io/v1/en/docs/multi-agent/skills.md) - [Subagents](https://java.agentscope.io/v1/en/docs/multi-agent/subagent.md) - [Supervisor](https://java.agentscope.io/v1/en/docs/multi-agent/supervisor.md) - [Handoffs](https://java.agentscope.io/v1/en/docs/multi-agent/handoffs.md) - [Multi-Agent Debate](https://java.agentscope.io/v1/en/docs/multi-agent/multiagent-debate.md) #### Harness - [Overview](https://java.agentscope.io/v1/en/docs/harness/overview.md) - [Architecture](https://java.agentscope.io/v1/en/docs/harness/architecture.md) - [Workspace](https://java.agentscope.io/v1/en/docs/harness/workspace.md) - [Filesystem](https://java.agentscope.io/v1/en/docs/harness/filesystem.md) - [Session](https://java.agentscope.io/v1/en/docs/harness/session.md) - [Memory](https://java.agentscope.io/v1/en/docs/harness/memory.md) - [Tooling](https://java.agentscope.io/v1/en/docs/harness/tool.md) - [Subagent](https://java.agentscope.io/v1/en/docs/harness/subagent.md) - [Subagent Streaming](https://java.agentscope.io/v1/en/docs/harness/streaming.md) - [Quick Start](https://java.agentscope.io/v1/en/docs/harness/quickstart/index.md) - [Sandbox](https://java.agentscope.io/v1/en/docs/harness/sandbox/index.md) - [Examples](https://java.agentscope.io/v1/en/docs/harness/example/index.md) ### Integration #### Integration - [Overview](https://java.agentscope.io/v1/en/integration/overview.md) ### Blog #### Blogs - [Article index](https://java.agentscope.io/v1/en/blogs/index.md) - [AgentScope Java 1.1 · Harness](https://java.agentscope.io/v1/en/blogs/agentscope-v1-harness.md) ### Community #### Community - [Community](https://java.agentscope.io/v1/en/community/overview.md) - [Contributors](https://java.agentscope.io/v1/en/community/contributors.md) > The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages. ## Indexes - [Chinese (208 pages)](https://java.agentscope.io/_llms/zh.md): Documentation for Chinese. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.