Upsonic

环境要求

• Python 环境（用于运行 Agent 脚本）
• uv 或 pip 包管理器（README 提供 uv pip install 与 pip install 两种方式）
• 一个可用的模型标识，示例为 anthropic/claude-sonnet-4-5
• 一个用于限制文件与 Shell 操作的本地 workspace 目录，如 /path/to/logs

安装与启动步骤

1. 1安装 Upsonic

   使用 uv 安装 Upsonic 库；若环境中没有 uv，可改用注释中的 pip 命令安装。

   uv pip install upsonic

   复制

2. 2配置 IDE 文档索引

   在 Cursor 中打开 Settings → Indexing & Docs，添加下方文档地址；VSCode、Windsurf 等工具同样可用。

   https://docs.upsonic.ai/llms-full.txt

   复制

3. 3编写 Agent 脚本

   新建 Python 文件，导入 AutonomousAgent 与 Task，指定模型与 workspace，并用 print_do 执行任务。

   from upsonic import AutonomousAgent, Task
   
   agent = AutonomousAgent(
       model="anthropic/claude-sonnet-4-5",
       workspace="/path/to/logs"
   )
   
   task = Task("Analyze server logs and detect anomaly patterns")
   
   agent.print_do(task)

   复制

4. 4运行 Agent

   把上面代码保存为 main.py，在终端执行，观察任务执行过程与输出结果。

   python main.py

   复制

关键配置

如何确认成功

运行脚本后 print_do 会打印任务执行过程与结果，终端无报错即表示 Agent 已正常工作。

常见问题

注意事项

• model 需按「提供商/模型名」格式填写，示例为 anthropic/claude-sonnet-4-5。
• workspace 建议使用绝对路径，Agent 的全部文件与命令操作都不会越出该目录。
• README 未说明 API 密钥的配置方式，涉及密钥与更多用法请查阅官方文档 https://docs.upsonic.ai。
• 预构建智能体集合开放社区贡献，可直接复用或按需修改。