ArjitSharma19/ambient-expense-agent
GitHub: ArjitSharma19/ambient-expense-agent
一个基于 Google ADK 和 Gemini 构建的事件驱动型费用处理智能体服务，内置安全防护与完整部署工具链。
Stars: 0 | Forks: 0
# ambient-expense-agent
简单的 ReAct agent
使用 `agents-cli` 版本 `0.5.0` 生成的 Agent
## 项目结构
```
ambient-expense-agent/
├── app/ # Core agent code
│ ├── agent.py # Main agent logic
│ ├── agent_runtime_app.py # Agent Runtime application logic
│ └── app_utils/ # App utilities and helpers
├── tests/ # Unit, integration, and load tests
├── GEMINI.md # AI-assisted development guide
└── pyproject.toml # Project dependencies
```
## 环境要求
在开始之前，请确保您已具备：
- **uv**：Python 包管理器（在本项目中用于所有依赖管理） - [安装](https://docs.astral.sh/uv/getting-started/installation/)（使用 `uv add ` [添加包](https://docs.astral.sh/uv/concepts/dependencies/)）
- **agents-cli**：Agents CLI - 使用 `uv tool install google-agents-cli` 安装
- **Google Cloud SDK**：用于 GCP 服务 - [安装](https://cloud.google.com/sdk/docs/install)
## 快速开始
如果尚未安装，请安装 `agents-cli` 及其技能：
```
uvx google-agents-cli setup
```
安装所需的包：
```
agents-cli install
```
使用本地 Web 服务器测试 agent：
```
agents-cli playground
```
您还可以通过 `uv run adk` 使用 [ADK](https://adk.dev/) CLI 的功能。
## 命令
| 命令 | 描述 |
| -------------------- | ------------------------------------------------------------------------------------------- |
| `agents-cli install` | 使用 uv 安装依赖 |
| `agents-cli playground` | 启动本地开发环境 |
| `agents-cli lint` | 运行代码质量检查 |
| `agents-cli eval` | 评估 agent 行为（生成、评分、分析等更多功能 — 请参阅 `agents-cli eval --help`） |
| `uv run pytest tests/unit tests/integration` | 运行单元测试和集成测试 |
| `agents-cli deploy` | 将 agent 部署到 Agent Runtime |
| `agents-cli publish gemini-enterprise` | 将部署的 agent 注册到 Gemini Enterprise |
## 🛠️ 项目管理
| 命令 | 作用 |
|---------|--------------|
| `agents-cli scaffold enhance` | 添加 CI/CD pipeline 和 Terraform 基础设施 |
| `agents-cli infra cicd` | 一键设置整个 CI/CD pipeline + 基础设施 |
| `agents-cli scaffold upgrade` | 自动升级到最新版本，同时保留自定义配置 |
## 开发
在 `app/agent.py` 中编辑您的 agent 逻辑，并使用 `agents-cli playground` 进行测试 - 它会在保存时自动重新加载。
## 部署
```
gcloud config set project
agents-cli deploy
```
要添加 CI/CD 和 Terraform，请运行 `agents-cli scaffold enhance`。
要设置您的生产环境基础设施，请运行 `agents-cli infra cicd`。
## 可观测性
内置的遥测功能会导出到 Cloud Trace、BigQuery 和 Cloud Logging。
标签：AI智能体, AV绕过, FastAPI, Gemini, PII脱敏, 事件驱动, 提示词注入防御, 逆向工具