agentkit-sdk-python 0.1.5__py3-none-any.whl

agentkit/toolkit/config/config_manager.py

@@ -0,0 +1,48 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+import json
+
+import yaml
+from pydantic import BaseModel
+
+from agentkit.toolkit.config.build_config import BuildConfig
+from agentkit.toolkit.config.deploy_config import DeployConfig
+from agentkit.toolkit.consts import DEFAULT_CONFIG_FILENAME
+
+
+# class ConfigManager(BaseModel):
+#     """Config manager for AgentKit-related configurations."""
+
+#     build_config: BuildConfig
+
+#     deploy_config: DeployConfig
+
+#     def dump(self, filename: str = DEFAULT_CONFIG_FILENAME):
+#         """Dump self attributes to a `.yaml` file."""
+#         data = self.model_dump()
+#         yaml_str = yaml.dump(data=data)
+
+#         with open(filename, "w", encoding="utf-8") as f:
+#             f.write(yaml_str)
+
+#     @staticmethod
+#     def load(filename: str = DEFAULT_CONFIG_FILENAME) -> "ConfigManager":
+#         with open(filename, "r", encoding="utf-8") as f:
+#             data = f.read()
+
+#         if data:
+#             return ConfigManager(**json.loads(data))
+#         else:
+#             raise ValueError("Empty config file content!")

agentkit/toolkit/config/config_validator.py

