{
  "markdown": "# Altostrat Singapore Enterprise HR Agentic Virtual Assistant (MVP 1)\n\nThis repository contains the complete implementation of the enterprise-grade **HR Agentic Virtual Assistant** for Altostrat Singapore, built for Google Cloud Vertex AI and Cloud Run, connected to Argolis project **`philchen-project-elevate`**.\n\nBuilt in accordance with:\n- **BRD**: [HR Agentic Solution BRD (MVP 1)](https://docs.google.com/document/d/1B46ERMVZapwSN8RPmsJ0_NnayuUkaTT6ZcujgwdjTX8/edit?resourcekey=0-kwi-DdO3wHIdEk8gtbpeQQ&tab=t.tpcr3esq94y#heading=h.tsvh2037jsz5)\n- **SDD**: [`SDD.md`](./SDD.md) ([`ENTERPRISE_AGENTIC_SDD_MVP1.md`](https://github.com/philipcaffeine/gcp-elevate-group3/blob/main/sdd/ENTERPRISE_AGENTIC_SDD_MVP1.md))\n- **Elevate APAC Module 3 Tasks**: `go/elevate-apac-m3-policydoc`, `go/elevate-apac-m3-saas`, and `go/elevate-apac-skills`.\n\n---\n\n## 📁 Prescribed Repository Architecture\n\n```text\nphilchen-elevate-agent/\n├── app/                      # Core agent implementation\n│   ├── __init__.py\n│   ├── agent.py              # ADK LlmAgent / Gemini orchestrator & lifecycle\n│   ├── config.py             # Settings, environment variables, model declarations\n│   ├── prompt.py             # System prompt with strict grounding, citations & refusal rules\n│   ├── guardrails.py         # DLP SPII masking, Model Armor filters, RBAC caller scoping\n│   ├── main.py               # Application entrypoint (FastAPI + Web Chat UI)\n│   ├── knowledge/            # OKF markdown knowledge base (35 policy sections)\n│   └── tools/                # Enterprise connectors and tool functions\n│       ├── __init__.py\n│       ├── policy_tool.py    # Policy Q&A engine over go/elevate-apac-m3-policydoc\n│       ├── hrms_tool.py      # WorkWeek HCM connector (profile, balance, leave, contact)\n│       ├── itms_tool.py      # ServiceImmediately ITSM connector via MCP server\n│       ├── mcp_client.py     # MCP client handling authorization & token handshake\n│       └── workflow_tool.py  # UC-2.2 cross-system medical leave + email delegation\n├── tests/                    # Unit and integration test suite\n│   ├── __init__.py\n│   ├── test_guardrails.py    # Tests for SPII redaction, prompt injection & caller scoping\n│   ├── test_tools.py         # Tests for HRMS, ITMS, and Policy retrieval tools\n│   └── test_workflows.py     # End-to-end tests for UC-2.2 cross-system transactions\n├── eval/                     # Evaluation pipeline\n│   ├── datasets/             # Golden test evaluation datasets\n│   │   ├── eval-data.json    # Tier 1 & 2 baseline and functional test cases\n│   │   └── eval-data2.json   # Tier 3 & 4 edge cases, security traps, and policy gotchas\n│   ├── eval_config.yaml      # Metrics, dimensions, weights, and scoring thresholds\n│   ├── run_eval.py           # Evaluation runner script\n│   └── evaluation_report.md  # 2-section evaluation report (Approach/Design & Results)\n├── agents-cli-manifest.yaml  # Google Agents CLI manifest definition\n├── pyproject.toml            # Project dependencies and tool configurations\n├── Dockerfile                # Cloud Run containerization\n├── deploy.sh                 # Deployment script for philchen-project-elevate\n└── SDD.md                    # Canonical SDD specification\n```\n\n---\n\n## 🚀 Quickstart & Local Execution\n\n### 1. Setup Virtual Environment & Install Dependencies\n```bash\n# Using uv (recommended)\nuv venv\nsource .venv/bin/activate\nuv pip install -e \".[dev]\"\n```\n\n### 2. Configure Environment Variables\n```bash\ncp .env.example .env\n# Project is configured for philchen-project-elevate with Gemini 3.5 Flash\n```\n\n### 3. Run the Unit Test Suite\n```bash\npytest tests/ -v\n```\n\n### 4. Run the Evaluation Benchmark\n```bash\npython eval/run_eval.py\n```\n\n### 5. Launch the Local Web Chat Application\n```bash\nuvicorn app.main:app --host 0.0.0.0 --port 8080 --reload\n```\nOpen **[http://localhost:8080](http://localhost:8080)** in your browser to interact with the agent.\n\n---\n\n## ☁️ Deploying to Cloud Run (`philchen-project-elevate`)\n\nEnsure your Google Cloud credentials and project are active:\n```bash\ngcloud auth login admin@philchen.altostrat.com\ngcloud auth application-default login\ngcloud config set project philchen-project-elevate\n\n# Deploy to Cloud Run\n./deploy.sh\n```\n",
  "bytes": 4239,
  "sha": "94b855a686b577245fea17bfc631bebaf7e2b71d3da279b9686d363d98441797",
  "repo_slug": "philipcaffeine/philchen-elevate-agent",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/okf_philipcaffeine_philchen_elevate_agent_ap_05b3eb61/readme"
}