SuperAPI AI 工具集

context-blocks

智能体与模型

查看项目

更新于 10-16 02:33

技能介绍

用途:在 NVIDIA OO Agents 中管理上下文块,即系统提示词中的命名分段。这些分段来自框架、策略、技能和开发者等来源,通过统一接口管理,用于配置 LLM 提示词中出现的内容。

主要能力:每个上下文块条目是一个 {key: value} 字典。值可为固定文本字符串(默认放入易变后缀)、Context("text", prefix=True)(固定文本放入可缓存前缀)、Context(expr="self.x()")(每轮重新求值的表达式,默认后缀)、Context(expr=..., prefix=True)(每轮求值但放入前缀),或 None(从提示词中屏蔽该块)。

必要用法:可通过六种入口设置同一字典结构——类级 context 参数、实例级 context 参数、@strategy 装饰器(智能体方法)、@strategy 装饰器(独立函数)、ScopedContext 上下文管理器(临时生效),以及运行时 self.context[key] 赋值。已知块键包括 system_prompt、self、state(均不用于独立函数)、strategy_prompt、execution_context(可用于独立函数)。用 context={"key": None} 或 self.context["key"] = None 屏蔽。

检查方式:self.context.all_keys()、disabled()、is_enabled("k"),或 agent.context_manager.keys()、protected_keys、disabled_keys。

限制:Context 的 value 与 expr 互斥,同时提供会抛 TypeError;expr 在创建时校验,必须是可编译的 Python 表达式;prefix=False 为默认。旧 API(set_static、set_dynamic、disable、enable、DynamicContext)仍可用但会发出 DeprecationWarning。上下文块的具体渲染效果、缓存收益及与其他组件的交互细节暂未提供。