@@ -0,0 +1,121 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Configuration validation utilities."""
+
+import re
+from typing import List, Any
+from dataclasses import fields
+
+from agentkit.toolkit.config.config import CommonConfig
+
+
+class ConfigValidator:
+    """配置验证器"""
+    
+    @staticmethod
+    def validate_common_config(config: CommonConfig) -> List[str]:
+        """验证通用配置，返回错误列表
+        
+        Args:
+            config: CommonConfig 实例
+            
+        Returns:
+            错误消息列表，如果为空则验证通过
+        """
+        errors = []
+        
+        # 遍历所有字段并应用验证规则
+        for field in fields(CommonConfig):
+            # 跳过内部字段
+            if field.name.startswith('_'):
+                continue
+                
+            validation = field.metadata.get('validation', {})
+            value = getattr(config, field.name)
+            
+            # 检查必填项
+            if validation.get('required') and (not value or (isinstance(value, str) and not value.strip())):
+                desc = field.metadata.get('description', field.name)
+                errors.append(f"{desc} 是必填项")
+                continue
+            
+            # 检查正则表达式模式
+            pattern = validation.get('pattern')
+            if pattern and value and isinstance(value, str):
+                if not re.match(pattern, value):
+                    desc = field.metadata.get('description', field.name)
+                    msg = validation.get('message', '格式不正确')
+                    errors.append(f"{desc}: {msg}")
+            
+            # 检查选项约束
+            choices = field.metadata.get('choices')
+            if choices and value:
+                valid_values = []
+                if isinstance(choices, list):
+                    if choices and isinstance(choices[0], dict):
+                        valid_values = [c['value'] for c in choices]
+                    else:
+                        valid_values = choices
+                
+                if valid_values and value not in valid_values:
+                    desc = field.metadata.get('description', field.name)
+                    errors.append(f"{desc} 的值必须是以下之一: {', '.join(map(str, valid_values))}")
+        
+        return errors
+    
+    @staticmethod
+    def validate_field_value(field_name: str, value: Any, field_metadata: dict) -> List[str]:
+        """验证单个字段的值
+        
+        Args:
+            field_name: 字段名称
+            value: 字段值
+            field_metadata: 字段的元数据
+            
+        Returns:
+            错误消息列表
+        """
+        errors = []
+        validation = field_metadata.get('validation', {})
+        
+        # 检查必填项
+        if validation.get('required') and (not value or (isinstance(value, str) and not value.strip())):
+            desc = field_metadata.get('description', field_name)
+            errors.append(f"{desc} 是必填项")
+            return errors
+        
+        # 检查正则表达式模式
+        pattern = validation.get('pattern')
+        if pattern and value and isinstance(value, str):
+            if not re.match(pattern, value):
+                desc = field_metadata.get('description', field_name)
+                msg = validation.get('message', '格式不正确')
+                errors.append(f"{desc}: {msg}")
+        
+        # 检查选项约束
+        choices = field_metadata.get('choices')
+        if choices and value:
+            valid_values = []
+            if isinstance(choices, list):
+                if choices and isinstance(choices[0], dict):
+                    valid_values = [c['value'] for c in choices]
+                else:
+                    valid_values = choices
+            
+            if valid_values and value not in valid_values:
+                desc = field_metadata.get('description', field_name)
+                errors.append(f"{desc} 的值必须是以下之一: {', '.join(map(str, valid_values))}")
+        
+        return errors

agentkit/toolkit/config/constants.py

@@ -0,0 +1,18 @@
+"""
+VeAgentkit 常量定义模块
+
+这个模块定义了在整个VeAgentkit项目中使用的通用常量，
+确保各个模块之间的一致性。
+"""
+
+# 自动创建资源的标识符
+AUTO_CREATE_VE = "Auto"
+DEFAULT_WORKSPACE_NAME = "agentkit-cli-workspace"
+DEFAULT_CR_NAMESPACE = "agentkit"
+
+DEFAULT_IMAGE_TAG = "{{timestamp}}"
+
+
+# 其他通用常量可以在这里添加
+# DEFAULT_REGION = "cn-beijing"
+# DEFAULT_TIMEOUT = 300

agentkit/toolkit/config/dataclass_utils.py

@@ -0,0 +1,153 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+from dataclasses import asdict, fields
+from typing import Any, Dict, Type, TypeVar, get_type_hints
+
+T = TypeVar('T')
+
+class DataclassSerializer:
+    
+    @staticmethod
+    def to_dict(obj: Any) -> Dict[str, Any]:
+        return asdict(obj)
+    
+    @staticmethod
+    def from_dict(cls: Type[T], data: Dict[str, Any]) -> T:
+        from dataclasses import MISSING
+        
+        if not hasattr(cls, '__dataclass_fields__'):
+            raise ValueError(f"{cls} must be a dataclass")
+        
+        field_info = {}
+        for field in fields(cls):
+            field_info[field.name] = field
+        
+        kwargs = {}
+        for field_name, field in field_info.items():
+            # 首先尝试使用新字段名
+            if field_name in data:
+                kwargs[field_name] = data[field_name]
+            else:
+                # 尝试从别名中查找（向后兼容）
+                found_in_alias = False
+                aliases = field.metadata.get('aliases', [])
+                for alias in aliases:
+                    if alias in data:
+                        kwargs[field_name] = data[alias]
+                        found_in_alias = True
+                        break
+                
+                # 如果在别名中也没找到，使用默认值
+                if not found_in_alias:
+                    if field.default_factory is not MISSING:
+                        kwargs[field_name] = field.default_factory()
+                    elif field.default is not MISSING:
+                        kwargs[field_name] = field.default
+                    else:
+                        kwargs[field_name] = None
+        
+        return cls(**kwargs)
+
+def auto_to_dict(obj: Any) -> Dict[str, Any]:
+    return DataclassSerializer.to_dict(obj)
+
+def auto_from_dict(cls: Type[T], data: Dict[str, Any]) -> T:
+    return DataclassSerializer.from_dict(cls, data)
+
+class AutoSerializableMixin:
+    """可序列化的 Mixin 类，提供 to_dict/from_dict 和模板渲染功能"""
+    
+    def to_dict(self) -> Dict[str, Any]:
+        return auto_to_dict(self)
+    
+    @classmethod
+    def from_dict(cls: Type[T], data: Dict[str, Any]) -> T:
+        return auto_from_dict(cls, data)
+    
+    def _render_template_fields(self):
+        """渲染所有标记了 render_template=True 的字段
+        
+        此方法会遍历 dataclass 的所有字段，对标记了 render_template=True 的字段
+        进行模板变量渲染（如 {{account_id}}、{{timestamp}} 等）。
+        
+        在渲染前，会将原始模板值保存到 _template_originals 字典中，
+        以便在持久化时能够恢复原始模板值。
+        
+        使用方法：
+            在子类的 __post_init__ 中调用：
+            
+            def __post_init__(self):
+                self._render_template_fields()
+        """
+        # 只在 dataclass 中使用
+        if not hasattr(self, '__dataclass_fields__'):
+            return
+        
+        try:
+            from agentkit.utils.template_utils import render_template
+            from agentkit.toolkit.config import AUTO_CREATE_VE
+            import logging
+            
+            logger = logging.getLogger(__name__)
+            
+            # 初始化原始值存储
+            if not hasattr(self, '_template_originals'):
+                self._template_originals = {}
+            
+            for field_info in fields(self):
+                # 检查字段是否标记了需要渲染
+                if field_info.metadata.get("render_template"):
+                    field_value = getattr(self, field_info.name)
+                    
+                    # 只渲染非空且非自动创建的值
+                    if field_value and field_value != AUTO_CREATE_VE:
+                        # 保存原始模板值（仅当包含模板变量时）
+                        if '{{' in str(field_value) and '}}' in str(field_value):
+                            self._template_originals[field_info.name] = field_value
+                            logger.debug(f"保存原始模板值 {field_info.name}: '{field_value}'")
+                        
+                        try:
+                            rendered = render_template(field_value)
+                            if rendered != field_value:
+                                logger.debug(f"自动渲染配置字段 {field_info.name}: '{field_value}' -> '{rendered}'")
+                                setattr(self, field_info.name, rendered)
+                        except Exception as e:
+                            logger.warning(f"渲染配置字段 {field_info.name} 失败，使用原始值: {e}")
+        except ImportError:
+            # 如果模板工具不可用，静默失败
+            pass
+    
+    def to_persist_dict(self) -> Dict[str, Any]:
+        """转换为用于持久化的字典，保留模板字段的原始值
+        
+        对于标记了 render_template=True 的字段：
+        - 如果有保存的原始模板值（包含 {{}} 的值），使用原始值
+        - 否则使用当前值（可能是用户直接设置的非模板值，或运行时生成的值）
+        
+        这样可以确保配置文件中的模板值（如 '{{timestamp}}' 或 'dev-{{timestamp}}'）
+        在每次运行时都能被重新渲染，而不是固化为某次运行的具体值。
+        
+        Returns:
+            用于持久化的字典
+        """
+        result = self.to_dict()
+        
+        # 如果有保存的原始模板值，恢复它们
+        if hasattr(self, '_template_originals'):
+            for field_name, original_value in self._template_originals.items():
+                result[field_name] = original_value
+        
+        return result

agentkit/toolkit/config/deploy_config.py

@@ -0,0 +1 @@
+class DeployConfig: ...

agentkit/toolkit/config/utils.py

@@ -0,0 +1,57 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Configuration utility functions."""
+
+from typing import Dict, Any
+
+from .constants import AUTO_CREATE_VE
+
+
+def is_invalid_config(s: str) -> bool:
+    return s == None or s == "" or s == AUTO_CREATE_VE
+
+
+def is_valid_config(s: str) -> bool:
+    return not is_invalid_config(s)
+
+
+def merge_runtime_envs(common_config: Any, workflow_config: Dict[str, Any]) -> Dict[str, str]:
+    """合并应用级和 Workflow 级的环境变量
+    
+    合并规则：
+    1. 先加载应用级环境变量（common_config.runtime_envs）
+    2. 再加载 Workflow 级环境变量（workflow_config.runtime_envs）
+    3. 同名变量：Workflow 级覆盖应用级
+    
+    Args:
+        common_config: CommonConfig 实例
+        workflow_config: Workflow 配置字典
+        
+    Returns:
+        合并后的环境变量字典
+    """
+    merged_envs = {}
+    
+    # 1. 加载应用级环境变量
+    app_level_envs = getattr(common_config, 'runtime_envs', {})
+    if isinstance(app_level_envs, dict):
+        merged_envs.update(app_level_envs)
+    
+    # 2. 加载 Workflow 级环境变量（会覆盖同名的应用级变量）
+    workflow_level_envs = workflow_config.get('runtime_envs', {})
+    if isinstance(workflow_level_envs, dict):
+        merged_envs.update(workflow_level_envs)
+    
+    return merged_envs

