> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> For AgentScope Python, use https://docs.agentscope.io/stable/en/index for new projects. For existing projects, check the installed agentscope version and use matching versioned documentation.
> The /latest/ alias points to development documentation. Use it only with the matching development source. Do not mix AgentScope 1.x and 2.x APIs.
> State the AgentScope version when providing installation commands or code examples. ReMe uses its own continuously updated /reme/latest/ documentation.

# FAQ

> Find answers to common questions about using AgentScope 2.0.

Find setup guidance for AgentScope development, integrations, and service deployment.

<AccordionGroup>
  <Accordion title="Is AgentScope 2.0 compatible with 1.0?">
    No. AgentScope 2.0 changes the agent, message, event, tool, and state APIs. Existing applications need code changes; upgrading the package alone does not migrate them.

    Start new projects with 2.0. For existing applications, follow the [1.x to 2.x changes](/versions/2.0.8/en/others/change-log) or keep using documentation matching the installed 1.x version.
  </Accordion>

  <Accordion title="Does AgentScope support sandboxed execution?">
    Yes. Sandboxed workspace backends include Docker, Bubblewrap, Apple Container, Kubernetes, E2B, Daytona, and OpenSandbox, among others. `LocalWorkspace` runs on the host and does not provide sandbox isolation.

    Workspaces manage the execution environment, MCP server lifecycles, skills, and context offloading. See [Workspaces](/versions/2.0.8/en/building-blocks/workspace/overview) to choose a backend and [Workspace Management](/versions/2.0.8/en/deploy/workspace-manager) to allocate workspaces across users, agents, and sessions.
  </Accordion>

  <Accordion title="How do I deploy an agent as a service with a web UI?">
    Use the built-in Agent Service and its matching web UI. Run the [backend example](https://github.com/agentscope-ai/agentscope/tree/main/examples/agent_service) and [web UI example](https://github.com/agentscope-ai/agentscope/tree/main/examples/web_ui) from the same checkout to try the application.

    Follow the [Agent Service setup guide](/versions/2.0.8/en/deploy/agent-service#quickstart) for prerequisites and startup commands. You can also build your own frontend using the service's HTTP APIs and event streams.
  </Accordion>

  <Accordion title="Does AgentScope 2.0 support RAG and long-term memory?">
    Yes. [RAG](/versions/2.0.8/en/building-blocks/rag) provides document parsing, chunking, embedding, and vector retrieval. [RAG Service](/versions/2.0.8/en/deploy/rag) adds document management and indexing for hosted applications.

    [Long-term memory](/versions/2.0.8/en/building-blocks/long-term-memory) supports file-based agentic memory, ReMe, and Mem0 through middleware. Use RAG to retrieve knowledge and long-term memory to retain information across sessions; both can be used together.
  </Accordion>

  <Accordion title="Do I have to use Qwen or DashScope?">
    No. AgentScope supports model APIs including OpenAI, Anthropic, Gemini, DashScope, and Ollama. Choose a model class and matching credentials; available features depend on the selected model and API.

    See [Model Configuration](/versions/2.0.8/en/building-blocks/agent/configure-agent) and [Chat Models](/versions/2.0.8/en/building-blocks/model/llm).
  </Accordion>

  <Accordion title="Does AgentScope support MCP and skills?">
    Yes. MCP (Model Context Protocol) connects agents to external tools through STDIO or HTTP. Skills provide instructions in `SKILL.md` files that agents read and follow using their available tools.

    Register them through the toolkit or manage them through a workspace. See [MCP](/versions/2.0.8/en/building-blocks/tool/mcp) and [Skills](/versions/2.0.8/en/building-blocks/tool/skill) for setup.
  </Accordion>

  <Accordion title="How do I build a multi-agent application?">
    You can compose agents in Python or use [Agent Team](/versions/2.0.8/en/deploy/agent-team) for service-based collaboration. A leader creates workers, delegates tasks, and exchanges messages with them; each worker runs in its own session.

    Use teams when a task benefits from delegation or separate agent contexts. A single agent is sufficient when one model and toolkit can complete the task.
  </Accordion>

  <Accordion title="How do I build a multi-tenant, multi-session service?">
    Use Agent Service under `agentscope.app` to manage user-owned resources and persistent sessions. Storage backends include Redis and SQLAlchemy databases such as PostgreSQL, MySQL, and SQLite; workspace allocation can be configured per user, agent, or session.

    Integrate your own authentication to establish user identity. See [Agent Service](/versions/2.0.8/en/deploy/agent-service) and [Workspace Management](/versions/2.0.8/en/deploy/workspace-manager) for configuration.
  </Accordion>

  <Accordion title="Does AgentScope support A2A?">
    Yes, from version 2.0.8. `A2AAgent` connects to remote A2A agents and translates their responses into AgentScope messages and events; the remote service controls its own models and tools.

    See the [A2A guide](/versions/2.0.8/en/building-blocks/a2a) and [client/server example](https://github.com/agentscope-ai/agentscope/tree/main/examples/a2a).
  </Accordion>

  <Accordion title="How do I approve tool calls or interrupt an agent?">
    Configure the [permission system](/versions/2.0.8/en/building-blocks/permission-system/overview) to allow, deny, or request confirmation for tool calls. When confirmation is required, present the request to the user and return their decision through the [human-in-the-loop events](/versions/2.0.8/en/building-blocks/agent/human-in-the-loop).

    To stop an ongoing run, use the separate [interruption flow](/versions/2.0.8/en/building-blocks/agent/interrupt-agent).
  </Accordion>

  <Accordion title="How do I use AgentScope with an AI coding assistant?">
    Install the official [agentscope-skill](https://github.com/agentscope-ai/skills/tree/main/skills/agentscope-skill) to provide AgentScope guidance, API references, and examples. Give the assistant your installed SDK version and use the [documentation index](/llms.txt) to find matching pages.

    Ask it to verify API names against that version and run the resulting example.
  </Accordion>

  <Accordion title="Are there implementations other than Python?">
    Yes. AgentScope also has [TypeScript](https://github.com/agentscope-ai/agentscope-typescript) and [Java](https://github.com/agentscope-ai/agentscope-java) implementations, each with its own repository and release schedule.

    Use the selected implementation's documentation and examples. Their APIs are not interchangeable; this documentation describes the Python SDK.
  </Accordion>
</AccordionGroup>