Agent App 是我们构建 Agentic 系统的首选工作区。它包含：

  • 一个用于提供 Agents、Teams 和 Workflows 的 FastAPI 服务器。
  • 一个用于调试和测试的 streamlit 应用程序。这个 streamlit 应用功能非常全面，可用作 Agentic 系统的管理界面，并显示各种数据。
  • 一个用于会话和向量存储的 postgres 数据库。

它设计用于通过 docker 在本地运行，并在 AWS 上进行生产部署。

​
设置

1

创建和激活虚拟环境

python3 -m venv .venv
source .venv/bin/activate
2

安装 Agno

pip install -U "agno[aws]"
3

安装 uv 和 docker

  • 安装 uv 来管理你的 Python 环境。
curl -LsSf https://astral.sh/uv/install.sh | sh
4

导出你的 OpenAI 密钥

export OPENAI_API_KEY=sk-***

Agno 与任何模型提供商兼容；只需更新工作区中的代理即可。

​
创建你的 Agent App 代码库

使用 agent-app 模板创建你的代码库，你可以给它起任何你喜欢的名字。

ag ws create --template agent-app --name agent-app

这将创建一个名为 agent-app 的文件夹，结构如下：

agent-app                     # 根目录
├── agents                  # 你的 Agents 放在这里
├── api                     # 你的 API 路由放在这里
├── ui                      # 你的 Streamlit 应用放在这里
├── db                      # 你的数据库表放在这里
├── Dockerfile              # 应用程序的 Dockerfile
├── pyproject.toml          # Python 项目定义
├── requirements.txt        # 使用 pyproject.toml 生成的 Python 依赖
├── scripts                 # 辅助脚本
├── utils                   # 共享工具
└── workspace               # Agno 工作区目录
    ├── dev_resources.py    # 本地运行的开发资源
    ├── prd_resources.py    # 在 AWS 上运行的生产资源
    ├── secrets             # 敏感信息
    └── settings.py         # Agno 工作区设置

​
在本地运行您的 Agent App

进入 agent-app 文件夹

cd agent-app

使用以下命令启动您的 Agent App：

ag ws up

按 Enter 键确认，并等待几秒钟让镜像下载（仅首次运行此操作）。在 Docker Dashboard 上验证容器状态并查看日志。

agent-app-ui

备注：

  • Agents 定义在 agents 文件夹中。
  • Streamlit 应用定义在 ui 文件夹中。
  • API 路由定义在 api 文件夹中。

​
停止本地工作空间

进行一些尝试后，使用以下命令停止工作空间：

ag ws down

​
下一步

恭喜您已在本地运行了 AI App。后续步骤：