Looking to manually trigger tests from CI/CD workflows? See GitHub Actions instead.
What It Does
Feature | Description |
---|---|
✅ Autonomous Testing | Automatically detects which tests to run based on PR changes |
✅ Test Generation | Creates missing tests for untested functionality |
✅ Preview Environment Testing | Tests against PR preview deployments |
✅ Approval/Rejection | Posts reviews with pass/fail verdicts |
❌ Manual Control | No control over which tests run (use Actions for that) |
❌ Custom Workflows | No YAML workflows needed or supported |
1
Install GitHub App
Go to Settings → Organization → Connections and add the GitHub App connection. Follow the OAuth flow to grant access to your repositories.
2
Select Repository
Navigate to Settings → Integrations and select the repository you want to enable PR reviews for.PR reviews are enabled automatically once you select a repository.
3
Create a Pull Request
Once enabled, the agent automatically:
- Detects code changes when PRs are opened or updated
- Determines which tests are relevant
- Creates new tests for untested functionality
- Runs all relevant tests against the PR preview
- Posts a review with approval or decline based on results
Understanding GitHub Deployments
GitHub Deployments are GitHub’s native way of tracking when code is deployed to an environment. When your CI/CD deploys a PR, it can create a deployment record that includes the environment name and URL. Platforms with automatic GitHub deployment integration:- Vercel - Creates GitHub deployments automatically for every PR
- Netlify - Auto-registers deployments when configured
- Render, Railway, Fly.io - Most modern platforms support this
Without GitHub deployments, QA.tech won’t know which URL to test your PR against. Environment mapping only works when your CI/CD creates these deployment records.
Environment Mapping
Map GitHub deployment environments to QA.tech Applications so tests run against the correct preview URLs. When to use:- You have multiple Applications (frontend, backend, etc.)
- Your CI/CD creates GitHub deployment environments
- You want tests to run against PR-specific URLs
- Your CI/CD deploys a PR and creates a GitHub environment (e.g., “Preview” or “pr-123”)
- QA.tech detects the deployment
- Tests run using the mapped Application’s URL from that environment
How PR Reviews Work
Agent Workflow
Review Format
The agent posts a review with:- Verdict: ✅ Tests passing / ❌ Tests failing / ℹ️ Unable to verify
- What was tested: Description of coverage in prose
- Results summary: Patterns and themes from test outcomes
- Test details: Automatic table with individual test results
- Code quality opinions
- Implementation suggestions
- References to other bot comments
Best Practices
Deploy with Vercel or Netlify These platforms automatically create GitHub deployments, making PR testing seamless. No additional configuration needed - just connect your repository and every PR gets tested automatically. Build a regression test suite As your PR tests pass, promote them to a regression test plan. This creates a growing suite of real-world tests that catch regressions automatically on future PRs. Let QA.tech test PRs first Configure PR reviews to run before requesting human code review. This catches functional issues early, so your colleagues can focus on code quality instead of manually testing features. Customize reviews with context Add domain-specific instructions to guide the AI agent’s testing approach. Go to Settings → Integrations → GitHub App and add review context. Example for payment flows:- Specify areas requiring extra scrutiny
- Provide domain-specific testing guidelines
- Add authentication/setup requirements
Troubleshooting
PR reviews aren’t posting
Check:- GitHub App installed and granted repository access
- Repository integration configured in QA.tech
- PR reviews are enabled for this repository
- PR has user-facing changes (not docs/infra only)
Tests running against wrong URL
Solutions:- Map your GitHub environments to Applications (Settings → Integrations → GitHub App → Map Environments)
- Verify your CI/CD creates GitHub deployment environments
- Check that environment names match between GitHub and QA.tech
Agent created irrelevant tests
Solutions:- Add review context with specific testing guidelines
- Update existing tests to cover the functionality better
- The agent learns from your existing test patterns
Review says “Unable to verify through end-to-end testing”
This is expected for:- Documentation-only changes (.md, .txt, README)
- Infrastructure changes (CI/CD, Docker, deployment scripts)
- Build configuration (package.json without functional changes)
Limitations
- No manual test selection: Agent autonomously decides which tests to run
- Requires preview deployments: Cannot test without accessible PR environment
- UI-testable changes only: Backend-only microservices without UI access can’t be tested
- No workflow customization: Unlike GitHub Actions, there’s no YAML configuration
Need Manual Control?
If you need to:- Choose specific test plans to run
- Trigger tests from custom CI/CD steps
- Control test execution timing
- Run deep exploratory testing on-demand
@qatech
mentions. You can use both approaches for comprehensive coverage.