Agent App：FastAPI、Streamlit 和 Postgres

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

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

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

设置

1. 创建和激活虚拟环境

   Mac

   python3 -m venv .venv
   source .venv/bin/activate
   
2. 安装 Agno

   Mac

   pip install -U "agno[aws]"
   
3. 安装 uv 和 docker

   • 安装 uv 来管理你的 Python 环境。

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   • 安装 docker desktop 在本地运行你的应用程序
4. 导出你的 OpenAI 密钥

   Mac

   export OPENAI_API_KEY=sk-***
   

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

创建你的 Agent App 代码库

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

Mac

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：

terminal

ag ws up

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

• 打开 localhost:8501 查看 Streamlit UI。
• 打开 localhost:8000/docs 查看 FastAPI 路由。

备注：

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

停止本地工作空间

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

terminal

ag ws down

下一步

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

• 在 AWS 上运行您的 Agent App：Run your Agent App on AWS
• 阅读如何更新工作区设置：update workspace settings
• 阅读如何为您的工作区创建 git 存储库：create a git repository for your workspace
• 阅读如何管理开发应用程序：manage the development application
• 阅读如何格式化和验证您的代码：format and validate your code
• 阅读如何添加 python 库：add python libraries
• 在 discord 上与我们聊天：discord