---
title: "提供上下文"
description: "了解如何为用户消息添加上下文"
canonical_url: "https://tiptap.zhcndoc.com/ai/deprecated/agent/features/context"
---

# 提供上下文

了解如何为用户消息添加上下文

在 AI 代理中，上下文是补充用户请求的数据。有时，它对于完成任务至关重要。

例如，在多文档 AI 代理中，如果用户提到某个文档，则应同时将该文档的 ID 作为上下文发送。

通过使用 `context` 选项，在创建用户消息时提供上下文。

```ts
provider.addUserMessage('总结所选文档', {
  context: '所选文档的 ID 是：12345',
})
```

## 通过提及插入上下文

在许多 AI 聊天机器人中，用户可以通过提及文件和其他用户来引用它们：`@John`，`#file-123` 等。你可以通过将提示输入定义为 Tiptap 文本编辑器，并安装 [Mention 扩展](https://tiptap.zhcndoc.com/editor/extensions/nodes/mention.md) 来实现此行为。

## 将文件和 URL 添加到上下文

`context` 选项仅接受字符串，不接受文件对象。要将文件作为上下文添加，请按以下步骤操作：

1. 将文件上传到您的服务器。为其获取一个标识符。
2. 将文件标识符添加到 `context` 选项中。
3. 在 [your backend](https://tiptap.zhcndoc.com/ai/deprecated/agent/custom-llms/overview.md) 中，定义一个 [自定义服务器端工具](https://tiptap.zhcndoc.com/ai/deprecated/agent/custom-llms/server-side-tools.md)，使您的 AI 代理能够读取该文件的内容。

URL 也适用同样的方式。如果用户提供了一个 URL，您可以将其作为字符串包含在 `context` 选项中，并定义一个 [自定义工具](https://tiptap.zhcndoc.com/ai/deprecated/agent/custom-llms/server-side-tools.md) 来搜索网页并检索该 URL 的内容。

## 将编辑器的选区添加到上下文

为了让 AI 代理感知编辑器中选中的内容，请启用[选区感知](https://tiptap.zhcndoc.com/ai/deprecated/agent/features/selection-awareness.md)。