检索数据资产的上下文

数据周围的上下文可让 AI 应用深入了解数据资产，从而提高 LLM 生成的回答的准确性和相关性。

lookupContext 方法通过单个 API 请求来弥合上下文差距，以检索预格式化的一组数据资产元数据，这些元数据针对交互式代理工作流进行了优化。您可以使用这种紧凑的、可供 LLM 使用的情境来指导代理评估和使用数据资产。

您可以对存储在 Knowledge Catalog 中的任何数据资产（例如 BigQuery 表、数据集或任何其他条目）使用 lookupContext 方法。

智能体如何获取数据上下文？

1. 智能体检索可能与上下文检索相关的数据资产，例如使用 Knowledge Catalog 语义搜索。
2. 智能体使用 lookupContext 方法发出单个 API 调用或 MCP 工具请求，以检索特定资产的上下文。

3. 该方法会返回包含预格式化文本块的响应。根据您在请求中指定的 format 参数，文档可以采用 YAML、XML 或 JSON 格式。

   响应包含以下上下文元素：

   上下文元素	说明
   技术元数据	资源架构和物理配置，例如 BigQuery 分区和聚簇策略。
   运营元数据	联接和其他关系，基于历史查询日志和数据洞见。如需了解详情，请参阅查看数据关系。
   商家说明	相关业务术语、概览、目录注释、在源系统中捕获并在 Knowledge Catalog 中自动生成的说明，以及指南。 注意：您可以使用数据资产的“指南”方面来捕获对客服人员发现、检查或使用数据资产有用的其他背景信息。
   数据分析	分布统计信息、不同值数量、Null 比率和样本值。
   数据质量	根据预定义规则自动检查数据质量并输出结果。
   相关数据资产的背景信息	相关数据资产的背景信息，例如术语表中的术语或其他相关资产，如经常联接的表。为相关媒体资源返回的上下文包含的元素范围与主要媒体资源或媒体资源相同。

4. 代理会使用此响应来指导相关素材资源的选择或使用。

准备工作

在使用 lookupContext 方法之前，请确保您拥有必要的角色并启用所需的 API。