Deploying Your First Agent

This guide walks you through deploying your first AI agent on BambooSnow. We'll cover template selection, configuration, and monitoring.

Choosing an Agent Template

BambooSnow offers several pre-built agent templates:

| Template | Best For | |----------|----------| | Code Reviewer | Automated PR reviews and suggestions | | Test Generator | Creating unit tests for new code | | Security Scanner | Finding vulnerabilities and CVEs | | Dependency Updater | Keeping packages up to date |

For your first agent, we recommend starting with the Code Reviewer - it provides immediate value on every pull request.

Step-by-Step Deployment

Step 1: Create New Agent

1. Navigate to Agents in the sidebar
2. Click Create New Agent
3. Select your connected repository

Step 2: Choose Template

1. Browse the available templates
2. Click on Code Reviewer (or your preferred template)
3. Review what the agent does and its capabilities

Step 3: Configure Triggers

Decide when the agent should run:

Pull Request Events

• opened - When a new PR is created
• synchronize - When new commits are pushed
• reopened - When a closed PR is reopened

Recommended starter config:

triggers:
  pull_request:
    - opened
    - synchronize

Step 4: Set Behavior Options

Configure how the agent operates:

• Review Style: Thorough, balanced, or quick
• Comment Threshold: Minimum severity to comment on
• Auto-approve: Whether to approve PRs with no issues
• Language Focus: Which file types to analyze

Step 5: Deploy

1. Review your configuration
2. Click Deploy Agent
3. The agent is now active!

Verifying Deployment

After deployment, verify your agent is working:

1. Check Agent Status

   • Go to Agents dashboard
   • Your agent should show "Active" status

2. View Webhook Configuration

   • The agent automatically registers webhooks
   • Check your repository's webhook settings in GitHub

3. Test with a PR

   • Create a small test pull request
   • Watch for the agent's review within 30 seconds

Agent Configuration File

Each agent creates a .bamboosnow/agents.yml file in your repository:

agents:
  - name: code-reviewer
    template: code-reviewer
    triggers:
      pull_request:
        - opened
        - synchronize
    config:
      review_style: balanced
      min_severity: info
      auto_approve: false

You can edit this file directly to modify agent behavior.

Monitoring Agent Activity

Track your agent's performance:

• Runs Dashboard: View all agent executions
• Activity Feed: Real-time log of agent actions
• Metrics: Success rate, average run time, issues found

Troubleshooting

Agent not running?

• Check webhook delivery in GitHub settings
• Verify the trigger events match your PR action
• Ensure the agent status is "Active"

Reviews not appearing?

• Check the agent has permission to comment
• Verify the repository connection is healthy
• Review agent logs for errors

Next Steps

• Configure agent behavior in detail
• Set up approval workflows
• Add Slack notifications