Pular para o conteúdo

Folha de Dicas do Augment Code

## Visão Geral

Augment Code é uma plataforma de desenvolvimento de software com IA, apresentando agentes de codificação autônomos, um mecanismo de contexto de ponta e geração de código pronto para produção. Ele se especializa em lidar com grandes bases de código e tarefas de desenvolvimento complexas com intervenção humana mínima.

⚠️ Nota: Requer assinatura ($25/mês Pro, planos Enterprise disponíveis)

Instalação

VS Code

JetBrains IDEs

Terminal/CLI

Autenticação

Configuração Inicial

Uso Básico

Geração de Código

Modo de Agente

Integração de IDE

Comandos do VS Code

Painel de Contexto

Recursos Avançados

Mecanismo de Contexto

Agentes Remotos

Aplicação Inteligente

Configuração

Configurações Globais

Configuração do Projeto

Memórias e Regras

Uso Específico por Linguagem

JavaScript/TypeScript

Python

React

Exemplos de Workflow

Desenvolvimento de Funcionalidade

Refatoração de Código

Would you like me to fill in the remaining sections with more detailed translations, or is this structure sufficient?```bash

Install from VS Code Marketplace

Search for “Augment” in Extensions

Or install via command line

code —install-extension augment.augment-vscode


### JetBrains IDEs
```bash
# Install from JetBrains Plugin Repository
# Go to File > Settings > Plugins
# Search for "Augment" and install

Terminal/CLI

# Install Augment CLI
npm install -g @augment/cli

# Or using brew (macOS)
brew install augment-code/tap/augment

# Verify installation
augment --version

Authentication

Initial Setup

# Authenticate with Augment account
augment auth login

# Check authentication status
augment auth status

# View current user
augment auth whoami

# Logout
augment auth logout

Basic Usage

Code Generation

# Generate code from natural language
augment generate "Create a REST API for user management with CRUD operations"

# Generate with specific framework
augment generate "Build a React component for file upload" --framework react

# Generate with context
augment generate "Add authentication middleware" --context ./src/auth/

Agent Mode

# Start autonomous agent
augment agent start

# Assign task to agent
augment agent task "Implement user authentication system with JWT tokens"

# Monitor agent progress
augment agent status

# Review agent changes
augment agent review

# Apply agent changes
augment agent apply

IDE Integration

VS Code Commands

ComandoAtalhoDescrição
Augment: Generate CodeCtrl+Shift+GGerar código a partir de prompt
Augment: Explain CodeCtrl+Shift+EExplicar código selecionado
Augment: RefactorCtrl+Shift+RRefatorar código selecionado
Augment: Add TestsCtrl+Shift+TGerar testes para código
Augment: Fix IssuesCtrl+Shift+FCorrigir problemas de código
Augment: Start AgentCtrl+Shift+AIniciar agente autônomo

Context Panel

# Open context panel
Ctrl+Shift+P > "Augment: Show Context"

# Add files to context
# Right-click file > "Add to Augment Context"

# Focus context on specific area
# Select code > "Focus Augment Context"

# Clear context
# Context panel > "Clear All"

Advanced Features

Context Engine

# Index entire codebase
augment index --recursive

# Update index
augment index --update

# Query codebase
augment query "Find all authentication functions"

# Analyze dependencies
augment analyze --dependencies

# Generate codebase summary
augment summarize --output summary.md

Remote Agents

# Start remote agent (cloud execution)
augment agent start --remote

# Configure remote resources
augment config set agent.memory 8GB
augment config set agent.cpu 4cores

# Monitor remote agent
augment agent logs --follow

# Stop remote agent
augment agent stop --remote

Smart Apply

# Preview changes before applying
augment apply --preview

# Apply changes with conflict resolution
augment apply --resolve-conflicts

# Apply specific files only
augment apply --files src/auth.js,src/middleware.js

# Rollback changes
augment rollback --to-commit abc123

Configuration

Global Settings

# Set default model
augment config set model gpt-4

# Configure context window
augment config set context.window 32000

# Set output preferences
augment config set output.format typescript

# Configure agent behavior
augment config set agent.autonomy high
augment config set agent.review_threshold 0.8

Project Configuration

// .augment/config.json
\\\\{
  "model": "gpt-4-turbo",
  "context": \\\\{
    "include": ["src/**", "tests/**"],
    "exclude": ["node_modules/**", "dist/**"],
    "maxFiles": 1000
  \\\\},
  "agent": \\\\{
    "autonomy": "medium",
    "reviewRequired": true,
    "testGeneration": true
  \\\\},
  "output": \\\\{
    "format": "typescript",
    "style": "prettier",
    "linting": true
  \\\\}
\\\\}

Memories and Rules

# Add coding standards
augment memory add "Always use TypeScript interfaces for data structures"

# Add architectural rules
augment memory add "Use dependency injection for service classes"

# Add testing preferences
augment memory add "Generate Jest tests with 90% coverage minimum"