agentkit/toolkit/config/workflow_configs.py

@@ -0,0 +1,149 @@
+from dataclasses import dataclass, field
+from typing import Dict, List
+from .dataclass_utils import AutoSerializableMixin
+from .constants import AUTO_CREATE_VE, DEFAULT_CR_NAMESPACE, DEFAULT_IMAGE_TAG, DEFAULT_WORKSPACE_NAME
+
+
+@dataclass
+class LocalDockerConfig_v1(AutoSerializableMixin):
+    """Local Docker workflow configuration"""
+    # User configurable fields
+    image_tag: str = field(default="latest", metadata={"description": "Docker image tag", "icon": "🏷️"})
+    invoke_port: int = field(default=8000, metadata={"description": "Agent application invoke port, defaults to 8000", "icon": "🌐"})
+
+    # System internal fields (not visible to users)
+    container_name: str = field(default="", metadata={"system": True, "description": "Container name, uses agent_name if empty"})
+    ports: List[str] = field(default_factory=lambda: ["8000:8000"], metadata={"system": True, "description": "Port mappings in host:container format, comma-separated"})
+    volumes: List[str] = field(default_factory=list, metadata={"system": True, "description": "Volume mappings in host:container format, comma-separated"})
+    restart_policy: str = field(default="unless-stopped", metadata={"system": True, "description": "Restart policy"})
+    memory_limit: str = field(default="1g", metadata={"system": True, "description": "Memory limit"})
+    cpu_limit: str = field(default="1", metadata={"system": True, "description": "CPU limit"})
+    container_id: str = field(default="", metadata={"system": True})
+    image_id: str = field(default="", metadata={"system": True})
+    build_timestamp: str = field(default="", metadata={"system": True})
+    deploy_timestamp: str = field(default="", metadata={"system": True})
+    full_image_name: str = field(default="", metadata={"system": True})
+    runtime_envs: Dict[str, str] = field(
+        default_factory=dict, 
+        metadata={
+            "system": True,
+            "description": "运行时环境变量 (输入 KEY=VALUE，空行结束，del KEY 删除，list 查看)",
+            "examples": "MODEL_AGENT_API_KEY=your_key_here, DEBUG=true",
+            "icon": "🔧"
+        }
+    )
+    _config_metadata = {
+        'name': '本地运行配置',
+        'welcome_message': ' 欢迎使用 AgentKit 本地运行模式 配置向导',
+        'next_step_hint': '本向导将帮助您完成本地模式下应用部署运行相关配置，请根据提示输入相关信息，或直接按Enter键使用默认值。',
+        'completion_message': '太棒了！部署运行配置已完成！',
+        'next_action_hint': '可以使用agentkit launch命令一键启动应用了！'
+    }
+
+
+@dataclass
+class HybridVeAgentkitConfig_v1(AutoSerializableMixin):
+    """本地Docker工作流配置"""
+    # 用户可配置字段
+    image_tag: str = field(default=DEFAULT_IMAGE_TAG, metadata={"system": True, "description": "镜像标签", "icon": "🏷️", "render_template": True})
+    # 系统内部字段（用户不可见）
+    image_id: str = field(default="", metadata={"system": True})
+    build_timestamp: str = field(default="", metadata={"system": True})
+    full_image_name: str = field(default="", metadata={"system": True})
+
+    region: str = field(default="cn-beijing", metadata={"description": "火山引擎服务区域", "icon": "🌏", "aliases": ["ve_region"]})
+    
+    # CR相关配置
+    cr_instance_name: str = field(default=AUTO_CREATE_VE, metadata={"description": "容器镜像服务实例名称", "icon": "📦", "render_template": True, "aliases": ["ve_cr_instance_name"]})
+    cr_namespace_name: str = field(default=DEFAULT_CR_NAMESPACE, metadata={"description": "容器镜像命名空间", "icon": "📁", "render_template": True, "aliases": ["ve_cr_namespace_name"]})
+    cr_repo_name: str = field(default="", metadata={"description": "容器镜像仓库名称", "icon": "📋", "aliases": ["ve_cr_repo_name"]})
+    cr_image_full_url: str = field(default="", metadata={"system": True, "aliases": ["ve_cr_image_full_url"]})
+
+    # runtime相关配置
+    runtime_role_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "Agentkit 授权角色", "icon": "🔐", "aliases": ["ve_runtime_role_name"]})
+    runtime_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "Agentkit Runtime名称", "icon": "⚙️", "aliases": ["ve_runtime_name"]})
+    runtime_id: str = field(default="", metadata={"system": True, "aliases": ["ve_runtime_id"]})
+    runtime_apikey: str = field(default="", metadata={"system": True, "aliases": ["ve_runtime_apikey"]})
+    runtime_apikey_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "aliases": ["ve_runtime_apikey_name"]})
+    runtime_endpoint: str = field(default="", metadata={"system": True, "description": "Agentkit Runtime应用访问入口", "aliases": ["ve_runtime_endpoint"]})
+    runtime_envs: Dict[str, str] = field(
+        default_factory=dict, 
+        metadata={
+            "system": True,
+            "description": "运行时环境变量 (输入 KEY=VALUE，空行结束，del KEY 删除，list 查看)",
+            "examples": "MODEL_AGENT_API_KEY=your_key_here, DEBUG=true",
+            "icon": "🔧"
+        }
+    )
+    _config_metadata = {
+        'name': '混合部署运行模式配置',
+        'welcome_message': ' 欢迎使用 AgentKit 混合部署运行模式 配置向导',
+        'next_step_hint': '本向导将帮助您完成混合模式下应用部署运行相关配置，请根据提示输入相关信息，或直接按Enter键使用默认值。',
+        'completion_message': '太棒了！部署运行配置已完成！',
+        'next_action_hint': '可以使用agentkit launch命令一键启动应用了！'
+    }
+    
+    def __post_init__(self):
+        """对象创建后自动渲染标记的字段"""
+        self._render_template_fields()  # 调用基类方法
+
+
+
+@dataclass
+class VeAgentkitConfig(AutoSerializableMixin):
+    """VeAgentkit工作流配置"""
+    region: str = field(default="cn-beijing", metadata={"description": "服务使用的区域", "icon": "🌏"})
+
+    # TOS配置
+    tos_bucket: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "TOS存储桶名称", "icon": "🗂️", "render_template": True})
+    tos_prefix: str = field(default="agentkit-builds", metadata={"system": True, "description": "TOS对象前缀"})
+    tos_region: str = field(default="cn-beijing", metadata={"system": True, "description": "TOS区域"})
+    tos_object_key: str = field(default="", metadata={"system": True})
+    tos_object_url: str = field(default="", metadata={"system": True})
+    
+    # CR配置
+    image_tag: str = field(default=DEFAULT_IMAGE_TAG, metadata={"system": True, "description": "镜像标签", "icon": "🏷️", "render_template": True})
+    cr_instance_name: str = field(default=AUTO_CREATE_VE, metadata={"description": "CR实例名称", "icon": "📦", "render_template": True, "aliases": ["ve_cr_instance_name"]})
+    cr_namespace_name: str = field(default=DEFAULT_CR_NAMESPACE, metadata={"description": "CR命名空间", "icon": "📁", "render_template": True, "aliases": ["ve_cr_namespace_name"]})
+    cr_repo_name: str = field(default="", metadata={"description": "CR仓库名称，默认使用AgentKit项目名", "icon": "📋", "aliases": ["ve_cr_repo_name"]})
+    cr_region: str = field(default="cn-beijing", metadata={"system": True, "description": "CR区域", "aliases": ["ve_cr_region"]})
+    cr_image_full_url: str = field(default="", metadata={"system": True, "aliases": ["ve_cr_image_full_url"]})
+    build_timeout: int = field(default=3600, metadata={"system": True, "description": "构建超时时间(秒)"})
+
+    cp_workspace_name: str = field(default=DEFAULT_WORKSPACE_NAME, metadata={"system": True, "description": "Code Pipeline工作区名称"})
+    cp_pipeline_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "Code Pipeline流水线名称"})
+    cp_pipeline_id: str = field(default="", metadata={"system": True})
+
+    # Runtime配置
+    runtime_id: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "运行时ID", "aliases": ["ve_runtime_id"]})
+    runtime_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "运行时名称", "aliases": ["ve_runtime_name"]})
+    runtime_role_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "运行时角色名称", "aliases": ["ve_runtime_role_name"]})
+    runtime_apikey: str = field(default=AUTO_CREATE_VE, metadata={"system": True,"description": "运行时API密钥", "aliases": ["ve_runtime_apikey"]})
+    runtime_apikey_name: str = field(default=AUTO_CREATE_VE, metadata={"system": True, "description": "运行时API密钥名称", "aliases": ["ve_runtime_apikey_name"]})
+    runtime_endpoint: str = field(default="", metadata={"system": True, "description": "运行时访问入口，自动获取", "aliases": ["ve_runtime_endpoint"]})
+    runtime_envs: Dict[str, str] = field(
+        default_factory=dict, 
+        metadata={
+            "system": True,
+            "description": "运行时环境变量 (输入 KEY=VALUE，空行结束，del KEY 删除，list 查看)",
+            "examples": "MODEL_AGENT_API_KEY=your_key_here, DEBUG=true",
+            "icon": "🔧"
+        }
+    )
+    
+    build_timestamp: str = field(default="", metadata={"system": True})
+    deploy_timestamp: str = field(default="", metadata={"system": True})
+
+    _config_metadata = {
+        'name': '云构建与部署配置',
+        'welcome_message': ' 欢迎使用 AgentKit 云构建与部署模式 配置向导',
+        'next_step_hint': '本向导将帮助您完成云构建与部署模式下应用部署运行相关配置，请根据提示输入相关信息，或直接按Enter键使用默认值。',
+        'completion_message': '太棒了！部署运行配置已完成！',
+        'next_action_hint': '可以使用agentkit launch命令一键启动应用了！'
+    }
+    
+    def __post_init__(self):
+        """对象创建后自动渲染标记的字段"""
+        self._render_template_fields()  # 调用基类方法
+    
+

agentkit/toolkit/consts.py

@@ -0,0 +1 @@
+DEFAULT_CONFIG_FILENAME = "agentkit.yaml"

agentkit/toolkit/core/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

agentkit/toolkit/core/build/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

agentkit/toolkit/core/build/base_builder.py

@@ -0,0 +1,6 @@
+from abc import ABC, abstractmethod
+
+
+class BaseBuilder(ABC):
+    @abstractmethod
+    def build(self): ...

agentkit/toolkit/core/deploy/__init__.py

@@ -0,0 +1,13 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.

agentkit/toolkit/core/deploy/base_deployer.py

@@ -0,0 +1,6 @@
+from abc import ABC, abstractmethod
+
+
+class BaseDeployer(ABC):
+    @abstractmethod
+    def deploy(self): ...

agentkit/toolkit/integrations/__init__.py

@@ -0,0 +1,17 @@
+# Copyright (c) 2025 Beijing Volcano Engine Technology Co., Ltd. and/or its affiliates.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from .services import CRService, CRServiceConfig, CRServiceResult, CRConfigCallback, DefaultCRConfigCallback
+
+__all__ = ['CRService', 'CRServiceConfig', 'CRServiceResult', 'CRConfigCallback', 'DefaultCRConfigCallback']