agentengine-sdk-python 0.6.4__tar.gz → 0.7.0__tar.gz

agentengine_sdk_python-0.7.0/LICENSE

@@ -0,0 +1,175 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+"License" shall mean the terms and conditions for use, reproduction,
+and distribution as defined by Sections 1 through 9 of this document.
+
+"Licensor" shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+"Legal Entity" shall mean the union of the acting entity and all
+other entities that control, are controlled by, or are under common
+control with that entity. For the purposes of this definition,
+"control" means (i) the power, direct or indirect, to cause the
+direction or management of such entity, whether by contract or
+otherwise, or (ii) ownership of fifty percent (50%) or more of the
+outstanding shares, or (iii) beneficial ownership of such entity.
+
+"You" (or "Your") shall mean an individual or Legal Entity
+exercising permissions granted by this License.
+
+"Source" form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation
+source, and configuration files.
+
+"Object" form shall mean any form resulting from mechanical
+transformation or translation of a Source form, including but
+not limited to compiled object code, generated documentation,
+and conversions to other media types.
+
+"Work" shall mean the work of authorship, whether in Source or
+Object form, made available under the License, as indicated by a
+copyright notice that is included in or attached to the work.
+
+"Derivative Works" shall mean any work, whether in Source or Object
+form, that is based on (or derived from) the Work and for which the
+editorial revisions, annotations, elaborations, or other modifications
+represent, as a whole, an original work of authorship. For the purposes
+of this License, Derivative Works shall not include works that remain
+separable from, or merely link (or bind by name) to the interfaces of,
+the Work and Derivative Works thereof.
+
+"Contribution" shall mean any work of authorship, including
+the original version of the Work and any modifications or additions
+to that Work or Derivative Works thereof, that is intentionally
+submitted to Licensor for inclusion in the Work by the copyright owner
+or by an individual or Legal Entity authorized to submit on behalf of
+the copyright owner. For the purposes of this definition, "submitted"
+means any form of electronic, verbal, or written communication sent
+to the Licensor or its representatives, including but not limited to
+communication on electronic mailing lists, source code control systems,
+and issue tracking systems that are managed by, or on behalf of, the
+Licensor for the purpose of discussing and improving the Work, but
+excluding communication that is conspicuously marked or otherwise
+designated in writing by the copyright owner as "Not a Contribution."
+
+"Contributor" shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and
+subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the
+Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+this License, each Contributor hereby grants to You a perpetual,
+worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except as stated in this section) patent license to make, have made,
+use, offer to sell, sell, import, and otherwise transfer the Work,
+where such license applies only to those patent claims licensable
+by such Contributor that are necessarily infringed by their
+Contribution(s) alone or by combination of their Contribution(s)
+with the Work to which such Contribution(s) was submitted. If You
+institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work
+or a Contribution incorporated within the Work constitutes direct
+or contributory patent infringement, then any patent licenses
+granted to You under this License for that Work shall terminate
+as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+Work or Derivative Works thereof in any medium, with or without
+modifications, and in Source or Object form, provided that You
+meet the following conditions:
+
+(a) You must give any other recipients of the Work or
+Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices
+stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works
+that You distribute, all copyright, patent, trademark, and
+attribution notices from the Source form of the Work, excluding
+those notices that do not pertain to any part of the
+Derivative Works; and
+
+(d) If the Work includes a "NOTICE" text file as part of its
+distribution, then any Derivative Works that You distribute must
+include a readable copy of the attribution notices contained
+within such NOTICE file, excluding those notices that do not
+pertain to any part of the Derivative Works, in at least one
+of the following places: within a NOTICE text file distributed
+as part of the Derivative Works; within the Source form or
+documentation, if provided along with the Derivative Works; or,
+within a display generated by the Derivative Works, if and
+wherever such third-party notices normally appear. The contents
+of the NOTICE file are for informational purposes only and
+do not modify the License. You may add Your own attribution
+notices within Derivative Works that You distribute, alongside
+or as an addendum to the NOTICE text from the Work, provided
+that such additional attribution notices cannot be construed
+as modifying the License.
+
+You may add Your own copyright statement to Your modifications and
+may provide additional or different license terms and conditions
+for use, reproduction, or distribution of Your modifications, or
+for any such Derivative Works as a whole, provided Your use,
+reproduction, and distribution of the Work otherwise complies with
+the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+any Contribution intentionally submitted for inclusion in the Work
+by You to the Licensor shall be under the terms and conditions of
+this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify
+the terms of any separate license agreement you may have executed
+with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+names, trademarks, service marks, or product names of the Licensor,
+except as required for reasonable and customary use in describing the
+origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+agreed to in writing, Licensor provides the Work (and each
+Contributor provides its Contributions) on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+implied, including, without limitation, any warranties or conditions
+of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+PARTICULAR PURPOSE. You are solely responsible for determining the
+appropriateness of using or redistributing the Work and assume any
+risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+whether in tort (including negligence), contract, or otherwise,
+unless required by applicable law (such as deliberate and grossly
+negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special,
+incidental, or consequential damages of any character arising as a
+result of this License or out of the use or inability to use the
+Work (including but not limited to damages for loss of goodwill,
+work stoppage, computer failure or malfunction, or any and all
+other commercial damages or losses), even if such Contributor
+has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+the Work or Derivative Works thereof, You may choose to offer,
+and charge a fee for, acceptance of support, warranty, indemnity,
+or other liability obligations and/or rights consistent with this
+License. However, in accepting such obligations, You may act only
+on Your own behalf and on Your sole responsibility, not on behalf
+of any other Contributor, and only if You agree to indemnify,
+defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason
+of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS

agentengine_sdk_python-0.7.0/MANIFEST.in

@@ -0,0 +1,3 @@
+prune ksadk/server/web-ui
+recursive-exclude ksadk/server/web-ui *
+recursive-include ksadk_runtime_common/schemas *.json

agentengine_sdk_python-0.7.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: agentengine-sdk-python
+Version: 0.7.0
+Summary: Kingsoft Cloud Agent Engine SDK alias package for ksadk
+Author-email: KsADK Team <xiayu@kingsoft.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Repository, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Documentation, https://kingsoftcloud.github.io/ksadk-python/
+Keywords: agent,langchain,langgraph,deepagents,adk,faas,kingsoft cloud,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: jsonschema<5.0.0,>=4.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: fastapi<1.0.0,>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: python-multipart<1.0.0,>=0.0.9
+Requires-Dist: python-socks<3.0.0,>=2.7.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: a2a-sdk>=0.3.22
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: sse-starlette>=2.1.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: requests-aws4auth>=1.2.0
+Requires-Dist: kingsoftcloud-sdk-python>=1.5.8.94
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: websockets<16.0,>=12.0
+Requires-Dist: qrcode>=7.4.0
+Requires-Dist: asyncpg<1.0.0,>=0.30.0
+Requires-Dist: greenlet>=1.0.0
+Requires-Dist: ks3sdk>=1.15.0
+Requires-Dist: pypdf>=6.0.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: rapidocr-onnxruntime>=1.2.0
+Requires-Dist: langchain<2.0.0,>=1.3.0
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0
+Requires-Dist: langchain-core<2.0.0,>=1.4.0
+Requires-Dist: langgraph<1.3.0,>=1.2.0
+Requires-Dist: opentelemetry-api==1.37.0
+Requires-Dist: opentelemetry-sdk==1.37.0
+Requires-Dist: opentelemetry-exporter-otlp==1.37.0
+Provides-Extra: adk
+Requires-Dist: google-adk<2.0.0,>=1.34.0; extra == "adk"
+Requires-Dist: litellm>=1.0.0; (platform_system != "Windows" or python_version < "3.13") and extra == "adk"
+Requires-Dist: json_repair>=0.25.0; extra == "adk"
+Provides-Extra: langchain
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langchain"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langchain"
+Requires-Dist: langchain-core<2.0.0,>=1.4.0; extra == "langchain"
+Provides-Extra: langgraph
+Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "langgraph"
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langgraph"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langgraph"
+Requires-Dist: protobuf>=6.32.1; extra == "langgraph"
+Provides-Extra: deepagents
+Requires-Dist: deepagents<1.0.0,>=0.6.2; python_version >= "3.11" and extra == "deepagents"
+Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "deepagents"
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "deepagents"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "deepagents"
+Provides-Extra: a2a
+Requires-Dist: a2a-sdk[http-server]>=0.3.22; extra == "a2a"
+Provides-Extra: tracing
+Requires-Dist: openinference-instrumentation-langchain>=0.1.0; extra == "tracing"
+Provides-Extra: kb
+Provides-Extra: skills
+Requires-Dist: e2b>=2.0.0; extra == "skills"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: fastmcp>=2.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: ksadk[a2a,adk,deepagents,dev,kb,langchain,langgraph,skills,tracing]; extra == "all"
+Dynamic: license-file
+
+<h1 align="center">Kingsoft Cloud Agent Development Kit</h1>
+
+<p align="center"><strong>金山云智能体开发套件</strong></p>
+
+<p align="center">
+  构建、部署、调试、观测企业级 AI 智能体的一站式云原生框架。
+  兼容 Google ADK、LangGraph、LangChain 与 DeepAgents，并支持一键拉起 OpenClaw 和 Hermes 运行时。
+</p>
+
+<p align="center"><a href="README.md">简体中文（默认）</a> · <a href="README.en.md">English</a></p>
+
+<p align="center">
+  <a href="https://kingsoftcloud.github.io/ksadk-python/"><img alt="Docs" src="https://img.shields.io/badge/Docs-ksadk--python-2f6fdf?style=flat" /></a>
+  <a href="https://pypi.org/project/ksadk/"><img alt="PyPI" src="https://img.shields.io/pypi/v/ksadk?style=flat&color=2f6fdf" /></a>
+  <a href="https://zread.ai/kingsoftcloud/ksadk-python"><img alt="Ask Zread" src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" /></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat" /></a>
+</p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero.png"><img alt="KsADK 真实 CLI 截图：agentengine -h" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero-wide.png" width="860" /></a></p>
+
+## 30 秒快速体验
+
+```bash
+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
+```
+
+启动本地调试 Web UI：
+
+```bash
+agentengine web . --no-open
+```
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png"><img alt="KsADK 真实 Web UI 调试截图" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png" width="860" /></a></p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>
+
+## 为什么需要 KsADK
+
+大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
+
+- 本地开发：`agentengine init`、`agentengine run`、`agentengine web`。
+- 统一调试：浏览器 Web UI、streaming、附件、workspace 文件、工具调用和会话。
+- 统一协议：本地 `/v1/responses` 与 `/v1/chat/completions`。
+- 工具边界：Skill Runtime、Workspace、Sandbox、Memory、Knowledge。
+- 工程链路：打包、部署、OpenClaw / Hermes 运行时、OpenTelemetry 可观测。
+
+## 架构
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png"><img alt="KsADK 智能体运行时平台架构" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png" width="860" /></a></p>
+
+## 文档与样例
+
+- 文档：<https://kingsoftcloud.github.io/ksadk-python/>
+- 快速开始：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/quickstart/>
+- 为什么需要 KsADK：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/why-ksadk/>
+- 架构：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/architecture/>
+- 生态定位对比：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/comparison/>
+- 可观测：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/observability-tracing/>
+- 云端部署：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/cloud-deployment/>
+- 样例仓库：<https://github.com/kingsoftcloud/ksadk-samples>
+
+## 相关项目
+
+- KsADK 仓库：<https://github.com/kingsoftcloud/ksadk-python>
+- Web UI 仓库：<https://github.com/kingsoftcloud/ksadk-web>
+- Wiki：<https://zread.ai/kingsoftcloud/ksadk-python>
+- PyPI：<https://pypi.org/project/ksadk/>
+
+## 参与贡献
+
+欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行：
+
+```bash
+make public-preflight
+```
+
+开源协议：Apache-2.0。

agentengine_sdk_python-0.7.0/README.md

@@ -0,0 +1,84 @@
+<h1 align="center">Kingsoft Cloud Agent Development Kit</h1>
+
+<p align="center"><strong>金山云智能体开发套件</strong></p>
+
+<p align="center">
+  构建、部署、调试、观测企业级 AI 智能体的一站式云原生框架。
+  兼容 Google ADK、LangGraph、LangChain 与 DeepAgents，并支持一键拉起 OpenClaw 和 Hermes 运行时。
+</p>
+
+<p align="center"><a href="README.md">简体中文（默认）</a> · <a href="README.en.md">English</a></p>
+
+<p align="center">
+  <a href="https://kingsoftcloud.github.io/ksadk-python/"><img alt="Docs" src="https://img.shields.io/badge/Docs-ksadk--python-2f6fdf?style=flat" /></a>
+  <a href="https://pypi.org/project/ksadk/"><img alt="PyPI" src="https://img.shields.io/pypi/v/ksadk?style=flat&color=2f6fdf" /></a>
+  <a href="https://zread.ai/kingsoftcloud/ksadk-python"><img alt="Ask Zread" src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" /></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat" /></a>
+</p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero.png"><img alt="KsADK 真实 CLI 截图：agentengine -h" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero-wide.png" width="860" /></a></p>
+
+## 30 秒快速体验
+
+```bash
+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
+```
+
+启动本地调试 Web UI：
+
+```bash
+agentengine web . --no-open
+```
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png"><img alt="KsADK 真实 Web UI 调试截图" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png" width="860" /></a></p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>
+
+## 为什么需要 KsADK
+
+大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
+
+- 本地开发：`agentengine init`、`agentengine run`、`agentengine web`。
+- 统一调试：浏览器 Web UI、streaming、附件、workspace 文件、工具调用和会话。
+- 统一协议：本地 `/v1/responses` 与 `/v1/chat/completions`。
+- 工具边界：Skill Runtime、Workspace、Sandbox、Memory、Knowledge。
+- 工程链路：打包、部署、OpenClaw / Hermes 运行时、OpenTelemetry 可观测。
+
+## 架构
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png"><img alt="KsADK 智能体运行时平台架构" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png" width="860" /></a></p>
+
+## 文档与样例
+
+- 文档：<https://kingsoftcloud.github.io/ksadk-python/>
+- 快速开始：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/quickstart/>
+- 为什么需要 KsADK：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/why-ksadk/>
+- 架构：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/architecture/>
+- 生态定位对比：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/comparison/>
+- 可观测：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/observability-tracing/>
+- 云端部署：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/cloud-deployment/>
+- 样例仓库：<https://github.com/kingsoftcloud/ksadk-samples>
+
+## 相关项目
+
+- KsADK 仓库：<https://github.com/kingsoftcloud/ksadk-python>
+- Web UI 仓库：<https://github.com/kingsoftcloud/ksadk-web>
+- Wiki：<https://zread.ai/kingsoftcloud/ksadk-python>
+- PyPI：<https://pypi.org/project/ksadk/>
+
+## 参与贡献
+
+欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行：
+
+```bash
+make public-preflight
+```
+
+开源协议：Apache-2.0。

agentengine_sdk_python-0.7.0/agentengine_sdk_python.egg-info/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: agentengine-sdk-python
+Version: 0.7.0
+Summary: Kingsoft Cloud Agent Engine SDK alias package for ksadk
+Author-email: KsADK Team <xiayu@kingsoft.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Repository, https://github.com/kingsoftcloud/ksadk-python
+Project-URL: Documentation, https://kingsoftcloud.github.io/ksadk-python/
+Keywords: agent,langchain,langgraph,deepagents,adk,faas,kingsoft cloud,ai,llm
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.0.0
+Requires-Dist: pyyaml>=6.0.0
+Requires-Dist: packaging>=23.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: jsonschema<5.0.0,>=4.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: prompt_toolkit>=3.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: fastapi<1.0.0,>=0.100.0
+Requires-Dist: uvicorn>=0.23.0
+Requires-Dist: python-multipart<1.0.0,>=0.0.9
+Requires-Dist: python-socks<3.0.0,>=2.7.1
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: a2a-sdk>=0.3.22
+Requires-Dist: httpx-sse>=0.4.0
+Requires-Dist: sse-starlette>=2.1.0
+Requires-Dist: requests>=2.28.0
+Requires-Dist: requests-aws4auth>=1.2.0
+Requires-Dist: kingsoftcloud-sdk-python>=1.5.8.94
+Requires-Dist: cryptography>=44.0.0
+Requires-Dist: websockets<16.0,>=12.0
+Requires-Dist: qrcode>=7.4.0
+Requires-Dist: asyncpg<1.0.0,>=0.30.0
+Requires-Dist: greenlet>=1.0.0
+Requires-Dist: ks3sdk>=1.15.0
+Requires-Dist: pypdf>=6.0.0
+Requires-Dist: beautifulsoup4>=4.12.0
+Requires-Dist: rapidocr-onnxruntime>=1.2.0
+Requires-Dist: langchain<2.0.0,>=1.3.0
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0
+Requires-Dist: langchain-core<2.0.0,>=1.4.0
+Requires-Dist: langgraph<1.3.0,>=1.2.0
+Requires-Dist: opentelemetry-api==1.37.0
+Requires-Dist: opentelemetry-sdk==1.37.0
+Requires-Dist: opentelemetry-exporter-otlp==1.37.0
+Provides-Extra: adk
+Requires-Dist: google-adk<2.0.0,>=1.34.0; extra == "adk"
+Requires-Dist: litellm>=1.0.0; (platform_system != "Windows" or python_version < "3.13") and extra == "adk"
+Requires-Dist: json_repair>=0.25.0; extra == "adk"
+Provides-Extra: langchain
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langchain"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langchain"
+Requires-Dist: langchain-core<2.0.0,>=1.4.0; extra == "langchain"
+Provides-Extra: langgraph
+Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "langgraph"
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "langgraph"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "langgraph"
+Requires-Dist: protobuf>=6.32.1; extra == "langgraph"
+Provides-Extra: deepagents
+Requires-Dist: deepagents<1.0.0,>=0.6.2; python_version >= "3.11" and extra == "deepagents"
+Requires-Dist: langgraph<1.3.0,>=1.2.0; extra == "deepagents"
+Requires-Dist: langchain<2.0.0,>=1.3.0; extra == "deepagents"
+Requires-Dist: langchain-openai<2.0.0,>=1.2.0; extra == "deepagents"
+Provides-Extra: a2a
+Requires-Dist: a2a-sdk[http-server]>=0.3.22; extra == "a2a"
+Provides-Extra: tracing
+Requires-Dist: openinference-instrumentation-langchain>=0.1.0; extra == "tracing"
+Provides-Extra: kb
+Provides-Extra: skills
+Requires-Dist: e2b>=2.0.0; extra == "skills"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: fastmcp>=2.0.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=5.0.0; extra == "dev"
+Requires-Dist: black>=22.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Provides-Extra: all
+Requires-Dist: ksadk[a2a,adk,deepagents,dev,kb,langchain,langgraph,skills,tracing]; extra == "all"
+Dynamic: license-file
+
+<h1 align="center">Kingsoft Cloud Agent Development Kit</h1>
+
+<p align="center"><strong>金山云智能体开发套件</strong></p>
+
+<p align="center">
+  构建、部署、调试、观测企业级 AI 智能体的一站式云原生框架。
+  兼容 Google ADK、LangGraph、LangChain 与 DeepAgents，并支持一键拉起 OpenClaw 和 Hermes 运行时。
+</p>
+
+<p align="center"><a href="README.md">简体中文（默认）</a> · <a href="README.en.md">English</a></p>
+
+<p align="center">
+  <a href="https://kingsoftcloud.github.io/ksadk-python/"><img alt="Docs" src="https://img.shields.io/badge/Docs-ksadk--python-2f6fdf?style=flat" /></a>
+  <a href="https://pypi.org/project/ksadk/"><img alt="PyPI" src="https://img.shields.io/pypi/v/ksadk?style=flat&color=2f6fdf" /></a>
+  <a href="https://zread.ai/kingsoftcloud/ksadk-python"><img alt="Ask Zread" src="https://img.shields.io/badge/Ask_Zread-_.svg?style=flat&color=00b0aa&labelColor=000000&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB3aWR0aD0iMTYiIGhlaWdodD0iMTYiIHZpZXdCb3g9IjAgMCAxNiAxNiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHBhdGggZD0iTTQuOTYxNTYgMS42MDAxSDIuMjQxNTZDMS44ODgxIDEuNjAwMSAxLjYwMTU2IDEuODg2NjQgMS42MDE1NiAyLjI0MDFWNC45NjAxQzEuNjAxNTYgNS4zMTM1NiAxLjg4ODEgNS42MDAxIDIuMjQxNTYgNS42MDAxSDQuOTYxNTZDNS4zMTUwMiA1LjYwMDEgNS42MDE1NiA1LjMxMzU2IDUuNjAxNTYgNC45NjAxVjIuMjQwMUM1LjYwMTU2IDEuODg2NjQgNS4zMTUwMiAxLjYwMDEgNC45NjE1NiAxLjYwMDFaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00Ljk2MTU2IDEwLjM5OTlIMi4yNDE1NkMxLjg4ODEgMTAuMzk5OSAxLjYwMTU2IDEwLjY4NjQgMS42MDE1NiAxMS4wMzk5VjEzLjc1OTlDMS42MDE1NiAxNC4xMTM0IDEuODg4MSAxNC4zOTk5IDIuMjQxNTYgMTQuMzk5OUg0Ljk2MTU2QzUuMzE1MDIgMTQuMzk5OSA1LjYwMTU2IDE0LjExMzQgNS42MDE1NiAxMy43NTk5VjExLjAzOTlDNS42MDE1NiAxMC42ODY0IDUuMzE1MDIgMTAuMzk5OSA0Ljk2MTU2IDEwLjM5OTlaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik0xMy43NTg0IDEuNjAwMUgxMS4wMzg0QzEwLjY4NSAxLjYwMDEgMTAuMzk4NCAxLjg4NjY0IDEwLjM5ODQgMi4yNDAxVjQuOTYwMUMxMC4zOTg0IDUuMzEzNTYgMTAuNjg1IDUuNjAwMSAxMS4wMzg0IDUuNjAwMUgxMy43NTg0QzE0LjExMTkgNS42MDAxIDE0LjM5ODQgNS4zMTM1NiAxNC4zOTg0IDQuOTYwMVYyLjI0MDFDMTQuMzk4NCAxLjg4NjY0IDE0LjExMTkgMS42MDAxIDEzLjc1ODQgMS42MDAxWiIgZmlsbD0iI2ZmZiIvPgo8cGF0aCBkPSJNNCAxMkwxMiA0TDQgMTJaIiBmaWxsPSIjZmZmIi8%2BCjxwYXRoIGQ9Ik00IDEyTDEyIDQiIHN0cm9rZT0iI2ZmZiIgc3Ryb2tlLXdpZHRoPSIxLjUiIHN0cm9rZS1saW5lY2FwPSJyb3VuZCIvPgo8L3N2Zz4K&logoColor=ffffff" /></a>
+  <a href="LICENSE"><img alt="License" src="https://img.shields.io/badge/License-Apache--2.0-blue?style=flat" /></a>
+</p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero.png"><img alt="KsADK 真实 CLI 截图：agentengine -h" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-platform-hero-wide.png" width="860" /></a></p>
+
+## 30 秒快速体验
+
+```bash
+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
+```
+
+启动本地调试 Web UI：
+
+```bash
+agentengine web . --no-open
+```
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png"><img alt="KsADK 真实 Web UI 调试截图" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-web-ui-screenshot.png" width="860" /></a></p>
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif"><img alt="KsADK 真实本地 Web UI 演示" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-local-debugging-demo.gif" width="860" /></a></p>
+
+## 为什么需要 KsADK
+
+大多数 Agent 框架解决“如何开发 Agent”。KsADK 解决“如何运行、调试、部署和观测 Agent”。
+
+- 本地开发：`agentengine init`、`agentengine run`、`agentengine web`。
+- 统一调试：浏览器 Web UI、streaming、附件、workspace 文件、工具调用和会话。
+- 统一协议：本地 `/v1/responses` 与 `/v1/chat/completions`。
+- 工具边界：Skill Runtime、Workspace、Sandbox、Memory、Knowledge。
+- 工程链路：打包、部署、OpenClaw / Hermes 运行时、OpenTelemetry 可观测。
+
+## 架构
+
+<p align="center"><a href="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png"><img alt="KsADK 智能体运行时平台架构" src="https://raw.githubusercontent.com/kingsoftcloud/ksadk-python/main/docs-site/public/assets/ksadk-runtime-architecture.png" width="860" /></a></p>
+
+## 文档与样例
+
+- 文档：<https://kingsoftcloud.github.io/ksadk-python/>
+- 快速开始：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/quickstart/>
+- 为什么需要 KsADK：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/why-ksadk/>
+- 架构：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/architecture/>
+- 生态定位对比：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/getting-started/comparison/>
+- 可观测：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/observability-tracing/>
+- 云端部署：<https://kingsoftcloud.github.io/ksadk-python/cn/docs/framework/guides/cloud-deployment/>
+- 样例仓库：<https://github.com/kingsoftcloud/ksadk-samples>
+
+## 相关项目
+
+- KsADK 仓库：<https://github.com/kingsoftcloud/ksadk-python>
+- Web UI 仓库：<https://github.com/kingsoftcloud/ksadk-web>
+- Wiki：<https://zread.ai/kingsoftcloud/ksadk-python>
+- PyPI：<https://pypi.org/project/ksadk/>
+
+## 参与贡献
+
+欢迎通过 issue、PR、样例和文档改进参与贡献。提交前建议运行：
+
+```bash
+make public-preflight
+```
+
+开源协议：Apache-2.0。