예시 - Amazon Q Developer
AWS 전문 사용자 지정 에이전트개발 워크플로 사용자 지정 에이전트코드 검토 사용자 지정 에이전트프로젝트별 사용자 지정 에이전트효과적인 사용자 지정 에이전트를 생성하기 위한 팁

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

예시

이 섹션에서는 일반적인 개발 워크플로 및 사용 사례를 위한 사용자 지정 에이전트 구성의 실제 예를 제공합니다.

AWS 전문 사용자 지정 에이전트

이 사용자 지정 에이전트는 AWS 인프라 관리 및 개발 작업에 최적화되어 있습니다. 관련 설명서를 포함하면서 AWS 도구에 대한 사전 승인된 액세스를 제공합니다.

예 AWS 전문가 사용자 지정 에이전트 구성
{
  "description": "Specialized custom agent for AWS infrastructure and development tasks",
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "use_aws"
  ],
  "allowedTools": [
    "fs_read",
    "use_aws"
  ],
  "toolsSettings": {
    "use_aws": {
      "allowedServices": [
        "s3",
        "lambda",
        "cloudformation",
        "ec2",
        "iam",
        "logs"
      ]
    },
    "fs_write": {
      "allowedPaths": [
        "infrastructure/**",
        "scripts/**",
        "*.yaml",
        "*.yml",
        "*.json"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://infrastructure/**/*.yaml",
    "file://infrastructure/**/*.yml",
    "file://docs/aws-setup.md",
    "file://scripts/deploy.sh"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "aws sts get-caller-identity",
        "timeout_ms": 10000,
        "cache_ttl_seconds": 300
      }
    ]
  }
}

이 사용자 지정 에이전트의 사용 사례:

  • CloudFormation 스택 배포

  • S3 버킷 및 Lambda 함수 관리

  • AWS 서비스 문제 해결

  • 코드형 인프라 검토 및 업데이트

개발 워크플로 사용자 지정 에이전트

이 사용자 지정 에이전트는 코드 검토, 테스트 및 Git 작업을 포함한 일반적인 소프트웨어 개발 작업을 위해 설계되었습니다.

예 개발 워크플로 사용자 지정 에이전트 구성
{
  "description": "General development workflow custom agent with Git integration",
  "mcpServers": {
    "git": {
      "command": "git-mcp-server",
      "args": [],
      "timeout": 30000
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@git"
  ],
  "allowedTools": [
    "fs_read",
    "@git/git_status",
    "@git/git_log",
    "@git/git_diff"
  ],
  "toolAliases": {
    "@git/git_status": "status",
    "@git/git_log": "log",
    "@git/git_diff": "diff"
  },
  "toolsSettings": {
    "fs_write": {
      "allowedPaths": [
        "src/**",
        "tests/**",
        "docs/**",
        "*.md",
        "*.json",
        "package.json",
        "requirements.txt"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://CONTRIBUTING.md",
    "file://docs/**/*.md",
    "file://package.json",
    "file://requirements.txt"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git status --porcelain",
        "timeout_ms": 5000
      },
      {
        "command": "git branch --show-current",
        "timeout_ms": 3000
      }
    ]
  }
}

이 사용자 지정 에이전트의 사용 사례:

  • 코드 검토 및 분석

  • 테스트 작성 및 업데이트

  • Git 워크플로 관리

  • 설명서 업데이트

  • 종속성 관리

코드 검토 사용자 지정 에이전트

이 사용자 지정 에이전트는 코드 품질, 보안 및 모범 사례를 분석하는 데 최적화된 도구 및 컨텍스트를 사용하여 코드 검토 작업에 특히 중점을 둡니다.

예 코드 검토 사용자 지정 에이전트 구성
{
  "description": "Specialized custom agent for code review and quality analysis",
  "tools": [
    "fs_read",
    "execute_bash"
  ],
  "allowedTools": [
    "fs_read",
    "execute_bash"
  ],
  "toolsSettings": {
    "execute_bash": {
      "allowedCommands": [
        "grep",
        "find",
        "wc",
        "head",
        "tail",
        "cat",
        "diff",
        "git diff",
        "git log",
        "eslint",
        "pylint",
        "rubocop"
      ]
    }
  },
  "resources": [
    "file://CONTRIBUTING.md",
    "file://docs/coding-standards.md",
    "file://docs/security-guidelines.md",
    "file://.eslintrc.json",
    "file://.pylintrc",
    "file://pyproject.toml"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "git diff --name-only HEAD~1",
        "timeout_ms": 5000,
        "max_output_size": 2048
      }
    ],
    "userPromptSubmit": [
      {
        "command": "find . -name '*.py' -o -name '*.js' -o -name '*.ts' | wc -l",
        "timeout_ms": 3000,
        "cache_ttl_seconds": 60
      }
    ]
  }
}

