AIO Sandbox 工具 API 指南:使用 convert_to_markdown 将任意 URI 内容转换为 Markdown

发布时间:2026/10/10 5:55:16

AIO Sandbox 工具 API 指南:使用 convert_to_markdown 将任意 URI 内容转换为 Markdown AI Agent后端MCP 服务浏览器控制Agent 评测【免费下载链接】sandboxAll-in-One Sandbox for AI Agents that combines Browser, Shell, File, MCP and VSCode Server in a single Docker container.项目地址https://gitcode.com/gh_mirrors/sandbox103/sandbox点击查看免费下载导读AIO Sandbox 为 AI Agent 提供了一系列面向常见任务的工具 API其中第一个公开的工具能力就是内容转 Markdown。通过POST /v1/util/convert_to_markdownAgent 可以把公开网页、沙盒文件等 URI 指向的内容统一转换为干净、结构化的 Markdown 文本为后续的总结、写入文件、索引检索等下游任务提供规范输入。读完本文你将掌握该 API 的 HTTP 调用方式、Python/JavaScript 官方 SDK 用法、响应数据结构以及它在 Agent 工作流中的典型落地模式。工具 API 概览AIO Sandbox 是一个将 Browser、Shell、File、MCP 与 VSCode Server 整合在单一 Docker 容器中的 All-in-One 沙箱。在 Util 基础指南 中官方将工具类 API 定位为面向 Agent 常见任务的能力集合目前公开的工具能力包括内容转 Markdown。它的核心价值在于把异构来源网页 HTML、文档、PDF 等的内容归一化为统一的 Markdown 文本让 Agent 不必自己解析各种原始格式直接消费结构化文本。该 API 属于util分组在 OpenAPI 规范website/docs/public/v1/openapi.json中定义如下路径/v1/util/convert_to_markdown方法POST摘要Convert To Markdown请求体必需UtilConvertToMarkdownRequest包含字段uri成功响应200Response通用响应模型错误响应422HTTPValidationError即请求参数校验失败快速开始用 curl 调用转换接口原文档给出了最直接的 HTTP 调用方式。AIO Sandbox 默认监听在localhost:8080向/v1/util/convert_to_markdown发送 POST 请求即可curl -X POST http://localhost:8080/v1/util/convert_to_markdown \ -H Content-Type: application/json \ -d { uri: https://example.com }请求体只需一个必填字段uri它表示要转换的资源地址。从 UtilConvertToMarkdownRequest 类型定义 可以看出该字段类型为string官方注释将其描述为 The URI of the resource to convert要转换的资源的 URI。返回结果封装在通用的Response模型中。以 Python SDK 的类型定义sdk/python/agent_sandbox/types/response.py为例响应包含四个可选字段字段类型说明successbool操作是否成功messagestr操作结果消息dataAny操作返回的数据此处即转换后的 Markdown 文本hintstr提供给 AI Agent 的上下文提示例如标签页变化等拿到响应后Agent 可以将其交给 LLM 进行总结、写入沙盒文件或与浏览器自动化结果结合使用。注意上面的 curl 示例使用 HTTP 明文方式访问本地服务。如果部署在公网或需要鉴权请参考 认证指南 配置相应凭证与请求头。使用官方 SDK 调用Python 与 JavaScript除了原始 HTTP 接口AIO Sandbox 在仓库中还提供了自动生成的 Python 与 JavaScript SDK 封装二者均通过 Fern 从 OpenAPI 规范生成接口签名与 HTTP 端点一一对应。Python SDKPython 侧的封装位于sdk/python/agent_sandbox/util/目录client.py面向使用者的UtilClient/AsyncUtilClient返回反序列化后的Response.dataraw_client.py底层RawUtilClient返回包含完整httpx响应的包装对象同步调用方式来自 client.py 中的官方示例from agent_sandbox import Sandbox client Sandbox( base_urlhttps://yourhost.com/path/to/api, ) client.util.convert_to_markdown( uriuri, )异步调用方式import asyncio from agent_sandbox import AsyncSandbox client AsyncSandbox( base_urlhttps://yourhost.com/path/to/api, ) async def main() - None: await client.util.convert_to_markdown( uriuri, ) asyncio.run(main())从 raw_client.py 的实现可以看到convert_to_markdown实际发起的请求为路径v1/util/convert_to_markdown方法POST请求体 JSON{uri: uri}请求头Content-Type: application/json响应处理逻辑也很清晰2xx状态码会被解析为Response模型并返回422状态码会抛出UnprocessableEntityError对应参数校验失败其他异常统一以ApiError抛出。若希望拿到原始 HTTP 响应含状态码、响应头可以使用client.util.with_raw_response.convert_to_markdown(...)。JavaScript / TypeScript SDKJS SDK 的封装位于sdk/js/src/api/resources/util/Client.tsUtil类提供convertToMarkdown方法requests/UtilConvertToMarkdownRequest.ts请求体类型必填uri: stringconvertToMarkdown.ts错误类型定义区分422校验错误与未知错误调用示例来自 Client.ts 的官方示例await client.util.convertToMarkdown({ uri: uri })底层实现会将请求发送到${baseUrl}/v1/util/convert_to_markdown默认超时时间为 60 秒可通过timeoutInSeconds覆盖并支持maxRetries重试、abortSignal取消等高级选项返回对象中封装了原始响应rawResponse与类型化错误便于 Agent 程序做分支处理。典型使用场景Agent 工作流中的内容归一化原文档列出了三个核心使用模式它们共同指向一个目的在交给 LLM 处理之前先把异构内容统一成 Markdown。总结前先把公开网页转换为 Markdown网页 HTML 往往包含导航、脚本、广告等噪声直接喂给 LLM 会浪费 token 且降低提取质量。先经convert_to_markdown归一化再用 Agent 总结准确率和成本都更可控。下载文档到沙盒文件系统后再转换先借助 文件操作 能力把文档下载到沙盒再通过uri如file://协议地址转换形成下载 → 转换 → 读取的闭环。在索引或检索前统一内容格式无论是构建本地知识库还是做 RAG 检索统一的 Markdown 结构都能显著降低后续解析的复杂度。这三类场景还可以和 AIO Sandbox 的其他能力组合成更完整的流水线浏览器自动化website/docs/zh/guide/basic/browser.mdx负责抓取页面与截图工具 API 负责将内容转成 Markdown统一代码执行website/docs/zh/guide/basic/code.md负责跑后续处理脚本文件操作website/docs/zh/guide/basic/file.mdx负责持久化中间产物。源码佐证评测用例验证接口行为仓库的评测数据集为convert_to_markdown提供了真实的验证用例见 evaluation/dataset/evaluation_util.xml用例一将http://baidu.com转换为 Markdown校验输出是否包含文本百度或Baidu用例二统计 Markdown 输出中百度出现的次数要求返回正整数。这两个用例印证了接口的两点关键行为其一它确实能抓取并转换公网网页内容而非仅支持本地文件其二转换结果保留了页面的可读正文文本能够支撑后续的关键词匹配与统计类任务。评测执行结果记录在 evaluation/result/20251112/Latest.md 中可作为实现行为的历史佐证。小结/v1/util/convert_to_markdown是 AIO Sandbox 工具 API 的第一块拼图它以极简的{uri: ...}请求体把任意 URI → 干净 Markdown这一 Agent 高频需求收敛为一个可复用的标准端点。结合仓库中的 Python/JavaScript SDK、OpenAPI 定义与评测用例你可以快速在 Agent 工作流中集成内容归一化能力为总结、检索和文档处理打下统一的数据基础。赞分享AI Agent后端MCP 服务浏览器控制Agent 评测【免费下载链接】sandboxAll-in-One Sandbox for AI Agents that combines Browser, Shell, File, MCP and VSCode Server in a single Docker container.项目地址https://gitcode.com/gh_mirrors/sandbox103/sandbox点击查看免费下载相关推荐老Mac如何免费安装新版macOS2008-2017年Intel Mac的OpenCore Legacy Patcher升级教程老Mac如何免费安装新版macOS2008 2017年Intel Mac的OpenCore Legacy Patcher升级教程 2017年前的老Mac能不能操作系统固件驱动开发Ruffle如何用Rust语言让2000万Flash内容重获新生Ruffle如何用Rust语言让2000万Flash内容重获新生 当Adobe在2020年正式宣布停止支持Flash时超过2000万个.swf文件面临着成音视频语言运行时foobox-cn重构foobar2000用户体验的现代化DUI界面解决方案foobox cn重构foobar2000用户体验的现代化DUI界面解决方案 在专业音频播放领域foobar2000以其卓越的音质处理和高度可定制性而闻名桌面应用音视频上一篇ArcKit英国NHS临床安全叠加层DCB0129/0160、DTAC与MDR分类四命令下一篇抖音下载器终极指南免费批量下载视频音乐的完整解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/10 5:55:16

