SuperAPI AI 工具集

dspy-citations

写作与研究

查看项目

更新于 10-15 23:58

技能介绍

用途:为 DSPy 的 LM 输出添加结构化来源归属,使每条论断都能对应到具体文档的具体段落,便于验证、合规追溯和事实核查。

主要能力:dspy.experimental.Citations 提供机器可读的引用对象,替代内联引文;与 Anthropic Citations API 原生配合,其他提供商回退到基于提示词的抽取。引用对象含 cited_text、document_index、start、end 字段,可校验引用文本是否真实存在于源文档。

使用方式:从 dspy.experimental 导入 Citations 与 Document(不在主命名空间);用 Document(text, title, source_id) 构建文档;在 Signature 中把 citations 声明为 Citations 类型输出字段;配合 dspy.ChainOfThought 等模块调用。Anthropic 模型可通过 dspy.ChatAdapter(adapt_to_native_lm_feature=["citations"]) 启用原生引用。支持与 dspy.streaming 的 streamify 结合,在流式输出中累积引用。非 Anthropic 提供商可用提示词让模型输出 [doc_N] 内联标记再解析。

适用场景:需要验证论断来源、法律合规要求可追溯、用户需要可点击回源、需要机器可读引用元数据、构建事实核查或 grounding 验证。

限制:Citations 属实验性 API,可能随版本变化,生产环境应固定 DSPy 版本;原生引用仅支持 Anthropic 模型,其他模型配置该特性会静默回退;document_index 对应 context 列表位置,重排文档会改变索引,不可硬编码;必须提供上下文文档,否则模型会编造引用元数据,应始终搭配检索步骤。安装命令:npx skills add lebsral/DSPy-Programming-not-prompting-LMs-skills --skill <name>。