# List memories
augment memory list

# Remove memory
augment memory remove <memory-id>

Language-Specific Usage

JavaScript/TypeScript

// Augment understands TypeScript context
interface User \\\\{
  id: string;
  email: string;
  role: UserRole;
\\\\}

// Generate service with context
// Prompt: "Create UserService with CRUD operations"
// Augment generates type-safe implementation

Python

# Augment respects Python conventions
from typing import List, Optional
from dataclasses import dataclass

@dataclass
class User:
    id: str
    email: str

# Prompt: "Add user validation methods"
# Augment generates Pythonic code with proper typing

React

// Augment understands React patterns
interface ButtonProps \\\\{
  variant: 'primary'|'secondary';
  onClick: () => void;
\\\\}

// Prompt: "Create reusable Button component with variants"
// Augment generates complete component with TypeScript

Workflow Examples

Feature Development

# 1. Start new feature
augment agent task "Implement user profile management feature"

# 2. Agent analyzes requirements
# 3. Agent creates implementation plan
# 4. Agent generates code across multiple files
# 5. Agent creates tests
# 6. Review and apply changes

augment agent review
augment agent apply

Code Refactoring

# 1. Select code to refactor
# 2. Specify refactoring goal
augment refactor "Extract user validation into separate service"

# 3. Preview changes
augment apply --preview

# 4. Apply refactoring
augment apply

Bug Fixing

# 1. Describe the bug
augment fix "Memory leak in user session management"

# 2. Augment analyzes codebase
# 3. Identifies potential issues
# 4. Suggests fixes
# 5. Apply fixes

augment apply --files src/session.js

Integration Patterns

Git Integration

# Auto-commit agent changes
augment config set git.autoCommit true

# Generate commit messages
augment commit --generate-message

# Create pull requests
augment pr create --title "Feature: User authentication"

# Review PR with Augment
augment pr review --pr-number 123

CI/CD Integration

# GitHub Actions with Augment
name: Augment Code Review
on: [pull_request]

jobs:
  augment-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Setup Augment
        run: npm install -g @augment/cli
      - name: Authenticate
        run: augment auth login --token $\\\\{\\\\{ secrets.AUGMENT_TOKEN \\\\}\\\\}
      - name: Review Changes
        run: augment review --output review.md
      - name: Comment on PR
        uses: actions/github-script@v6
        with:
          script:|
            const fs = require('fs');
            const review = fs.readFileSync('review.md', 'utf8');
            github.rest.issues.createComment(\\\\{
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: review
            \\\\});

Testing Integration

# Generate comprehensive tests
augment test generate --coverage 90

# Run tests with Augment analysis
augment test run --analyze

# Generate test data
augment test data --type integration

# Mock generation
augment test mocks --service UserService

Performance Optimization

Context Management

# Optimize context for large codebases
augment config set context.strategy smart
augment config set context.maxTokens 16000

# Use focused context
augment focus --files src/auth/ --depth 2

# Cache context for faster responses
augment config set cache.enabled true

Agent Efficiency

# Configure agent for speed vs quality
augment config set agent.speed fast
augment config set agent.quality high

# Parallel task execution
augment agent parallel --max-tasks 3

# Resource allocation
augment config set resources.memory 16GB
augment config set resources.timeout 300s

Troubleshooting

Common Issues

# Agent not responding
augment agent status
augment agent restart

# Context issues
augment index --rebuild
augment context clear

# Authentication problems
augment auth refresh
augment auth login --force

# Performance issues
augment cache clear
augment config reset

Debug Mode

# Enable debug logging
augment config set debug true

# View detailed logs
augment logs --level debug

# Export diagnostics
augment diagnostics export --output debug.json

Enterprise Features

Team Management

# Add team members
augment team add user@company.com --role developer

# Manage permissions
augment team permissions --user user@company.com --grant write

# View team usage
augment team usage --month current

# Shared memories and rules
augment team memory sync

Security and Compliance

# Enable audit logging
augment config set audit.enabled true

# Data residency settings
augment config set data.region us-east-1

# Code scanning
augment security scan --output security-report.json

# Compliance reporting
augment compliance report --standard soc2

API Integration

REST API

# Generate code via API
curl -X POST https://api.augmentcode.com/v1/generate \
  -H "Authorization: Bearer $AUGMENT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '\\\\{
    "prompt": "Create user authentication service",
    "context": "typescript,express,jwt",
    "options": \\\\{
      "includeTests": true,
      "format": "typescript"
    \\\\}
  \\\\}'

Webhooks

// Webhook for agent completion
app.post('/augment/webhook', (req, res) => \\\\{
  const \\\\{ event, data \\\\} = req.body;

  if (event === 'agent.task.completed') \\\\{
    console.log('Agent completed task:', data.taskId);
    // Process completed task
  \\\\}

  res.status(200).send('OK');
\\\\});

Resources