> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 网页与文档搜索

> 通过 @web 和 @docs 提及、URL 解析以及来自网页的实时上下文，直接在 Cascade 中搜索网页和文档。

Cascade 现在可以智能解析网页和文档，并将其分块处理，为模型提供实时上下文。理解这项功能的关键在于：Cascade 会像人类一样浏览互联网。

我们的网页工具经过专门设计，只会获取必要的信息，以便高效使用你的额度。

<div id="overview">
  ## 概述
</div>

为帮助你更好地了解 网页搜索 的工作原理，我们录制了一段简短视频，介绍其关键概念和最佳实践。

<iframe width="560" height="315" src="https://www.youtube.com/embed/moIySJ4d0UY" title="YouTube 视频播放器" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

<div id="quick-start">
  ### 快速开始
</div>

最快的上手方式，是在编辑器右下角的 Devin Settings 中启用网页搜索。你可以通过以下几种方式启用它：

1. 提出一个可能需要联网才能回答的问题 (例如：“React 最新版本有哪些新内容？”) 。
2. 使用 `@web` 强制进行文档搜索。
3. 使用 `@docs` 在一组我们确信能够高质量读取的文档中进行查询。
4. 将一个 URL 粘贴到你的消息中。

<div id="search-the-web">
  ## 搜索网络
</div>

Cascade 可以判断，用户的某些提示可能需要实时网页搜索才能提供最佳回答。在这种情况下，Cascade 会执行网页搜索并将结果提供给用户。这既可以自动进行，也可以通过 `@web` 提及手动触发。

<Note>
  **启用网页搜索** Admin 设置用于控制 Cascade 是否可以在开放互联网上进行网页搜索。它不会影响 Cascade 读取特定 URL 的能力 (请参见下方的[读取页面](#reading-pages)) ，因为后者是在用户的本机上执行的。
</Note>

<Frame style={{ border: "none", background: "none" }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-search-web.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=17c1d1634a01f0c499e860191a70b8d5" width="1150" height="530" data-path="desktop/assets/windsurf/cascade/cascade-search-web.png" />
</Frame>

<div id="reading-pages">
  ## 读取页面
</div>

Cascade 可以读取单个页面，例如文档、博客文章和 GitHub 文件。页面读取全程都在你的设备上、你的网络环境内进行，因此如果你使用的是 VPN，通常不会有任何问题。

页面来源包括网页搜索结果、根据对话内容推断出的页面，或你直接粘贴到消息中的 URL。

我们会将页面拆分成多个片段，这和人类阅读页面的方式非常相似：面对较长的页面时，我们会先快速定位到目标部分，再阅读相关文本。Cascade 也是这样工作的。

<Frame style={{ border: "none", background: "none" }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-parse-url.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=ed31a5af82c0db89c4b88b77e2d8a017" width="1158" height="538" data-path="desktop/assets/windsurf/cascade/cascade-parse-url.png" />
</Frame>

需要注意的是，并非所有页面都能被解析。我们正在持续改进网站读取的质量。如果你有希望我们更好支持的特定网站，欢迎随时提交功能请求！