AI와 개발을 쉽게 이해하는 실험실

비개발자도 따라오는 AI 도구, 자동화, 개발 실험 기록

반응형

전체 글 556

AI 자동화가 중간에 멈췄다면 어디를 먼저 볼까

어제까지 잘 돌던 자동화가 오늘은 결과를 안 낼 때, 실행 기록(로그)을 찾는 순서부터 알려드립니다. 도구 이름에 관계없이 쓸 수 있는 점검 순서와 막힐 수 있는 지점을 정리했습니다.결론부터 말하면, 자동화 도구의 "실행 기록(History·Executions·Runs)" 화면을 먼저 엽니다. 여기서 가장 최근 실행 한 건을 클릭하면 몇 번째 단계까지 갔고 어디서 멈췄는지 확인할 수 있습니다. 화면 구성과 표시 방식은 도구마다 다르므로, 정확한 내용은 쓰는 도구의 공식 문서를 함께 확인하세요.멈춘 단계를 찾기 전에는 어떤 수정도 추측입니다. 그래서 순서가 중요합니다.이 글은 특정 도구 매뉴얼이 아닙니다. Zapier·Make·n8n 같은 노코드 자동화 도구(코드를 쓰지 않고 화면에서 블록을 연결해 작업을..

스캔한 계약서 한글이 깨져 나올 때 점검하는 순서

OCR을 돌렸는데 한글 받침이 뭉개지거나 외계어로 나올 때, 인코딩 깨짐과 인식 오류를 먼저 구분하고 한국어 모델 지정·해상도·전처리 순으로 점검하는 방법을 정리했습니다.스캔한 계약서를 OCR(이미지 속 글자를 텍스트로 바꿔주는 기술)로 돌렸는데 "계약"이 "계악"이 되거나 아예 알 수 없는 기호로 나온다면, 점검 순서는 정해져 있습니다.한국어 인식 모델이 실제로 적용됐는지 → 결과 파일의 문자 인코딩 → 원본 이미지 해상도와 전처리 순서입니다. 앞의 두 개는 설정만 바꾸면 되고 되돌리기도 쉬워서 먼저 봅니다. 되돌리기 쉽게 하려면 원본 이미지는 손대지 않고 복사본으로만 작업하고, 출력 파일명을 result_kor, result_kor_eng처럼 단계별로 나눠 저장하세요. 결과가 나빠지면 추가한 옵션(-..

노션 AI 회의록 정리 vs 챗봇 — 선택 기준 4가지

회의록 정리를 노션 AI에 맡길지 ChatGPT 같은 챗봇에 맡길지 고민이라면, 녹취 파일 변환 단계와 문서 보관 방식부터 보면 답이 나옵니다. 같은 작업 순서로 두 도구를 비교하고, 요금과 음성 파일 지원처럼 공식 문서에서 직접 확인해야 하는 항목도 정리했습니다.회의록 정리 도구를 하나로 정하는 기준은 단순합니다. 회의록을 계속 같은 공간에 쌓아두고 나중에 검색할 생각이면 노션 AI, 매번 형식을 바꿔가며 다듬을 생각이면 챗봇이 손이 덜 갑니다.녹취 파일(회의를 녹음한 음성 파일)이 있다면 어느 쪽을 골라도 "음성 → 글자" 변환 단계가 따로 필요한지 먼저 확인해야 합니다. 여기서 손이 가장 많이 갑니다.여기서 말하는 챗봇은 ChatGPT, Claude, Gemini처럼 대화창에 글을 넣으면 답해주는 ..

502 Bad Gateway 원인, 어디부터 확인할까

어제까지 열리던 사이트가 502 Bad Gateway만 띄울 때, 앱 프로세스·포트·타임아웃 순으로 원인을 좁혀가는 점검 순서를 정리했습니다. 비개발자도 따라갈 수 있게 용어 풀이와 로그 확인 위치까지 함께 담았습니다.502 Bad Gateway는 "앞에서 요청을 받아주는 서버는 살아 있는데, 실제로 페이지를 만들어주는 프로그램이 제대로 답을 못 했다"는 신호입니다. 그래서 점검은 내 앱(사이트를 돌리는 프로그램)이 지금 켜져 있는지부터 시작하는 편이 빠릅니다.이 오류는 브라우저 문제도, 인터넷 연결 문제도 아닙니다. 새로고침만으로는 사라지지 않는 경우가 있습니다.아래 순서는 되돌리기 쉬운 점검에서 시작해, 손을 많이 대야 하는 쪽으로 내려갑니다.목차먼저 3분 안에 확인할 것앱이 켜져 있는지 확인하기로그..

서드파티 콘텐츠 유사성 오류, 프롬프트에서 뭘 빼야 할까

ChatGPT 이미지 생성에서 서드파티 콘텐츠와의 유사성 방지 조치 위반 안내가 뜰 때, 프롬프트에서 먼저 빼야 할 표현과 원하는 분위기를 살리면서 우회하지 않고 다시 요청하는 방법을 정리했습니다."서드파티 콘텐츠와의 유사성 방지 조치 위반"이라는 안내가 뜬다면, 프롬프트에서 고유명사부터 빼는 것이 첫 수정입니다. 캐릭터 이름, 작품 제목, 브랜드명, 특정 작가·스튜디오 이름이 여기 해당합니다.이 안내는 요청 내용이 다른 회사·창작자의 저작물과 비슷한 결과로 이어질 수 있다고 판단됐을 때 나옵니다. 계정에 문제가 생긴 게 아니고, 재시도 버튼을 반복해서 누른다고 해서 보통 달라지지 않습니다.원하는 분위기를 포기할 필요는 없습니다. 이름을 지우고 그 이름이 떠올리게 하는 시각적 특징을 직접 묘사하면 되는 ..

Claude API 비용 절감 — 토큰 새는 지점부터 점검

Claude API 요금이 예상보다 많이 나왔을 때, 콘솔 사용량으로 청구액을 쪼개고 토큰이 새는 지점(시스템 프롬프트 반복, 대화 전체 재전송, max_tokens 과대)을 찾아 줄이는 점검 순서를 정리했습니다.청구액을 먼저 쪼개는 것이 순서입니다. Anthropic 콘솔의 사용량(Usage) 화면에서 모델별·날짜별 입력/출력 토큰을 확인하면, 요금이 어느 모델과 어느 시점에 몰렸는지가 드러납니다. 코드를 고치는 건 그 다음입니다.여기서 말하는 API는 챗봇 화면 대신 프로그램이 직접 Claude에 요청을 보내는 통로입니다. 쓴 만큼 계산되기 때문에 "한 번 호출에 글자가 몇 개 오갔는지"가 곧 돈입니다.💡 이 글에는 할인율·단가 같은 숫자를 적지 않았습니다. 요금 표와 프롬프트 캐싱·배치 처리의 할..

ChatGPT 앱 실행 안 될 때 — 창이 바로 닫히면 볼 세 곳

ChatGPT 데스크톱 앱 아이콘을 눌러도 창이 잠깐 떴다 사라질 때, 되돌리기 쉬운 순서대로 확인할 세 곳을 정리했습니다. 완전 종료·OS 요구사항·재설치까지 단계별로 짚고, 그 사이 웹 버전으로 작업을 이어가는 방법도 함께 다룹니다.창이 떴다 바로 닫히는 증상은 ① 백그라운드에 남은 앱 프로세스 완전 종료 → ② 운영체제 버전이 앱 요구사항을 만족하는지 확인 → ③ 앱 삭제 후 재설치 순서로 점검합니다. 앞의 두 가지는 파일을 지우지 않으니 되돌리기 쉽고, 재설치는 마지막에 두는 편이 안전합니다.세 곳 모두 지나도 안 열린다면 브라우저에서 chat.openai.com에 접속해 작업을 먼저 이어가면 됩니다. 앱이 없어도 대화 내용은 계정에 남습니다.목차먼저: 앱을 "완전히" 종료하고 다시 실행두 번째:..

AI 답변 일관성: 형식이 매번 달라질 때 프롬프트에 고정하기

같은 프롬프트로 주간 보고서를 만드는데 형식이 매번 달라진다면, 출력 틀과 입력 범위, 판단 규칙을 프롬프트 안에 고정하면 결과 모양을 맞출 수 있습니다. 바로 복사해 쓸 수 있는 템플릿과 확인 체크리스트를 정리했습니다.같은 프롬프트를 넣었는데 이번엔 표로, 다음엔 줄글로 나옵니다. 제목 순서도 바뀝니다. 이럴 때 손봐야 하는 건 지시문의 말투가 아니라 출력 틀·입력 범위·판단 규칙입니다.이 세 가지를 프롬프트 안에 문자로 못 박아두면 매주 바뀌는 건 내용뿐이고 모양은 그대로 유지됩니다. 아래 순서대로 첫 번째 것만 붙여도 체감이 큽니다.목차출력 틀을 프롬프트에 그대로 붙여넣기입력 자료의 범위를 못 박기애매한 판단을 미리 결정해두기세 가지를 하나로 합친 프롬프트 구조잘 고정됐는지 확인하는 방법자주 막히는..

AI 크롤러만 차단하고 검색 노출은 남기는 설정법

블로그 글이 AI 학습에 쓰이는 건 막고 검색 유입은 유지하고 싶을 때, robots.txt에서 크롤러 이름 단위로 나눠 차단하는 방법과 이 방식으로 막히지 않는 부분, 적용 후 확인 절차를 정리했습니다.AI 학습용 수집과 검색용 수집은 대체로 서로 다른 이름(User-agent)으로 사이트에 들어옵니다. 그래서 robots.txt에서 이름을 지정해 학습용만 거부하면 검색 노출은 그대로 두는 방향이 가능합니다.단, 이건 "요청"입니다. 강제 차단이 아니고, 특정 업체의 크롤러 이름과 그 이름이 검색용인지 학습용인지는 각 업체 공식 문서에서 직접 확인해야 합니다. 이름은 바뀌기도 합니다.목차먼저 넣어볼 robots.txt 기본 형태차단할 크롤러 이름은 이렇게 확인합니다플랫폼별로 파일을 어디서 고치나이 설정..

zsh: command not found: npm 맥에서 해결하는 순서

맥 터미널에서 zsh: command not found: npm 메시지가 나오면 Node.js가 설치되지 않았거나 경로 설정이 빠진 경우입니다. 설치 여부 확인부터 공식 설치 파일, Homebrew, nvm 방식까지 순서대로 짚어봅니다.맥 터미널에 zsh: command not found: npm이 떴다면, 거의 대부분 npm이 들어 있는 Node.js가 아직 설치되지 않았거나, 설치는 됐지만 터미널이 그 위치를 못 찾는 상태입니다. 둘 중 어느 쪽인지는 명령 한 줄로 갈라집니다.용어를 먼저 짧게 풀어둡니다. 터미널은 맥에 기본으로 들어 있는, 검은 화면에 명령어를 입력하는 프로그램(Launchpad에서 "터미널" 검색)입니다. zsh는 그 터미널이 명령어를 받아 처리하는 프로그램이고, command n..

반응형