wiki:it:wiki:gemini_api_setup
차이
문서의 선택한 두 판 사이의 차이를 보여줍니다.
| 양쪽 이전 판이전 판 | |||
| wiki:it:wiki:gemini_api_setup [2025/08/01 12:10] – syjang0803 | wiki:it:wiki:gemini_api_setup [2025/08/01 12:40] (현재) – syjang0803 | ||
|---|---|---|---|
| 줄 1: | 줄 1: | ||
| ====== Gemini API 설정 가이드 ====== | ====== Gemini API 설정 가이드 ====== | ||
| - | 이 문서는 DokuWiki에서 Gemini API를 사용하기 위한 설정 방법을 | + | 이 문서는 DokuWiki에서 Gemini API를 사용하여 AI 기반 콘텐츠 생성 및 편집 기능을 활용하기 위한 상세한 설정 방법을 |
| ===== 1. API 키 발급 ===== | ===== 1. API 키 발급 ===== | ||
| ---- | ---- | ||
| - | ==== 1) Google AI Studio 접속 ==== | + | ==== 1) Google AI Studio 접속 |
| - | * https:// | + | * **Google AI Studio 접속**: 웹 브라우저를 열고 다음 주소로 이동합니다: |
| - | * Google 계정으로 로그인 | + | |
| - | * Get API key 버튼 클릭 | + | * **API 키 생성 시작**: 페이지 중앙 또는 좌측 메뉴에서 '' |
| - | * 새 API 키 생성 | + | |
| + | * **생성된 키 복사**: 화면에 표시되는 API 키를 즉시 복사하여 안전한 곳에 임시로 보관합니다. 이 키는 DokuWiki 설정에 사용됩니다. | ||
| ---- | ---- | ||
| - | ==== 2) API 키 보안 ==== | + | ==== 2) API 키 보안 |
| - | * API 키는 | + | * **절대 코드에 하드코딩 |
| - | * DokuWiki 설정 관리자에서만 입력 | + | |
| - | * 정기적으로 키를 재발급하여 보안 강화 | + | |
| + | * **키 유출 방지**: API 키는 개인 정보와 같이 취급하여 외부에 노출되지 않도록 각별히 주의해야 합니다. | ||
| ===== 2. DokuWiki 설정 ===== | ===== 2. DokuWiki 설정 ===== | ||
| 줄 25: | 줄 27: | ||
| ==== 1) 관리자 페이지 접속 ==== | ==== 1) 관리자 페이지 접속 ==== | ||
| - | * DokuWiki에 관리자 계정으로 로그인 | + | * **DokuWiki 로그인**: |
| - | * 오른쪽 상단 '' | + | * **관리(Admin) 버튼 클릭**: DokuWiki 페이지의 |
| - | * '' | + | * **설정 관리자 선택**: 관리 메뉴에서 |
| ---- | ---- | ||
| - | ==== 2) API 키 입력 ==== | + | ==== 2) API 키 입력 |
| - | * 페이지를 아래로 스크롤 | + | * **설정 섹션 탐색**: 설정 관리자 |
| - | * '' | + | * **API 키 입력 필드**: |
| - | * '' | + | * **설정 저장**: 키 입력 후, 페이지 하단에 있는 |
| - | * '' | + | |
| - | ===== 3. 플러그인 활성화 ===== | + | ===== 3. 플러그인 활성화 |
| ---- | ---- | ||
| - | ==== 1) 플러그인 확인 ==== | + | ==== 1) 플러그인 |
| - | * '' | + | * **확장 기능 관리자 접속**: DokuWiki |
| - | * '' | + | |
| - | * 플러그인이 자동으로 인식되어야 함 | + | * **설치되지 않은 경우**: 만약 '' |
| ---- | ---- | ||
| - | ==== 2) 기능 | + | ==== 2) 기능 |
| - | * 아무 | + | * **편집 페이지로 이동**: 임의의 DokuWiki |
| - | * 편집기 툴바에 파란색 '' | + | * **AI 초안 생성 버튼 확인**: |
| - | * 녹색 '' | + | * **AI 수정 버튼 확인**: |
| ===== 4. 사용법 가이드 ===== | ===== 4. 사용법 가이드 ===== | ||
| ---- | ---- | ||
| - | ==== 1) AI 초안 생성 ==== | + | ==== 1) AI 초안 생성 |
| - | * 편집기에 초안을 만들고 싶은 내용 | + | * **초안 내용 입력**: DokuWiki |
| - | * 파란색 '' | + | * **초안 생성 버튼 클릭**: |
| - | * AI가 상세한 DokuWiki 문서로 확장 | + | * **결과 확인 및 수정**: |
| - | * 결과를 확인하고 필요시 수정 | + | |
| ---- | ---- | ||
| - | ==== 2) AI 텍스트 수정 ==== | + | ==== 2) AI 텍스트 수정 |
| - | * 수정하고 싶은 텍스트를 드래그하여 선택 | + | |
| - | * 녹색 '' | + | * **AI 수정 버튼 클릭**: |
| - | * 수정 지시사항 입력 | + | |
| - | * 선택된 텍스트가 수정된 내용으로 | + | * **예시**: |
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | * '' | ||
| + | * **수정된 내용 확인**: AI가 지시사항에 따라 | ||
| ===== 5. 사용량 관리 ===== | ===== 5. 사용량 관리 ===== | ||
| ---- | ---- | ||
| - | ==== 1) 무료 사용량 ==== | + | ==== 1) Gemini API 무료 사용량 |
| - | | + | Gemini API는 Google의 무료 사용량 정책을 따르며, 다음과 같은 제한이 적용됩니다: |
| - | * 일일 | + | |
| - | * 제한 도달 | + | * **분당 호출 제한**: 분당 최대 10회 API 호출이 가능합니다. |
| + | | ||
| + | * **기능 자동 차단**: 이러한 | ||
| ---- | ---- | ||
| - | ==== 2) 사용량 확인 ==== | + | ==== 2) DokuWiki 내 사용량 확인 ==== |
| + | |||
| + | DokuWiki 플러그인은 사용량 제한을 추적하기 위해 특정 파일을 사용합니다. | ||
| - | * '' | + | * **일일 사용량 로그**: |
| - | * '' | + | * **분당 사용량 로그**: |
| - | * 파일 내용으로 | + | * **로그 |
| ===== 6. 문제 해결 ===== | ===== 6. 문제 해결 ===== | ||
| ---- | ---- | ||
| - | ==== 1) 일반적인 오류 ==== | + | ==== 1) 일반적인 오류 |
| ---- | ---- | ||
| === cURL 함수 없음 === | === cURL 함수 없음 === | ||
| + | |||
| + | 이 오류는 서버에 PHP cURL 확장이 설치되어 있지 않거나 활성화되지 않았을 때 발생합니다. cURL은 DokuWiki가 Gemini API 서버와 통신하는 데 필요한 라이브러리입니다. | ||
| < | < | ||
| 줄 100: | 줄 111: | ||
| **해결 방법:** | **해결 방법:** | ||
| + | * **PHP cURL 설치**: 서버 운영체제에 따라 다음 명령어를 사용하여 cURL 확장을 설치합니다. (예시: Ubuntu/ | ||
| < | < | ||
| sudo apt-get update | sudo apt-get update | ||
| sudo apt-get install php-curl | sudo apt-get install php-curl | ||
| - | sudo systemctl restart apache2 | + | </ |
| + | * **웹 서버 재시작**: | ||
| + | < | ||
| + | sudo systemctl restart apache2 | ||
| + | sudo systemctl restart nginx // Nginx의 경우 | ||
| </ | </ | ||
| ---- | ---- | ||
| === API 키 미설정 === | === API 키 미설정 === | ||
| + | |||
| + | Gemini API 키가 DokuWiki 설정에 올바르게 입력되지 않았을 때 나타나는 오류입니다. | ||
| < | < | ||
| 줄 115: | 줄 132: | ||
| **해결 방법:** | **해결 방법:** | ||
| - | * DokuWiki 설정 관리자에서 API 키 입력 | + | |
| - | * 키가 올바르게 저장되었는지 확인 | + | * **오타 및 공백 확인**: |
| ---- | ---- | ||
| === 사용량 초과 === | === 사용량 초과 === | ||
| + | |||
| + | Gemini API의 일일 또는 분당 호출 제한에 도달했을 때 발생하는 오류입니다. | ||
| < | < | ||
| 줄 126: | 줄 145: | ||
| **해결 방법:** | **해결 방법:** | ||
| - | * 다음 | + | |
| - | * 또는 사용량 | + | * **로그 파일 삭제 (임시 해결)**: '' |
| ---- | ---- | ||
| === 네트워크 오류 === | === 네트워크 오류 === | ||
| + | |||
| + | DokuWiki 서버가 Gemini API 엔드포인트에 접속하지 못할 때 발생하는 오류입니다. | ||
| < | < | ||
| 줄 137: | 줄 158: | ||
| **해결 방법:** | **해결 방법:** | ||
| - | * 인터넷 연결 상태 확인 | + | |
| - | * API 키 유효성 확인 | + | |
| - | * 방화벽 설정 확인 | + | |
| + | * **프록시 설정**: DokuWiki 서버가 프록시 서버를 통해 인터넷에 접속해야 하는 환경이라면, | ||
| - | ===== 7. 성능 | + | ===== 7. AI 활용 |
| ---- | ---- | ||
| - | ==== 1) 프롬프트 개선 ==== | + | ==== 1) 프롬프트 개선을 통한 결과물 향상 |
| - | | + | AI로부터 더 유용하고 정확한 결과물을 얻기 위해서는 ' |
| - | * 원하는 결과물의 형식 명시 | + | |
| - | * 예시나 참고 자료 제공 | + | * **구체적이고 명확한 지시사항**: AI에게 무엇을 원하는지 모호함 없이 구체적으로 지시해야 합니다. |
| + | * | ||
| + | | ||
| + | * **페르소나 지정**: AI가 특정 역할(예: 전문 작가, 기술 블로거)을 수행하여 응답하도록 지시할 수 있습니다. | ||
| + | * **예시 또는 | ||
| + | * **제약 조건 명시**: 길이 제한, 특정 용어 사용 금지 등 AI의 응답에 대한 제약 조건을 명시합니다. | ||
| ---- | ---- | ||
| - | ==== 2) 사용량 절약 ==== | + | ==== 2) 스마트한 |
| + | |||
| + | 무료 사용량 제한 내에서 효율적으로 Gemini API를 활용하는 방법입니다. | ||
| - | * 불필요한 호출 최소화 | + | |
| - | * 결과물을 재사용하여 중복 작업 방지 | + | |
| - | * 정기적으로 | + | |
| ===== 8. 관련 링크 ===== | ===== 8. 관련 링크 ===== | ||
| - | * [[wiki: | + | * [[wiki: |
| - | * [[wiki: | + | * [[wiki: |
| - | * [[wiki: | + | * [[wiki: |
| - | * [[wiki: | + | * [[wiki: |
| + | * [[https:// | ||
| + | * [[https:// | ||
wiki/it/wiki/gemini_api_setup.1754050228.txt.gz · 마지막으로 수정됨: 저자 syjang0803