agentscope

# AgentScope Use this skill for AgentScope agent workflows, provider setup, retrieval and memory, FastAPI service deployment, or workspace/sandbox execution. ## Quick start - Install the broad runtime set with `uv pip install "agentscope[full]"` or install only the extras needed for one sub-skill. - Target Python 3.11 or newer. - After install, run `python scripts/check_env.py --show-backends` from the skill tree to confirm imports and local backend availability. - Read `references/repo-provenance.md` when you need to check whether this skill matches the current checkout. - Read `references/troubleshooting.md` when install or import behavior is off. ## Route map ### `sub-skills/agent-core/` Use for Agent, Toolkit, built-in tools, permissions, message/event handling, task tools, MCP tool wiring, and local skill loading. Typical triggers: - "How do I build an AgentScope agent?" - "Why is this tool blocked or inactive?" - "How do local skills load into a toolkit?" ### `sub-skills/provider-connectors/` Use for chat, embedding, formatter, and TTS provider classes, provider credentials, and provider-specific extras or environment variables. Typical triggers: - "Which extra do I need for Gemini/Ollama/XAI?" - "How do I configure embeddings or TTS?" - "Why does a provider import fail?" ### `sub-skills/rag-memory/` Use for `KnowledgeBase`, RAG middleware, vector stores, filesystem memory, mem0, ReMe, and the RAG or memory examples. Typical triggers: - "How do I index documents and search them?" - "How do I attach RAG to an agent?" - "How do mem0 or ReMe memory modes work?" ### `sub-skills/service-platform/` Use for `create_app`, storage, message buses, channels, hubs, MCP, schedules, knowledge-base service, and service bootstrap/deployment. Typical triggers: - "How do I start the AgentScope service?" - "How do I wire Redis or SQLite storage?" - "How do channels, hubs, or MCP fit into the service?" ### `sub-skills/workspace-sandboxes/` Use for local workspaces and sandboxed backends such as Docker, Bubblewrap, Apple Container, E2B, Daytona, K8s, and OpenSandbox. Typical triggers: - "How do I create a workspace?" - "Which backend do I need for this sandbox?" - "Why did archive import or backend initialization fail?" ## How to choose - If the task is about agent orchestration, start with `agent-core`. - If the task is about provider credentials or model classes, start with `provider-connectors`. - If the task is about retrieval or long-term memory, start with `rag-memory`. - If the task is about HTTP service deployment or platform routes, start with `service-platform`. - If the task is about the execution sandbox or workspace backend, start with `workspace-sandboxes`. If a task spans more than one area, read the most operationally specific sub-skill first, then cross-link to the others. ## Shared reference and diagnostics - `references/repo-provenance.md` — current repo snapshot and refresh baseline. - `references/repo-routing-metadata.json` — machine-readable routing metadata for repo-skill discovery. - `references/troubleshooting.md` — cross-cutting install/import and package-selection problems. - `scripts/check_env.py` — import and backend availability check for this skill tree. ## Minimal import check After installation, a quick check should succeed: ```bash python -c "import agentscope; from agentscope.agent import Agent; from agentscope.tool import Toolkit" ``` If that import fails, fix the environment before using any sub-skill.