风电不确定性下分布鲁棒机组组合:线性决策规则与Matlab实现

调度中心的场景里,机组组合(Unit Commitment,UC)从来不是一道简单的算术题。要在未来24小时里决定哪些机组开机、哪些停机、每台机发多少电,同时还要满足负荷、留足备用、压住成本——这套优化模型本身已经很成熟了。但…

2026/10/10 6:55:18

Kettle 5.x ETL实战手册:从安装到作业调度与性能调优全解析

简介:面向数据抽取、转换与加载(ETL)场景的数据处理人员,这份 Kettle 用户手册聚焦业内常用的 Kettle 数据集成工具中的 Spoon 设计与运行环境,并结合 Kettle 5.x 实际使用步骤与案例,帮助读者快速掌握从各…

2026/10/10 6:55:18

PHP项目接入Consul做服务注册发现的落地实践

前阵子帮一个用PHP写的交易后台做改造,选型的时候直接绕过了ZooKeeper和etcd,最后定了Consul做服务注册发现。十几个服务、几十个实例,IP和端口不再散落在配置文件和.env里,扩缩容和故障摘除都交给Consul处理。今天不聊那些Java程…

2026/10/10 6:55:18

基于PCA9422与PIC18F57K42的低功耗电源管理方案设计

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/10 6:55:18

