Struct Conversation 

pub struct Conversation {

    pub _id: u64,
    pub user: Principal,
    pub thread: Option<Xid>,
    pub messages: Vec<Json>,
    pub resources: Vec<Resource>,
    pub artifacts: Vec<Resource>,
    pub status: ConversationStatus,
    pub failed_reason: Option<String>,
    pub usage: Usage,
    pub steering_messages: Option<Vec<String>>,
    pub follow_up_messages: Option<Vec<String>>,
    pub ancestors: Option<Vec<u64>>,
    pub period: u64,
    pub created_at: u64,
    pub updated_at: u64,
}

A conversation between an agent and the system, stored in the database for memory management. Version 1

Fields

_id: u64

The unique identifier for this resource in the Anda DB collection “conversation”.

user: Principal

thread: Option<Xid>

messages: Vec<Json>

resources: Vec<Resource>

The request resources used by the agent to process the conversation.

artifacts: Vec<Resource>

A collection of artifacts generated by the agent during the execution of the task.

status: ConversationStatus

The state of the conversation.

failed_reason: Option<String>

usage: Usage

The LLM usage statistics for the conversation.

steering_messages: Option<Vec<String>>

Queue a steering message to interrupt the agent mid-run. Delivered after current tool execution, skips remaining tools.

follow_up_messages: Option<Vec<String>>

Queue a follow-up message to be processed after the agent finishes. Delivered only when agent has no more tool calls or steering messages.

ancestors: Option<Vec<u64>>

The ancestor conversation IDs, ordered from the closest to the farthest ancestor.

period: u64

The period when the conversation was created, in hours (timestamp / 3600 / 1000). It is used to index the conversation for faster retrieval by time.

created_at: u64

The timestamp when the conversation was created, in milliseconds.

updated_at: u64

The timestamp when the conversation was updated, in milliseconds.

Implementations

impl Conversation

pub fn schema() -> Result<Schema, SchemaError>

impl Conversation

pub fn append_messages(&mut self, message: Vec<Message>)

pub fn to_changes(&self) -> Result<BTreeMap<String, Fv>, BoxError>

Trait Implementations

impl Clone for Conversation

fn clone(&self) -> Conversation

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Conversation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Conversation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> From<&'a Conversation> for ConversationRef<'a>

fn from(conversation: &'a Conversation) -> Self

Converts to this type from the input type.

impl From<&Conversation> for ConversationState

fn from(conversation: &Conversation) -> Self

Converts to this type from the input type.

impl From<Conversation> for Document

fn from(conversation: Conversation) -> Self

Converts to this type from the input type.

impl Serialize for Conversation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.