이 사용자 지정 에이전트의 사용 사례:

  • 코드 품질에 대한 풀 요청 검토

  • 보안 취약성 식별

  • 코딩 표준 준수 확인

  • 코드 복잡성 및 유지 관리 가능성 분석

  • 개선 사항 제안 및 리팩터링 기회

프로젝트별 사용자 지정 에이전트

이 예제에서는 프로젝트별 도구, 설명서 및 빌드 프로세스를 포함하여 특정 프로젝트에 맞는 사용자 지정 에이전트를 생성하는 방법을 보여줍니다.

예 프로젝트별 사용자 지정 에이전트 구성
{
  "description": "Custom agent for the mobile app backend project",
  "mcpServers": {
    "docker": {
      "command": "docker-mcp-server",
      "args": ["--socket", "/var/run/docker.sock"]
    },
    "database": {
      "command": "postgres-mcp-server",
      "args": ["--connection", "postgresql://localhost:5432/myapp"],
      "env": {
        "PGPASSWORD": "$DATABASE_PASSWORD"
      }
    }
  },
  "tools": [
    "fs_read",
    "fs_write",
    "execute_bash",
    "@docker",
    "@database"
  ],
  "allowedTools": [
    "fs_read",
    "@docker/docker_ps",
    "@docker/docker_logs",
    "@database/query_read_only"
  ],
  "toolAliases": {
    "@docker/docker_ps": "containers",
    "@docker/docker_logs": "logs",
    "@database/query_read_only": "query"
  },
  "toolsSettings": {
    "fs_write": {
      "allowedPaths": [
        "src/**",
        "tests/**",
        "migrations/**",
        "docker-compose.yml",
        "Dockerfile",
        "requirements.txt"
      ]
    },
    "execute_bash": {
      "allowedCommands": [
        "npm test",
        "npm run build",
        "python manage.py test",
        "docker-compose up",
        "docker-compose down"
      ]
    }
  },
  "resources": [
    "file://README.md",
    "file://docs/api-documentation.md",
    "file://docs/database-schema.md",
    "file://docker-compose.yml",
    "file://requirements.txt",
    "file://src/config/settings.py"
  ],
  "hooks": {
    "agentSpawn": [
      {
        "command": "docker-compose ps",
        "timeout_ms": 10000,
        "cache_ttl_seconds": 30
      },
      {
        "command": "git status --porcelain",
        "timeout_ms": 5000
      }
    ]
  }
}

이 사용자 지정 에이전트의 사용 사례:

  • Docker 컨테이너 및 서비스 관리

  • 데이터베이스 쿼리 및 마이그레이션 실행

  • 애플리케이션 구축 및 테스트

  • 프로덕션 문제 디버깅

  • API 설명서 업데이트

효과적인 사용자 지정 에이전트를 생성하기 위한 팁

  • 간단한 시작 - 기본 도구 구성으로 시작하고 필요에 따라 복잡성 추가

  • 설명이 포함된 이름 사용 - 목적을 명확하게 나타내는 사용자 지정 에이전트 이름 선택

  • 관련 컨텍스트 포함 - 리소스에 프로젝트 설명서 및 구성 파일 추가

  • 안전 도구 사전 승인 - allowedTools에 자주 사용되는 위험도가 낮은 도구 포함

  • 동적 컨텍스트에 후크 사용 - 명령 후크를 통해 현재 시스템 상태 포함

  • 도구 범위 제한 - toolsSettings 사용하여 관련 경로 및 서비스에 대한 도구 액세스를 제한합니다.

  • 철저한 테스트 - 사용자 지정 에이전트 구성이 예상대로 작동하는지 확인

  • 사용자 지정 에이전트 문서화 - 명확한 설명을 사용하여 팀원이 사용자 지정 에이전트의 목적을 이해하는 데 도움이 됩니다.