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
| Comando | Atalho | Descrição |
|---|---|---|
Augment: Generate Code | Ctrl+Shift+G | Gerar código a partir de prompt |
Augment: Explain Code | Ctrl+Shift+E | Explicar código selecionado |
Augment: Refactor | Ctrl+Shift+R | Refatorar código selecionado |
Augment: Add Tests | Ctrl+Shift+T | Gerar testes para código |
Augment: Fix Issues | Ctrl+Shift+F | Corrigir problemas de código |
Augment: Start Agent | Ctrl+Shift+A | Iniciar 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');
\\\\});