跳到内容
ClickHouse Loom
Esc
↑↓导航↵打开⌘J预览
本页内容

Microsoft Agent Framework 上下文提供者

Microsoft Agent Framework 上下文提供者

本页由机器从英文原文翻译,内容以英文原文为准。 Machine-translated from the English page, which is authoritative.

LoomContextProvider 基于异步 Python SDK 实现了该框架的上下文提供者接口。可选的 extra 只允许经过测试的框架次版本系列;核心 SDK 和服务器不会导入该框架。

运行之前,提供者会搜索最新的用户文本,并把匹配的事实添加到框架的指令中。运行之后,它会把新的用户文本和助手文本分成有限大小的批次,发送给 memory.set_from_messages。每个轮次中该钩子只运行一次,包括在框架的中间件循环中。框架会保留自己的历史记录;本提供者存储持久事实,而不是取代历史记录提供者。

不变量

用户 id 与框架会话 id 共同派生出一个 Loom 会话,以防两个用户的同名会话共享提取出的分块。省略用户时,会读取令牌允许访问的命名空间中的全部记忆,并写入共享行。显式指定的用户 id 不能带有首尾空白。命名空间授权决定访问权限;user 参数只是过滤条件。服务器提供 actor 和来源溯源信息,并应用常规的冲突、擦除和滚动 schema 规则。不会添加数据库、缓存或本地历史记录。错误会通过框架的提供者钩子向上传播,包括模型回复之后出现的错误。并发写入遵循服务器的常规冲突规则。

对话保护

一个提供者只服务于一个逻辑对话族。它会保留构造时和回调入口处已有的、由应用拥有的保护句柄,包括环境中的贡献者以及之后每个绑定的客户端句柄。原生的用户 id 和会话 id 只用于路由请求,不会创建或替换这一授权。恢复时,会在构造提供者之前重新打开现有的 capsule。

自有的召回和提取在 SDK 的自动捕获上下文中运行。传输层会在凭据检查之后、分发之前重新检查每个保留的对话族,在转换之前观察回复,并在放行带标记的回复之前,将所有贡献者持久地标记。第一次带标记的召回可以到达模型。之后的自动工作会被拒绝,并且每个提取批次都会在下一个批次开始之前接受检查。模型回复之后出现的拒绝会通过原生提供者生命周期向上传播;它无法撤销已给出的回答或工具产生的效果。提供者不会添加能力声明,也不会添加恢复后宿主的资格认定。

源码入口

  • sdk/python/loom/integrations/agent_framework.py:LoomContextProvider。
  • sdk/python/tests/test_agent_framework.py:原生提供者和 agent 的行为。
  • tests/integration/test_sdk_agent_framework_memory.py:实时提取与召回。

框架设置

这个页面有帮助吗?