Explain: shorter answers, streamed, remembered, and prepared for settings
ai-explain spec, amendment 1 (EX-22 to EX-28): - answers are three or four sentences, max_tokens 160, cut at 700 chars; - POST /api/explain streams the answer as server-sent events; - each node remembers answers in memory (1,000, 24 h), keyed by the facts, prompt version and model, shared by server-level administrators; - resources/explain/settings.json.gz ships answers for settings at their defaults, generated with prepare_setting_explanations (717 for 2026.9.27); - the system prompt no longer carries the per-request marker, so a model server can reuse it; - inbuxa:Explanation gains source, answeredAt and preparedFor.
This commit is contained in:
@@ -10,6 +10,7 @@
|
||||
//! EX-7), and how its answer is trimmed (EX-12). The server reads the data
|
||||
//! and makes the call.
|
||||
|
||||
pub mod memory;
|
||||
pub mod prompts;
|
||||
pub mod schema;
|
||||
pub mod status;
|
||||
@@ -17,11 +18,11 @@ pub mod status;
|
||||
use serde_json::Value;
|
||||
use std::collections::BTreeMap;
|
||||
|
||||
/// The most an answer may generate (EX-12).
|
||||
pub const MAX_TOKENS: u32 = 400;
|
||||
/// The most an answer may generate (EX-12, as amended by EX-22).
|
||||
pub const MAX_TOKENS: u32 = 160;
|
||||
|
||||
/// The longest answer returned, in characters (EX-12).
|
||||
pub const MAX_ANSWER_CHARS: usize = 1_200;
|
||||
/// The longest answer returned, in characters (EX-12, as amended by EX-22).
|
||||
pub const MAX_ANSWER_CHARS: usize = 700;
|
||||
|
||||
/// The largest subject accepted, serialized (EX-8).
|
||||
pub const MAX_SUBJECT_BYTES: usize = 16 * 1024;
|
||||
@@ -83,6 +84,18 @@ pub enum Kind {
|
||||
Setting,
|
||||
}
|
||||
|
||||
impl Kind {
|
||||
/// A stable name, part of the key an answer is remembered by (EX-24).
|
||||
pub fn as_str(&self) -> &'static str {
|
||||
match self {
|
||||
Kind::DeliveryFailure => "DeliveryFailure",
|
||||
Kind::SpamVerdict => "SpamVerdict",
|
||||
Kind::Event => "Event",
|
||||
Kind::Setting => "Setting",
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
impl Subject {
|
||||
pub fn kind(&self) -> Kind {
|
||||
match self {
|
||||
|
||||
Reference in New Issue
Block a user