Skip to content

README.en.md

Latest commit

 

History

History
103 lines (71 loc) · 5.95 KB

README.en.md

File metadata and controls

103 lines (71 loc) · 5.95 KB
Raw

Kingsoft Cloud Agent Development Kit

Agent development kit for Kingsoft Cloud

A cloud-native framework to build, deploy, debug, and observe enterprise AI agents. It works with Google ADK, LangGraph, LangChain, and DeepAgents, with one-command OpenClaw and Hermes runtime launch paths.

简体中文 · English

Docs PyPI License

Real KsADK CLI screenshot: agentengine -h

30 Seconds Quick Start

python -m venv .venv
source .venv/bin/activate
pip install -U "ksadk[all]"

agentengine init demo-agent -f langgraph
cd demo-agent
agentengine config set OPENAI_API_KEY=your-api-key OPENAI_MODEL_NAME=gpt-4o-mini
agentengine run -i

Start the local debugging Web UI:

agentengine web . --no-open

0.8.3 Runtime Architecture

KsADK 0.8.3 converges framework adaptation into stable runtime layers while preserving each framework's native execution semantics:

  • Trusted kernel: owns concurrency, cancellation, recovery, state consistency, and runtime safety boundaries.
  • Harness execution layer: owns composition, Activation, lifecycle, and shared-capability injection; each Activation selects exactly one Provider.
  • Pluggable Providers: Codex, KsADK Harness, DSH/Cordis, and Subagent run behind one Harness contract while retaining native thread, checkpoint, and event semantics.
  • Unified events: RuntimeEvent(schema_version=2) is the event source of truth for storage, replay, APIs, Studio, and hosted surfaces; v1 is read-only compatibility projection only.
  • Controlled plugins: DSH Bundle/Profile uses a pinned toolchain, immutable source digests, and rollback on failed upgrades; official Codex plugins remain owned by Codex App Server.
  • Local development loop: Studio covers authoring, builds, debugging, evaluation, and Scheduler Lite; the bundled UI is pinned to @kingsoftcloud/ksadk-web@0.3.4.

Start with the 0.8.3 runtime architecture, AgentKit Local Studio, and plugins and automations. See the changelog and PyPI badge for version history and publication status.

RuntimeEvent Schema v2 Contract

The event path is canonical RuntimeEvent(schema_version=2). Its capability descriptor is RuntimeEventVersions=[1,2], RuntimeEventDefault=2, RuntimeEventV1ProjectionModes=["snapshot_only","identity_replace"], and RuntimeEventV1ProjectionDefault="snapshot_only". Version 1 is a read-only compatibility projection.

Real KsADK Web UI debugging screenshot

Real local Web UI demo

Why KsADK

Most agent frameworks solve how to build agents. KsADK solves how to run, debug, deploy, and observe them.

  • Local development: agentengine init, agentengine run, agentengine web.
  • Unified debugging: browser Web UI, streaming, attachments, workspace files, tool calls, and sessions.
  • Unified protocol: local /v1/responses and /v1/chat/completions.
  • Tool boundaries: Skill Runtime, Workspace, Sandbox, Memory, Knowledge.
  • Engineering workflow: packaging, deployment, OpenClaw / Hermes runtimes, OpenTelemetry observability.

Architecture

KsADK technical architecture

Agent Kernel centralizes trusted control, Harness owns composition and lifecycle, and pluggable Providers preserve native execution semantics. RuntimeEvent v2 supplies one event fact chain for APIs, Studio, and hosted surfaces.

Docs And Examples

Related Projects

Contributing

Issues, pull requests, samples, and documentation improvements are welcome. Before submitting, run:

make public-preflight

License: Apache-2.0.