跳转至

prompting

feishu.agent.prompting

build_time_aware_system_prompt

Python
build_time_aware_system_prompt(base_prompt: str, timezone_resolver: Callable[..., Any], *, now: Callable[[ZoneInfo], datetime] | None = None) -> Callable[..., Any]

构建会追加当前日期、时间与时区上下文的 system prompt 提供方。

源代码位于: feishu/agent/prompting.py
Python
def build_time_aware_system_prompt(
    base_prompt: str,
    timezone_resolver: Callable[..., Any],
    *,
    now: Callable[[ZoneInfo], datetime] | None = None,
) -> Callable[..., Any]:
    r"""构建会追加当前日期、时间与时区上下文的 system prompt 提供方。"""
    prompt = base_prompt.rstrip()

    async def system(event: Any | None = None, timezone: str | None = None) -> str:
        tz = _valid_timezone(timezone) or await _call_timezone_resolver(timezone_resolver, event)
        zone = ZoneInfo(tz)
        current = now(zone) if now is not None else datetime.now(zone)
        return f"{prompt}\n\n{_render_time_context(current, tz)}"

    return system

build_time_context

Python
build_time_context(timezone_resolver: Callable[..., Any], *, now: Callable[[ZoneInfo], datetime] | None = None) -> Callable[..., Any]

构建每轮动态时间上下文;调用方可把它附加到当前用户消息,避免破坏 system/历史前缀缓存。

源代码位于: feishu/agent/prompting.py
Python
def build_time_context(
    timezone_resolver: Callable[..., Any],
    *,
    now: Callable[[ZoneInfo], datetime] | None = None,
) -> Callable[..., Any]:
    r"""构建每轮动态时间上下文;调用方可把它附加到当前用户消息,避免破坏 system/历史前缀缓存。"""

    async def context(event: Any | None = None, timezone: str | None = None) -> str:
        tz = _valid_timezone(timezone) or await _call_timezone_resolver(timezone_resolver, event)
        zone = ZoneInfo(tz)
        current = now(zone) if now is not None else datetime.now(zone)
        return _render_time_context(current, tz)

    return context

build_timezone_resolver

Python
build_timezone_resolver(default_timezone: str, *, user_tokens: Any | None = None, client: Any | None = None, cache_ttl_seconds: float = 3600.0, trusted_tenant_key: str | None = None, allow_legacy_unscoped: bool = False) -> Callable[..., Any]

构建按事件上下文、用户资料与配置默认值解析时区的 resolver。

源代码位于: feishu/agent/prompting.py
Python
def build_timezone_resolver(
    default_timezone: str,
    *,
    user_tokens: Any | None = None,
    client: Any | None = None,
    cache_ttl_seconds: float = 3600.0,
    trusted_tenant_key: str | None = None,
    allow_legacy_unscoped: bool = False,
) -> Callable[..., Any]:
    r"""构建按事件上下文、用户资料与配置默认值解析时区的 resolver。"""
    if trusted_tenant_key is not None and (
        not isinstance(trusted_tenant_key, str)
        or not trusted_tenant_key.strip()
        or trusted_tenant_key != trusted_tenant_key.strip()
    ):
        raise ValueError("trusted_tenant_key must be a non-empty string")
    if not isinstance(allow_legacy_unscoped, bool):
        raise ValueError("allow_legacy_unscoped must be a boolean")
    fallback_timezone = _valid_timezone(default_timezone) or "Asia/Shanghai"
    cache: dict[tuple[str | None, str], tuple[float, str]] = {}

    async def resolve(event: Any | None = None) -> str:
        event_tenant = getattr(event, "tenant_key", None)
        if event_tenant is not None and (
            not isinstance(event_tenant, str) or not event_tenant.strip() or event_tenant != event_tenant.strip()
        ):
            return fallback_timezone
        if trusted_tenant_key and event_tenant and trusted_tenant_key != event_tenant:
            return fallback_timezone
        tenant_key = event_tenant or trusted_tenant_key
        event_timezone = _valid_timezone(_event_timezone(event))
        if event_timezone:
            return event_timezone
        if tenant_key is None and not allow_legacy_unscoped:
            return fallback_timezone
        user = _event_user(event)
        user_key = _user_cache_key(user)
        cache_key = (tenant_key, user_key) if user_key else None
        if cache_key is not None:
            cached = cache.get(cache_key)
            if cached and time.monotonic() - cached[0] < cache_ttl_seconds:
                return cached[1]
        user_timezone = await _user_timezone(user_tokens, client, user, tenant_key=tenant_key)
        if user_timezone:
            if cache_key is not None:
                cache[cache_key] = (time.monotonic(), user_timezone)
            return user_timezone
        return fallback_timezone

    return resolve