zai-rs 0.5.0

一个 Rust SDK, 用于调用 智谱AI 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
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

use super::types::KnowledgeListResponse;
use crate::ZaiResult;
use crate::client::ZaiClient;

/// Query parameters for knowledge list API
#[derive(Debug, Clone, Default, serde::Serialize, validator::Validate)]
#[allow(clippy::new_without_default)]
pub struct KnowledgeListQuery {
    /// Page index starting from 1 (default 1)
    #[serde(skip_serializing_if = "Option::is_none")]
    #[validate(range(min = 1))]
    pub page: Option<u32>,
    /// Page size (default 10)
    #[serde(skip_serializing_if = "Option::is_none")]
    #[validate(range(min = 1))]
    pub size: Option<u32>,
}

impl KnowledgeListQuery {
    /// Create a new query (page 1, size 10).
    #[allow(clippy::new_without_default)]
    pub fn new() -> Self {
        Self {
            page: Some(1),
            size: Some(10),
        }
    }
    /// Set the page index (1-based).
    pub fn with_page(mut self, page: u32) -> Self {
        self.page = Some(page);
        self
    }
    /// Set the page size.
    pub fn with_size(mut self, size: u32) -> Self {
        self.size = Some(size);
        self
    }

    /// Build the `(&str, String)` query pairs (in stable order) used to form
    /// the request URL.
    fn pairs(&self) -> Vec<(&'static str, String)> {
        let mut params: Vec<(&'static str, String)> = Vec::new();
        if let Some(page) = self.page.as_ref() {
            params.push(("page", page.to_string()));
        }
        if let Some(size) = self.size.as_ref() {
            params.push(("size", size.to_string()));
        }
        params
    }
}

/// Knowledge list request (GET /llm-application/open/knowledge)
///
/// Credentials and transport live on the [`ZaiClient`], passed to
/// [`send_via`](Self::send_via).
#[allow(clippy::new_without_default)]
pub struct KnowledgeListRequest {
    query: KnowledgeListQuery,
}

impl KnowledgeListRequest {
    /// Create a new knowledge-list request (default query: page 1, size 10).
    #[allow(clippy::new_without_default)]
    pub fn new() -> Self {
        Self {
            query: KnowledgeListQuery::new(),
        }
    }

    /// Apply a query (replaces the current one).
    pub fn with_query(mut self, q: KnowledgeListQuery) -> Self {
        self.query = q;
        self
    }

    /// Send via a [`ZaiClient`] and parse the typed response.
    pub async fn send_via(&self, client: &ZaiClient) -> ZaiResult<KnowledgeListResponse> {
        let params = self.query.pairs();
        let route = crate::client::routes::KNOWLEDGE_LIST;
        let url = client.endpoints().resolve_route_with_query(
            route,
            &[],
            &params
                .iter()
                .map(|(k, v)| (*k, v.as_str()))
                .collect::<Vec<_>>(),
        )?;
        client
            .send_empty::<KnowledgeListResponse>(route.method(), url)
            .await
    }

    /// Validate the query then send via a [`ZaiClient`] and parse the typed
    /// response.
    pub async fn send_via_with_query(
        mut self,
        client: &ZaiClient,
        q: &KnowledgeListQuery,
    ) -> ZaiResult<KnowledgeListResponse> {
        use validator::Validate;
        q.validate()?;
        self.query = q.clone();
        self.send_via(client).await
    }
}