AI 에이전트
Sidian의 AI 에이전트는 코드를 작성, 이해 및 리팩토링하는 데 도움을 주는 지능형 어시스턴트입니다. 이 가이드는 AI 에이전트와 상호 작용하고 그들의 능력을 활용하여 개발 프로세스를 향상시키는 방법을 설명합니다.
AI 에이전트 개요
Sidian은 개발의 다양한 측면을 지원하기 위해 여러 전문 AI 에이전트를 제공합니다:
코드 어시스턴트
- 코드 완성 및 제안
- 함수 및 클래스 생성
- 코드 리팩토링 지원
- 버그 감지 및 수정
설명 에이전트
- 코드 설명 및 문서화
- 알고리즘 분석
- 아키텍처 통찰력
- 학습 추천
AI 에이전트와 상호 작용하기
Sidian의 AI 에이전트와 상호 작용하는 여러 가지 방법이 있습니다:
채팅 인터페이스
- 사이드바에서 AI 채팅 패널을 엽니다
- 자연어로 질문이나 요청을 입력합니다
- AI가 현재 코드를 기반으로 문맥에 맞는 응답을 제공합니다
- 명확화를 위해 추가 질문으로 후속 조치합니다
인라인 지원
- 코드를 선택하고 Ctrl+Shift+L을 눌러 설명을 확인합니다
- 코드에서 마우스 오른쪽 버튼을 클릭하여 컨텍스트 메뉴 옵션을 사용합니다
- 빠른 AI 작업을 위해 키보드 단축키를 사용합니다
- 오류 위에 마우스를 올려 AI 기반 수정 제안을 확인합니다
프로 팁: AI 에이전트는 가져온 라이브러리, 코딩 패턴 및 프로젝트 구조를 포함하여 프로젝트 컨텍스트를 이해합니다. 이를 통해 더 정확하고 관련성 있는 지원이 가능합니다.
에이전트 기능
코드 생성
- 함수 생성: 원하는 것을 설명하면 완전한 함수를 얻을 수 있습니다
- 클래스 스캐폴딩: 메서드와 속성이 있는 클래스 구조를 생성합니다
- 테스트 생성: 기존 코드에 대한 단위 테스트를 만듭니다
- 문서화: 주석과 문서를 생성합니다
코드 분석
- 버그 감지: 코드의 잠재적인 문제를 식별합니다
- 성능 최적화: 더 나은 성능을 위한 개선 사항을 제안합니다
- 보안 분석: 보안 취약점을 찾습니다
- 코드 품질: 모범 사례와 패턴을 추천합니다
리팩토링 지원
- 메서드 추출: 큰 함수를 분해합니다
- 변수 이름 변경: 파일 전체에서 일관된 이름 지정
- 가져오기 정리: 가져오기를 정리하고 최적화합니다
- 코드 서식: 일관된 스타일을 적용합니다
모범 사례
효과적인 커뮤니케이션
- 구체적으로: 명확하고 상세한 요청을 제공합니다
- 컨텍스트 포함: 프로그래밍 언어와 프레임워크를 언급합니다
- 후속 질문: 명확화를 위해 주저하지 말고 질문합니다
- 예시 제공: 달성하려는 것을 보여줍니다
코드 리뷰
- 항상 리뷰: 리뷰 없이 AI가 생성한 코드를 절대 수락하지 마십시오
- 철저한 테스트: 테스트를 실행하고 기능을 확인합니다
- 변경 사항 이해: AI가 무엇을 했는지 확실히 이해합니다
- 스타일 유지: 코드베이스와의 일관성을 보장합니다
개인 정보 보호 및 보안
- 민감한 데이터: 독점적이거나 민감한 코드에 주의하십시오
- API 키: API 키나 자격 증명을 절대 공유하지 마십시오
- 제안 검토: AI 제안의 보안 영향을 확인합니다
- 로컬 처리: 민감한 프로젝트에는 오프라인 모드를 사용합니다
고급 기능
사용자 정의 프롬프트
일반적인 작업을 위해 재사용 가능한 프롬프트를 만듭니다:
// API 엔드포인트 생성을 위한 사용자 정의 프롬프트
"Express.js와 MongoDB를 사용하여 [리소스]에 대한 CRUD 작업이 포함된 REST API 엔드포인트를 만들어줘"컨텍스트 관리
- 파일 컨텍스트: AI는 현재 파일 및 관련 파일을 고려합니다
- 프로젝트 컨텍스트: 프로젝트 구조 및 종속성에 대한 이해
- 히스토리 컨텍스트: 이전 대화가 현재 응답에 영향을 미칩니다
- 선택 컨텍스트: 대상 지원을 위해 선택한 코드에 집중합니다
모델 선택
작업에 적합한 AI 모델을 선택하십시오:
- 빠른 모델: 간단한 작업에 대한 빠른 응답
- 고급 모델: 복잡한 추론 및 코드 생성
- 특수 모델: 언어별 또는 도메인별 모델
- 로컬 모델: 개인 정보 보호에 중점을 둔 오프라인 처리
문제 해결
일반적인 문제
AI가 응답하지 않음
- 클라우드 모델의 경우: 인터넷 연결을 확인하십시오
- 로컬 모델의 경우: Ollama/LM Studio가 실행 중인지 확인하십시오
- 계정 상태 및 구독을 확인하십시오
- AI 연결을 새로 고쳐보십시오
부정확한 제안
- 요청에 더 많은 컨텍스트를 제공하십시오
- 요구 사항에 대해 더 구체적으로 설명하십시오
- 질문을 다른 방식으로 표현해보십시오
- 다른 AI 모델을 사용해보십시오
성능 문제
- 불필요한 파일과 탭을 닫으십시오
- AI 대화 기록을 지우십시오
- 더 빠른 AI 모델로 전환하십시오
- 시스템 리소스를 확인하십시오
도움 받기
- 문서: 포괄적인 가이드 및 튜토리얼
- 지원: Sidian 팀의 직접적인 지원
- 피드백: 문제를 보고하고 개선 사항을 제안합니다
Sidian의 AI 에이전트는 코딩 동반자가 되어 더 나은 코드를 더 빨리 작성하고, 그 과정에서 배우고 기술을 향상시키는 데 도움을 주도록 설계되었습니다.