openlark-communication 0.18.0

飞书开放平台 Rust SDK - 企业级 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

//! AILY (AI学习平台) 端点定义
//!
//! AILY 是飞书的 AI 学习平台，提供数据知识管理、AI 会话和技能调用等功能。
//!
//! # 使用示例
//!
//! ```rust
//! use openlark_communication::endpoints::aily::*;
//!
//! let sessions_endpoint = AILY_V1_SESSIONS;
//! let skills_endpoint = AILY_V1_SKILLS;
//! ```

// ==================== AILY (AI学习平台) v1 ====================
// AILY AI学习平台 - 数据知识管理、AI会话和技能调用

/// AILY 会话管理 v1
pub const AILY_V1_SESSIONS: &str = "/open-apis/aily/v1/sessions";
/// 端点路径常量。
pub const AILY_V1_SESSION: &str = "/open-apis/aily/v1/sessions/{session_id}";

/// AILY 消息管理 v1
pub const AILY_V1_MESSAGES: &str = "/open-apis/aily/v1/sessions/{session_id}/messages";

/// AILY 运行管理 v1
pub const AILY_V1_RUNS: &str = "/open-apis/aily/v1/sessions/{session_id}/runs";
/// 端点路径常量。
pub const AILY_V1_RUN: &str = "/open-apis/aily/v1/sessions/{session_id}/runs/{run_id}";
/// 端点路径常量。
pub const AILY_V1_RUN_CANCEL: &str =
    "/open-apis/aily/v1/sessions/{session_id}/runs/{run_id}/cancel";

/// AILY 数据资产管理 v1
pub const AILY_V1_DATA_ASSETS: &str = "/open-apis/aily/v1/apps/{app_id}/data_assets";
/// 端点路径常量。
pub const AILY_V1_DATA_ASSET: &str = "/open-apis/aily/v1/apps/{app_id}/data_assets/{data_asset_id}";
/// 端点路径常量。
pub const AILY_V1_DATA_ASSET_TAGS: &str = "/open-apis/aily/v1/apps/{app_id}/data_asset_tags";
/// 端点路径常量。
pub const AILY_V1_UPLOAD_FILE: &str = "/open-apis/aily/v1/apps/{app_id}/data_assets/upload_file";

/// AILY 知识问答 v1
pub const AILY_V1_KNOWLEDGE_ASK: &str = "/open-apis/aily/v1/apps/{app_id}/knowledges/ask";

/// AILY 应用统计数据 v1
pub const AILY_V1_APP_STATS: &str = "/open-apis/aily/v1/app_stats";

/// AILY 技能管理 v1
pub const AILY_V1_SKILLS: &str = "/open-apis/aily/v1/apps/{app_id}/skills";
/// 端点路径常量。
pub const AILY_V1_SKILL: &str = "/open-apis/aily/v1/apps/{app_id}/skills/{skill_id}";
/// 端点路径常量。
pub const AILY_V1_SKILL_START: &str = "/open-apis/aily/v1/apps/{app_id}/skills/{skill_id}/start";

// ==================== AILY Agent（智能体）v1 ====================

/// AILY 智能体产物 v1
pub const AILY_V1_AGENT_ARTIFACT: &str =
    "/open-apis/aily/v1/agents/{agent_id}/artifacts/{agent_artifact_id}";
/// AILY 智能体附件 v1
pub const AILY_V1_AGENT_ATTACHMENTS: &str = "/open-apis/aily/v1/agents/{agent_id}/attachments";
/// AILY 智能体会话 v1
pub const AILY_V1_AGENT_CHATS: &str = "/open-apis/aily/v1/agents/{agent_id}/chats";
/// AILY 智能体会话详情 v1
pub const AILY_V1_AGENT_CHAT: &str = "/open-apis/aily/v1/agents/{agent_id}/chats/{agent_chat_id}";
/// AILY 智能体可见性检查 v1
pub const AILY_V1_AGENT_VISIBILITY_CHECK: &str =
    "/open-apis/aily/v1/agents/{agent_id}/agent_visibility/check";
/// AILY 智能体会话（Session）列表/创建 v1
pub const AILY_V1_AGENT_SESSIONS: &str = "/open-apis/aily/v1/agents/{agent_id}/sessions";
/// AILY 智能体会话（Session）详情 v1
pub const AILY_V1_AGENT_SESSION: &str =
    "/open-apis/aily/v1/agents/{agent_id}/sessions/{agent_chat_session_id}";

#[cfg(test)]
#[allow(unused_imports)]
mod tests {
    use super::*;

    #[test]
    fn test_aily_endpoints() {
        assert!(AILY_V1_SESSIONS.starts_with("/open-apis/aily/v1/"));
        assert!(AILY_V1_SESSION.contains("{session_id}"));
        assert!(AILY_V1_MESSAGES.contains("{session_id}"));
        assert!(AILY_V1_RUNS.contains("{session_id}"));
        assert!(AILY_V1_RUN.contains("{run_id}"));
        assert!(AILY_V1_DATA_ASSETS.contains("{app_id}"));
        assert!(AILY_V1_SKILLS.contains("{app_id}"));
        assert_eq!(AILY_V1_APP_STATS, "/open-apis/aily/v1/app_stats");
    }
}