allms 0.42.0

One Library to rule them aLLMs
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
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113

use anyhow::Result;
use schemars::JsonSchema;
use serde::Deserialize;
use serde::Serialize;

use allms::{
    llm::{
        tools::{GeminiCodeInterpreterConfig, GeminiWebSearchConfig, LLMTools},
        GoogleModels,
    },
    Completions, ThinkingLevel,
};

mod utils;
use utils::get_vertex_token;

// Example 1: Web search
#[derive(Deserialize, Serialize, JsonSchema, Debug, Clone)]
struct AINewsArticles {
    pub articles: Vec<AINewsArticle>,
}

#[derive(Deserialize, Serialize, JsonSchema, Debug, Clone)]
struct AINewsArticle {
    pub title: String,
    pub url: String,
    pub description: String,
}

// Example 2: Code interpreter example
#[derive(Deserialize, Serialize, Debug, Clone, JsonSchema)]
pub struct CodeInterpreterResponse {
    pub problem: String,
    pub code: String,
    pub solution: String,
}

#[tokio::main]
async fn main() -> Result<()> {
    env_logger::init();

    let google_api_key: String =
        std::env::var("GOOGLE_AI_STUDIO_API_KEY").expect("GOOGLE_AI_STUDIO_API_KEY not set");
    let vertex_token = get_vertex_token().await?;

    // Example 1A: Web search example (with Studio API)
    let web_search_config =
        GeminiWebSearchConfig::new().add_source("https://www.artificialintelligence-news.com/");

    let web_search_tool = LLMTools::GeminiWebSearch(web_search_config);
    let google_responses =
        Completions::new(GoogleModels::Gemini3Flash, &google_api_key, None, None)
            .add_tool(web_search_tool.clone())
            .thinking_level(ThinkingLevel::Low);

    match google_responses
        .get_answer::<AINewsArticles>("Find up to 5 most recent news items about Artificial Intelligence, Generative AI, and Large Language Models. 
        For each news item, provide the title, url, and a short description.")
        .await
    {
        Ok(response) => println!("[AI Studio] AI news articles:\n{:#?}", response),
        Err(e) => eprintln!("[AI Studio] AI news articles error: {:?}", e),
    }

    // Example 1B: Web search example (with Vertex API)
    let google_responses_vertex =
        Completions::new(GoogleModels::Gemini3_1FlashLite, &vertex_token, None, None)
            .add_tool(web_search_tool)
            .version("google-vertex");

    match google_responses_vertex
        .get_answer::<AINewsArticles>("Find up to 5 most recent news items about Artificial Intelligence, Generative AI, and Large Language Models. 
        For each news item, provide the title, url, and a short description.")
        .await
    {
        Ok(response) => println!("[Vertex] AI news articles:\n{:#?}", response),
        Err(e) => eprintln!("[Vertex] AI news articles error: {:?}", e),
    }

    // Example 2A: Code interpreter example (with Studio API)
    let code_interpreter_tool = LLMTools::GeminiCodeInterpreter(GeminiCodeInterpreterConfig::new());
    let google_responses =
        Completions::new(GoogleModels::Gemini3_1Pro, &google_api_key, None, None)
            .add_tool(code_interpreter_tool.clone());

    match google_responses
        .get_answer::<CodeInterpreterResponse>(
            "Calculate the mean and standard deviation of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]",
        )
        .await
    {
        Ok(response) => println!("[AI Studio] Code interpreter response:\n{:#?}", response),
        Err(e) => eprintln!("[AI Studio] Code interpreter error: {:?}", e),
    }

    // Example 2B: Code interpreter example (with Vertex API)
    let google_responses_vertex =
        Completions::new(GoogleModels::Gemini3_1Pro, &vertex_token, None, None)
            .add_tool(code_interpreter_tool)
            .version("google-vertex");

    match google_responses_vertex
        .get_answer::<CodeInterpreterResponse>(
            "Calculate the mean and standard deviation of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]",
        )
        .await
    {
        Ok(response) => println!("[Vertex] Code interpreter response:\n{:#?}", response),
        Err(e) => eprintln!("[Vertex] Code interpreter error: {:?}", e),
    }

    Ok(())
}