zai-rs 0.1.15

一个 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
107
108

use url::Url;

use super::types::KnowledgeListResponse;
use crate::{ZaiResult, client::http::HttpClient};

/// Query parameters for knowledge list API
#[derive(Debug, Clone, Default, serde::Serialize, validator::Validate)]
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 {
    pub fn new() -> Self {
        Self {
            page: Some(1),
            size: Some(10),
        }
    }
    pub fn with_page(mut self, page: u32) -> Self {
        self.page = Some(page);
        self
    }
    pub fn with_size(mut self, size: u32) -> Self {
        self.size = Some(size);
        self
    }
}

/// Knowledge list request (GET /llm-application/open/knowledge)
pub struct KnowledgeListRequest {
    /// Bearer API key
    pub key: String,
    url: String,
    _body: (),
}

impl KnowledgeListRequest {
    pub fn new(key: String) -> Self {
        let url = "https://open.bigmodel.cn/api/llm-application/open/knowledge".to_string();
        Self {
            key,
            url,
            _body: (),
        }
    }

    fn rebuild_url(&mut self, q: &KnowledgeListQuery) {
        let mut url =
            Url::parse("https://open.bigmodel.cn/api/llm-application/open/knowledge").unwrap();
        {
            let mut pairs = url.query_pairs_mut();
            if let Some(page) = q.page.as_ref() {
                pairs.append_pair("page", &page.to_string());
            }
            if let Some(size) = q.size.as_ref() {
                pairs.append_pair("size", &size.to_string());
            }
        }
        self.url = url.to_string();
    }

    /// Apply query by rebuilding internal URL
    pub fn with_query(mut self, q: KnowledgeListQuery) -> Self {
        self.rebuild_url(&q);
        self
    }

    /// Send request and parse typed response
    pub async fn send(&self) -> ZaiResult<KnowledgeListResponse> {
        let resp = self.get().await?;
        let parsed = resp.json::<KnowledgeListResponse>().await?;
        Ok(parsed)
    }

    /// Validate query, rebuild URL then send
    pub async fn send_with_query(
        mut self,
        q: &KnowledgeListQuery,
    ) -> ZaiResult<KnowledgeListResponse> {
        use validator::Validate;
        q.validate()?;
        self.rebuild_url(q);
        self.send().await
    }
}

impl HttpClient for KnowledgeListRequest {
    type Body = ();
    type ApiUrl = String;
    type ApiKey = String;

    fn api_url(&self) -> &Self::ApiUrl {
        &self.url
    }
    fn api_key(&self) -> &Self::ApiKey {
        &self.key
    }
    fn body(&self) -> &Self::Body {
        &self._body
    }
}