Metadata-Version: 2.4
Name: vertical-skills-agent
Version: 1.0.0
Summary: CLI tool to create Google Cloud AI agents from vertical skills
Author-email: Google Cloud AI <noreply@google.com>
License: Apache-2.0
Project-URL: Homepage, https://github.com/GoogleCloudPlatform/vertical-skills-agent
Project-URL: Documentation, https://github.com/GoogleCloudPlatform/vertical-skills-agent
Project-URL: Repository, https://github.com/GoogleCloudPlatform/vertical-skills-agent
Project-URL: Issues, https://github.com/GoogleCloudPlatform/vertical-skills-agent/issues
Keywords: google-cloud,ai,agents,vertex-ai,cli
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: agent-starter-pack>=0.40.0
Requires-Dist: click>=8.1.7
Requires-Dist: rich>=13.7.0
Requires-Dist: pyyaml>=6.0.1
Requires-Dist: jinja2>=3.1.0

# Vertical Skills Agent CLI

Create production-ready Google Cloud AI agents from vertical skills in minutes.

## Quick Start

```bash
# Install skill
npx skills add GoogleCloudPlatform/vertical-skills/skills/product-search -y

# Create agent
uvx vertical-skills-agent create product-search
```

## What It Does

This CLI tool:
1. Interviews you with 9 domain-specific questions
2. Generates a comprehensive DESIGN_SPEC.md
3. Scaffolds a complete agent project using agent-starter-pack
4. Adds custom ingestion scripts tailored to your schema
5. Provides clear next steps for deployment

## Installation

```bash
# Using uvx (recommended)
uvx vertical-skills-agent create product-search

# Or install globally
pip install vertical-skills-agent
vertical-skills-agent create product-search
```

## Usage

```bash
# Interactive mode (recommended)
vertical-skills-agent create product-search

# Skip interview with defaults
vertical-skills-agent create product-search --skip-interview

# Custom output directory
vertical-skills-agent create product-search --output-dir ./my-agents

# Debug mode
vertical-skills-agent create product-search --debug
```

## Generated Project Structure

```
electronics-search/
├── DESIGN_SPEC.md           # Your requirements
├── app/
│   ├── agent.py             # Main agent logic
│   ├── search_agent.py      # Vector Search integration
│   └── orchestrator.py      # Multi-agent orchestration
├── scripts/
│   └── ingestion/
│       └── ingest_bigquery.py   # Custom BigQuery ingestion
├── tests/
│   └── eval/                # Evaluation templates
├── deployment/
│   └── terraform/           # Infrastructure as code
├── Makefile                 # Development commands
└── pyproject.toml           # Dependencies
```

## Next Steps After Generation

```bash
cd electronics-search

# 1. Provision infrastructure
make setup-datastore

# 2. Ingest your product data
python scripts/ingestion/ingest_bigquery.py \
  --project-id YOUR_PROJECT \
  --gcs-bucket YOUR_BUCKET \
  --gcs-path products.csv

# 3. Test locally
make playground

# 4. Run evaluations
make eval

# 5. Deploy to production
make deploy
```

## Requirements

- Python 3.10+
- Google Cloud Project with billing enabled
- Vertex AI API enabled

## Documentation

- [Product Search Skill](https://github.com/GoogleCloudPlatform/vertical-skills/tree/main/skills/product-search)
- [Agent Starter Pack](https://github.com/GoogleCloudPlatform/agent-starter-pack)
- [ADK Documentation](https://adk.dev)

## License

Apache 2.0
