funera-orchestrate 0.3.0

Easy-to-use orchestration layer for funera-core — build LLM agents with a simple builder API
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

//! Minimal one-shot query using `Agent::fire`.
//!
//! ```bash
//! cargo run --example minimal
//! ```
//!
//! This demonstrates the simplest possible use:
//! - Build an `AgentRuntime` with a model
//! - Build an `Agent` with a system prompt
//! - Call `fire()` for a single turn (session is discarded after)

use funera_orchestrate::{Agent, AgentRuntime, DeepSeekProvider};

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Runtime from env vars
    let runtime = AgentRuntime::<DeepSeekProvider>::builder()
        .api_key(std::env::var("OPENAI_API_KEY")?)
        .base_url(std::env::var("OPENAI_BASE_URL").ok())
        .model(std::env::var("OPENAI_MODEL").unwrap_or_else(|_| "deepseek-v4-flash".into()))
        .build()?;

    // Agent is pure config — no runtime dependency
    let agent = Agent::builder()
        .system_prompt("You speak like a pirate.")
        .build();

    // fire() shares the runtime (&) — no session state is mutated
    let resp = agent
        .fire("Tell me about Rust programming.", &runtime)
        .await?;

    println!("=== Response ===");
    println!("{}", resp.content);
    println!();
    println!("Iterations: {}", resp.iterations);
    println!("Finish reason: {:?}", resp.finish_reason);

    Ok(())
}