Struct ClientConfig 

pub struct ClientConfig {
    pub api_url: String,
    pub mqtt_broker_url: String,
    pub token: Option<String>,
    pub user_id: Option<String>,
}

SDK 客户端配置

Fields

api_url: String

API 基础 URL（包含路径前缀）

mqtt_broker_url: String

MQTT Broker URL

token: Option<String>

JWT Token 或 API Key（可选）

user_id: Option<String>

用户 ID（可选，登录后设置）

Implementations

impl ClientConfig

pub fn new(api_url: &str, mqtt_broker_url: &str) -> Self

创建新的配置

pub fn from_env() -> Result<Self, SdkError>

从环境变量创建配置

环境变量

• AGENTLINK_API_KEY: API Key（必需）
• AGENTLINK_API_URL: API 基础 URL（可选，默认值：https://agentlink-api.feedecho.xyz）
  • 注意：只需要提供域名，不需要 /api/v1 路径
  • MQTT URL 会自动从 API URL 推导出来

Example

// 设置环境变量
std::env::set_var("AGENTLINK_API_KEY", "your-api-key");
std::env::set_var("AGENTLINK_API_URL", "https://agentlink-api.feedecho.xyz");

// 从环境变量创建配置
let config = ClientConfig::from_env().expect("Missing AGENTLINK_API_KEY");
// api_url = "https://agentlink-api.feedecho.xyz/api/v1"
// mqtt_url = "mqtts://mqtt.feedecho.xyz:8883"

pub fn try_from_env() -> Option<Self>

尝试从环境变量创建配置，如果环境变量不存在则使用默认值

Example

// 如果 AGENTLINK_API_KEY 不存在，返回 None
let config = ClientConfig::try_from_env();

// 如果 AGENTLINK_API_KEY 存在，返回 Some(config)
std::env::set_var("AGENTLINK_API_KEY", "your-api-key");
let config = ClientConfig::try_from_env().expect("Should have config");

pub fn with_token(self, token: String) -> Self

设置 Token

pub fn with_user_id(self, user_id: String) -> Self

设置用户 ID

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ClientConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ClientConfig

fn default() -> Self

Returns the “default value” for a type.