feat: add mobile_run tool (#344)

* 添加手机sandbox tool 和 备注

* 合并接口

* 删除不需要的tos配置，增加获取id的link

* 添加获取参数的地址

* 删除中文注释 改成英文

* 修复pre-commit

* 简化配置

* 添加tool id版本的使用手册

* 修复对齐问题

* release 0.2.29 (#347)

* release 0.2.29

* restrict adk version to 1.19

---------

Co-authored-by: yaozheng-fang <[email protected]>

Author: wangyu-bytedance

config.yaml.full

@@ -57,6 +57,11 @@ tool:
     api_key:    # `app_secret`
     token:      # `user_token`
   # [optional] for Volcengine Lake AI Service https://www.volcengine.com/product/las
+  mobile_use:
+    tool_id: #https://console.volcengine.com/ACEP
+      - # `product_id`-`pod_id_1`
+      - # `product_id`-`pod_id_1`
+
   las:
     url: #mcp sse url
     dataset_id:  #dataset name

docs/content/5.tools/1.builtin-tools.md

@@ -9,17 +9,20 @@ navigation:
 
 VeADK 中集成了多个火山引擎提供的工具：
 
-| 工具名称 | 说明 | 导入方法 |
-| :- | :- | :- |
-| [`web_search`](https://www.volcengine.com/docs/85508/1650263) | 公域搜索 | `from veadk.tools.builtin_tools.web_search import web_search` |
-| [`web_scraper`](https://www.volcengine.com/docs/84296/1545470) | 聚合搜索（邀测阶段），代码见[这里](https://github.com/volcengine/mcp-server/tree/main/server) | `from veadk.tools.builtin_tools.web_scraper import web_scraper` |
-| [`vesearch`](https://www.volcengine.com/docs/85508/1512748) | 联网搜索，头条搜索等 | `from veadk.tools.builtin_tools.vesearch import vesearch` |
-| [`image_generate`](https://www.volcengine.com/docs/82379/1541523) | 图片生成 | `from veadk.tools.builtin_tools.image_generate import image_generate` |
-| [`image_edit`](https://www.volcengine.com/docs/82379/1541523) | 图片编辑（图生图） | `from veadk.tools.builtin_tools.image_edit import image_edit` |
-| [`video_generate`](https://www.volcengine.com/docs/82379/1520757) | 视频生成 | `from veadk.tools.builtin_tools.video_generate import video_generate` |
+| 工具名称                                                              | 说明                                                                            | 导入方法                                                                      |
+|:------------------------------------------------------------------|:------------------------------------------------------------------------------|:--------------------------------------------------------------------------|
+| [`web_search`](https://www.volcengine.com/docs/85508/1650263)     | 公域搜索                                                                          | `from veadk.tools.builtin_tools.web_search import web_search`             |
+| [`web_scraper`](https://www.volcengine.com/docs/84296/1545470)    | 聚合搜索（邀测阶段），代码见[这里](https://github.com/volcengine/mcp-server/tree/main/server) | `from veadk.tools.builtin_tools.web_scraper import web_scraper`           |
+| [`vesearch`](https://www.volcengine.com/docs/85508/1512748)       | 联网搜索，头条搜索等                                                                    | `from veadk.tools.builtin_tools.vesearch import vesearch`                 |
+| [`image_generate`](https://www.volcengine.com/docs/82379/1541523) | 图片生成                                                                          | `from veadk.tools.builtin_tools.image_generate import image_generate`     |
+| [`image_edit`](https://www.volcengine.com/docs/82379/1541523)     | 图片编辑（图生图）                                                                     | `from veadk.tools.builtin_tools.image_edit import image_edit`             |
+| [`video_generate`](https://www.volcengine.com/docs/82379/1520757) | 视频生成                                                                          | `from veadk.tools.builtin_tools.video_generate import video_generate`     |
+| [`mobile_run`](https://www.volcengine.com/docs/6394/1953040)      | 手机指令执行                                                                        | `from veadk.tools.builtin_tools.mobile_run import create_mobile_use_tool` |
 
 ::note
 使用 `vesearch` 前，请先在火山引擎控制台创建一个搜索智能体，并获取其 Endpoint。
+
+使用 `mobile_run` 前，请先在火山引擎订购云手机，并获取 product_id 和 pod_id。
 ::
 
 ## 使用
@@ -45,8 +48,9 @@ response = asyncio.run(runner.run(messages="今天的新闻"))
 
 print(response)
 ```
-  
+
 ## 系统工具
 
-- `load_knowledgebase`：检索知识库工具，在你给 Agent 传入 `knowledgebase` 参数后，将会自动挂载该工具，Agent 将在运行时自主决定何时查询知识库；
+- `load_knowledgebase`：检索知识库工具，在你给 Agent 传入 `knowledgebase` 参数后，将会自动挂载该工具，Agent
+  将在运行时自主决定何时查询知识库；
 - `load_memory`：检索长期记忆工具，在你给 Agent 传入 `long_term_memory` 参数后，将会自动挂载该工具，Agent 将在运行时自主决定何时查询长期记忆。