agent-io 0.3.2

A Rust SDK for building AI agents with multi-provider LLM support
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

//! Tool builder

use serde::de::DeserializeOwned;
use serde_json::{Value, json};

use crate::Result;

use super::function::FunctionTool;
use super::tool::{EphemeralConfig, Tool};

/// Builder for creating tools
pub struct ToolBuilder {
    name: String,
    description: String,
    parameters_schema: serde_json::Map<String, Value>,
    ephemeral: EphemeralConfig,
}

impl ToolBuilder {
    pub fn new(name: impl Into<String>) -> Self {
        Self {
            name: name.into(),
            description: String::new(),
            parameters_schema: serde_json::Map::new(),
            ephemeral: EphemeralConfig::None,
        }
    }

    pub fn description(mut self, desc: impl Into<String>) -> Self {
        self.description = desc.into();
        self
    }

    pub fn parameter(mut self, name: &str, schema: Value) -> Self {
        self.parameters_schema.insert(name.to_string(), schema);
        self
    }

    pub fn string_param(self, name: &str, description: &str) -> Self {
        self.parameter(
            name,
            json!({
                "type": "string",
                "description": description
            }),
        )
    }

    pub fn number_param(self, name: &str, description: &str) -> Self {
        self.parameter(
            name,
            json!({
                "type": "number",
                "description": description
            }),
        )
    }

    pub fn boolean_param(self, name: &str, description: &str) -> Self {
        self.parameter(
            name,
            json!({
                "type": "boolean",
                "description": description
            }),
        )
    }

    pub fn ephemeral(mut self, config: EphemeralConfig) -> Self {
        self.ephemeral = config;
        self
    }

    pub fn build<F, T>(self, func: F) -> Box<dyn Tool>
    where
        T: DeserializeOwned + Send + Sync + 'static,
        F: Fn(T) -> std::pin::Pin<Box<dyn std::future::Future<Output = Result<String>> + Send>>
            + Send
            + Sync
            + 'static,
    {
        let mut tool = FunctionTool::new(self.name, self.description, self.parameters_schema, func);
        tool.ephemeral_config = self.ephemeral;
        Box::new(tool)
    }
}