Struct Prompt 

pub struct Prompt { /* private fields */ }

统一的 Prompt 表示。

内部始终为分层结构，即使是简单文本也会转换为单层。 这保证了 API 的一致性——无论用户传入 &str 还是 PromptBuilder 的结果， 框架内部处理路径完全相同。

示例

use lellm_core::{Prompt, PromptBuilder, CacheControl};

// 简单文本 — 自动转换
let simple: Prompt = "You are a helpful assistant.".into();

// 分层构建 — 最大化前缀缓存
let layered = Prompt::builder()
    .layer_cached("核心身份…")               // 永不变化
    .layer_cached("工具指南…")               // 极少变化
    .layer_dynamic("会话上下文: …")          // 每轮变化
    .build();

// 合并为纯文本（用于不支持 cache_control 的 Provider）
let text = layered.build_text();

Implementations

impl Prompt

pub fn plain(text: impl Into<String>) -> Self

从纯文本创建 Prompt（单层，无缓存标记）。

pub fn builder() -> PromptBuilder

创建分层构建器。

pub fn to_content_blocks(&self) -> Vec<ContentBlock>

将 Prompt 转换为带 cache_control 的 Vec<ContentBlock>。

供框架内部构建 Message::System 使用。

pub fn build_text(&self) -> String

合并所有层为纯文本，层之间以 \n\n 分隔。

用于不支持 cache_control 的 Provider（如 OpenAI、Google）。

pub fn is_empty(&self) -> bool

是否为空（无层或所有层为空）。

Trait Implementations

impl Clone for Prompt

fn clone(&self) -> Prompt

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Prompt

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Prompt

fn default() -> Self

Returns the “default value” for a type.

impl From<&String> for Prompt

fn from(s: &String) -> Self

Converts to this type from the input type.

impl From<&str> for Prompt

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for Prompt

fn from(s: String) -> Self

Converts to this type from the input type.