agentrun-inner-test 0.0.12__tar.gz

agentrun_inner_test-0.0.12/LICENSE

@@ -0,0 +1,201 @@
+                                 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
+      (an example is provided in the Appendix below).
+
+      "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
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2025 Serverless Devs
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

agentrun_inner_test-0.0.12/PKG-INFO

@@ -0,0 +1,262 @@
+Metadata-Version: 2.4
+Name: agentrun-inner-test
+Version: 0.0.12
+Summary: Alibaba Cloud Agent Run SDK
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: crcmod>=1.7
+Requires-Dist: pydantic>=2.12.4
+Requires-Dist: httpx>=0.23.0
+Requires-Dist: python-dotenv>=1.2.1
+Requires-Dist: typing-extensions>=4.15.0
+Requires-Dist: litellm>=1.79.3
+Requires-Dist: alibabacloud-devs20230714>=2.4.1
+Requires-Dist: pydash>=8.0.5
+Requires-Dist: alibabacloud-agentrun20250910>=4.0.1
+Requires-Dist: alibabacloud_tea_openapi>=0.4.2
+Provides-Extra: server
+Requires-Dist: fastapi>=0.104.0; extra == "server"
+Requires-Dist: uvicorn>=0.24.0; extra == "server"
+Provides-Extra: langchain
+Requires-Dist: langchain>=1.0.0; python_version >= "3.10" and extra == "langchain"
+Requires-Dist: langchain-openai>=1.0.0; python_version >= "3.10" and extra == "langchain"
+Provides-Extra: google-adk
+Requires-Dist: google-adk>=1.18.0; extra == "google-adk"
+Provides-Extra: agentscope
+Requires-Dist: agentscope>=0.1.6; extra == "agentscope"
+Provides-Extra: crewai
+Requires-Dist: crewai>=1.6.0; extra == "crewai"
+Provides-Extra: pydantic-ai
+Requires-Dist: pydantic-ai>=1.22.0; python_version >= "3.10" and extra == "pydantic-ai"
+Provides-Extra: playwright
+Requires-Dist: playwright>=1.40.0; extra == "playwright"
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.21.2; python_version >= "3.10" and extra == "mcp"
+Dynamic: license-file
+
+# AgentRun Python SDK
+
+<div align="center">
+
+[![PyPI version](https://img.shields.io/pypi/v/agentrun-sdk.svg)](https://pypi.org/project/agentrun-sdk/)
+[![License](https://img.shields.io/github/license/Serverless-Devs/agentrun-sdk-python.svg)](https://github.com/Serverless-Devs/agentrun-sdk-python/blob/main/LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-agent.run-blue.svg)](https://docs.agent.run)
+[![GitHub stars](https://img.shields.io/github/stars/Serverless-Devs/agentrun-sdk-python.svg?style=social)](https://github.com/Serverless-Devs/agentrun-sdk-python)
+[![GitHub issues](https://img.shields.io/github/issues/Serverless-Devs/agentrun-sdk-python.svg)](https://github.com/Serverless-Devs/agentrun-sdk-python/issues)
+
+</div>
+
+AgentRun Python SDK 是阿里云 AgentRun 服务的 Python 客户端库，提供简洁易用的 API 来管理 AI Agent 运行时环境。
+
+## ✨ 特性
+
+- 🎯 **简洁 API** - 面向对象的设计，直观易用
+- ⚡ **异步支持** - 同时提供同步和异步接口
+- 🔧 **类型提示** - 完整的类型注解，IDE 友好
+- 🔐 **多种认证** - 支持 Access Key、STS Token 等
+- 🌐 **多区域** - 支持阿里云所有可用区域
+- 📝 **详细文档** - 完善的代码注释和示例
+
+## 📦 安装
+
+### 使用 pip 安装
+
+```bash
+pip install agentrun-sdk
+```
+
+可选依赖项
+- `server`: 使用 AgentRunServer 集成 HTTP 服务
+- `playwright：使用` Browser Sandbox 并集成 playwright
+- `mcp：使用` MCP ToolSet
+- `agentscope：集成` AgentScope
+- `langchain：集成` LangChain
+- `google`-adk：集成 Google ADK
+- `crewai：集成` CrewAI
+- `pydantic`-ai：集成 PydanticAI
+
+假设您需要使用 agentscope，并且需要用到 Browser Sandbox，AgentRun 上的 MCP 服务，那么您应该通过如下方式安装
+```bash
+pip install agentrun-sdk[playwright,mcp,agentscope]
+```
+
+
+### 依赖要求
+
+- Python 3.10 或更高版本
+
+## 🚀 快速开始
+
+你可以使用任意您喜欢的框架进行 Agent 开发，这里以 langchain 为例
+
+### 1. 安装 Serverless Devs
+
+运行脚手架，您需要使用 Serverless Devs 工具，请参考对应 [安装教程](https://serverless-devs.com/docs/user-guide/install)
+> 如果您拥有 NodeJS 开发环境，可以使用 `npm i -g @serverless-devs/s` 快速安装 Serverless Devs
+> 您也可以直接下载 [Serverless Devs 二进制程序](https://github.com/Serverless-Devs/Serverless-Devs/releases) 使用 Serverless Devs
+
+
+### 2. 创建模板
+
+使用快速创建脚手架创建您的 Agent
+
+**注意！** 您需要确保您的 python 环境在 3.10 以上
+
+```bash
+# 初始化模板
+s init agentrun-quick-start-langchain
+
+# 按照实际情况进入代码目录
+cd agentrun-quick-start-langchain/code
+
+# 初始化虚拟环境并安装依赖
+uv venv && uv pip install -r requirements.txt
+```
+
+### 3. 配置认证信息
+
+设置环境变量（建议通过 `.env` 配置您的环境变量）
+
+```bash
+export AGENTRUN_ACCESS_KEY_ID="your-access-key-id"
+export AGENTRUN_ACCESS_KEY_SECRET="your-access-key-secret"
+export AGENTRUN_ACCOUNT_ID="your-account-id"
+export AGENTRUN_REGION="cn-hangzhou"
+```
+
+### 4. 了解 Agent 如何与 LangChain 集成
+
+
+使用 `from agentrun.integration.langchain import model, sandbox_toolset` 导入 langchain 的集成能力，这里默认提供了 `model`、`sandbox_toolset`、`toolset`，可以快速创建 langchain 可识别的大模型、工具
+同时，通过 AgentRunServer 可以快速开放 HTTP Server 供其他业务集成
+
+```python
+from agentrun.integration.langchain import model, sandbox_toolset
+from agentrun.sandbox import TemplateType
+from agentrun.server import AgentRequest, AgentRunServer
+from agentrun.utils.log import logger
+
+# 请替换为您已经创建的 模型 和 沙箱 名称
+MODEL_NAME = "<your-model-name>"
+SANDBOX_NAME = "<your-sandbox-name>"
+
+if MODEL_NAME.startswith("<"):
+    raise ValueError("请将 MODEL_NAME 替换为您已经创建的模型名称")
+
+code_interpreter_tools = []
+if SANDBOX_NAME and not SANDBOX_NAME.startswith("<"):
+    code_interpreter_tools = sandbox_toolset(
+        template_name=SANDBOX_NAME,
+        template_type=TemplateType.CODE_INTERPRETER,
+        sandbox_idle_timeout_seconds=300,
+    )
+else:
+    logger.warning("SANDBOX_NAME 未设置或未替换，跳过加载沙箱工具。")
+
+# ...
+
+# 自动启动 http server，提供 OpenAI 协议
+AgentRunServer(invoke_agent=invoke_agent).start()
+```
+
+### 5. 调用 Agent
+
+```bash
+curl 127.0.0.1:9000/openai/v1/chat/completions \
+  -XPOST \
+  -H "content-type: application/json" \
+  -d '{"messages": [{"role": "user", "content": "通过代码查询现在是几点?"}], "stream":true}'
+```
+
+### 6. 部署项目
+
+项目中已经存在 `s.yaml` 文件，这是 Serverless Devs 的部署配置文件，通过这个文件，您可以配置当前 Agent 在 Agent Run 上的名称、CPU/内存规格、日志投递信息
+
+在示例情况下，您只需要简单修改该文件即可。修改 `role` 字段为授信给阿里云函数计算（FC）服务，需要拥有AliyunAgentRunFullAccess权限的角色（如果您拥有精细化权限控制的需求，可以根据实际使用的 API 收敛权限）
+
+> 您可以点击此[快速授权链接](https://ram.console.aliyun.com/authorize?request=%7B%22template%22%3A%22OldRoleCommonAuthorize%22%2C%22referrer%22%3A%22https%3A%2F%2Ffunctionai.console.aliyun.com%2Fcn-hangzhou%2Fexplore%22%2C%22payloads%22%3A%5B%7B%22missionId%22%3A%22OldRoleCommonAuthorize.FC%22%2C%22roleName%22%3A%22agentRunRole%22%2C%22roleDescription%22%3A%22AgentRun%20auto%20created%20role.%22%2C%22rolePolicies%22%3A%5B%7B%22policyName%22%3A%22AliyunAgentRunFullAccess%22%7D%2C%7B%22policyName%22%3A%22AliyunDevsFullAccess%22%7D%5D%7D%5D%2C%22callback%22%3A%22https%3A%2F%2Ffunctionai.console.aliyun.com%22%7D)，创建一个符合相关权限的角色agentRunRole。
+> 
+> 此快速创建角色的RoleArn为：acs:ram::{您的阿里云主账号 ID}:role/agentRunRole
+
+```yaml
+role: acs:ram::{您的阿里云主账号 ID}:role/{您的阿里云角色名称}
+```
+
+> 如果在未来的使用中遇到了任何 Serverless Devs 相关问题，都可以参考 [Serverless Devs 相关文档](https://serverless-devs.com/docs/overview)
+
+在部署前，您需要配置您的部署密钥，使用 `s config add` 进入交互式密钥管理，并按照引导录入您在阿里云的 Access Key ID 与 Access Key Secret。在录入过程中，您需要短期记忆一下您输入的密钥对名称（假设为 `agentrun-deploy`）
+
+配置完成后，需要首先执行`s build`构建，该步骤依赖本地的`docker`服务，对代码目录下的`requirements.txt`进行构建，以便部署在云端。
+
+随后即可执行`s deploy`进行部署操作。
+
+```bash
+s build
+s deploy -a agentrun-deploy
+# agentrun-deploy 是您使用的密钥对名称，也可以将该名称写入到 s.yaml 开头的 access: 字段中
+```
+
+### 7. 在线上进行调用
+
+部署完成后，您可以看到如下格式的输出
+```
+endpoints: 
+      - 
+        id:          ...
+        arn:         ...
+        name:        ...
+        url:         https://12345.agentrun-data.cn-hangzhou.aliyuncs.com/agent-runtimes/abcd/endpoints/prod/invocations
+```
+
+此处的 url 为您的 Agent 调用地址，将实际的请求 path 拼接到该 base url 后，即可调用云上的 Agent 资源
+
+```bash
+curl https://12345.agentrun-data.cn-hangzhou.aliyuncs.com/agent-runtimes/abcd/endpoints/prod/invocations/openai/v1/chat/completions \
+  -XPOST \
+  -H "content-type: application/json" \
+  -d '{"messages": [{"role": "user", "content": "通过代码查询现在是几点?"}], "stream":true}'
+```
+
+## ⚙️ 配置说明
+
+### Config 类
+
+用于配置认证信息和客户端参数。
+
+```python
+from agentrun.utils.config import Config
+
+config = Config(
+    access_key_id="your-key-id",            # Access Key ID
+    access_key_secret="your-secret",        # Access Key Secret
+    security_token="your-sts-token",        # 可选：STS Token
+    token="token",                          # 数据链路 token（可以在无 AK 情况下调用数据链路）
+    headers={},                             # 附加的请求头
+    account_id="your-account-id",           # 账号 ID
+    region_id="cn-hangzhou",                # 区域
+    timeout=30,                             # 可选：请求超时（秒）
+    control_endpoint="",                    # 可选：自定义控制端点
+    data_endpoint="",                       # 可选：自定义数据端点
+)
+
+# 使用配置创建客户端
+client = agent_runtime.AgentRuntimeClient()
+agent = client.create(input_config, config=config)
+```
+
+### 环境变量
+
+SDK 会自动读取以下环境变量：
+
+| 环境变量 | 说明 | 备用变量 |
+|---------|------|---------|
+| `AGENTRUN_ACCESS_KEY_ID` | Access Key ID | `ALIBABA_CLOUD_ACCESS_KEY_ID` |
+| `AGENTRUN_ACCESS_KEY_SECRET` | Access Key Secret | `ALIBABA_CLOUD_ACCESS_KEY_SECRET` |
+| `AGENTRUN_SECURITY_TOKEN` | STS Token | `ALIBABA_CLOUD_SECURITY_TOKEN` |
+| `AGENTRUN_ACCOUNT_ID` | 账号 ID | `FC_ACCOUNT_ID` |
+| `AGENTRUN_REGION` | 区域 | `FC_REGION` |
+| `AGENTRUN_CONTROL_ENDPOINT` | 控制端点 | - |
+| `AGENTRUN_DATA_ENDPOINT` | 数据端点 | - |
+| `AGENTRUN_SDK_DEBUG` | 开启 DEBUG 日志 | - |
+