CUGA：构建真实Agentic应用的轻量级工具

来源: Hugging Face / IBM Research | 发布日期: 2026-06-23 | 链接: https://huggingface.co/blog/ibm-research/cuga-apps

文章摘要

IBM Research 发布 CUGA（Convention-based Unified Agent Architecture），一个用于构建真实 Agentic 应用的轻量级工具包，而非完整框架。核心设计原则：约定优于配置——通过文件和命名约定自动处理规划、工具调用、状态管理，开发者只需专注于业务逻辑本身。提供 IBM Cloud Advisor 等完整示例，一个文件包含 agent factory + 工具定义 + prompt。CUGA 支持多种 LLM 提供商（OpenAI/Anthropic/watsonx/LiteLLM/Ollama），通过环境变量切换，零代码改写。

为什么重要

当前 Agent 开发的最大问题是样板代码过多：每个 Agent 项目都要写大量重复的基础设施代码（状态管理、工具注册、错误处理、重试逻辑）。CUGA 通过约定自动处理这些，而非提供一个新的框架。这对于企业真实场景很有价值：开发者写业务逻辑，系统自动处理 Agent 管道。IBM 将其定位为"工具而非框架"也意味着可以渐进式引入，不影响现有系统。

关键要点

• 核心创新：约定自动处理规划/执行/状态，而非提供新的抽象框架
• 多模型支持：OpenAI/Anthropic/watsonx/LiteLLM/Ollama，环境变量切换无需改代码
• 轻量级：一个 main.py 文件包含完整 agent；不引入复杂依赖
• 实际案例：IBM Cloud Advisor（推荐 IBM Cloud 服务）完整示例
• 意义：为企业 Agent 开发提供渐进式、低摩擦的引入路径，而非颠覆性重写