Flutter GridView在OpenHarmony上的实现:参数详解与实战指南

Flutter在OpenHarmony上跑起来这件事,技术圈聊了大半年,真正动手做过的人其实还是少数。尤其是像GridView这种高频组件,很多人第一反应是“直接搬过来用就行”,结果真搬到鸿蒙设备上一测,尺寸、渲染、触摸反馈都藏着不…

2026/10/10 6:55:18

2007-2024上市公司媒体关注度数据处理与实证研究指南

如果一个数据表的年份跨度是2007到2024,名字里又带着“媒体关注”四个字,那十有八九是做公司金融或资产定价方向的人在找的研究样本。我这些年帮人处理过不少类似数据,也看过很多基于这类数据写出来的论文。一个比较普遍的现象是:…

2026/10/10 6:50:18

Windows右键菜单臃肿原因与注册表/命令行/工具三法清理指南

1. 为什么右键菜单会越用越臃肿?这不是你的错,是Windows的“默认哲学”你有没有在资源管理器里点开一个普通文件夹,右键——然后盯着那个长得像菜市场价目表的菜单发呆?“用XX软件打开”“发送到XX网盘”“扫描病毒”“压缩为ZIP”…

2026/10/8 10:03:18

Jev+Agent接管浏览器:browser-use实战与jev-ultrafast性能优化

1. 从“Jev”说起:为什么我要把Agent接进浏览器“Jev”这个词最近在圈子里出现的频率越来越高,很多人第一次听到会以为是某个新模型的名字,其实它更像是一种思路——把Jev模型的能力当作底座,通过Agent的方式去接管浏览器&#xf…

2026/10/9 20:15:56

多智能体集群实战:DeepAgents编排、MCP与A2A协议及Skills体系

1. 从"单兵作战"到"集群协同":多智能体编排到底在解决什么问题如果你最近在折腾 Agent 相关的东西,大概率会有一种感觉:单个 Agent 能做的事情,其实很快就摸到天花板了。你给它一个提示词,挂几个工…

2026/10/8 6:05:44

无源低通滤波器设计实战:从RC到LC,手把手教你避开那些坑

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/10 0:04:53

从逻辑门到计算机:数字电路核心原理与全加器搭建实战

如果你拆过一台旧电脑的主板,盯着那些黑乎乎的小芯片看上一会儿,可能会冒出同一个疑问:这堆引脚密集的元件,到底是怎么“变”出那么复杂的应用的?答案并不在某个神秘的部件里,而是在所有芯片内部都在反复使…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