런북
모델이 즉흥적으로 행동하지 않도록 웹사이트 백링크를 찾는 런북
도구 접근 권한은 일의 절반입니다. 나머지 절반은 어시스턴트가 수행한 작업을 보고하고, 도구가 '아니요'라고 할 때 멈추게 하는 시스템 프롬프트입니다.
SEO AI Pal 연구팀 ·

방지하려는 실패부터 시작하세요
도구 결과가 누락될 때 어시스턴트는 종종 그 공백을 그럴듯한 내용으로 채웁니다. 사용 가능한 데이터 없이 웹사이트 백링크를 찾도록 요청하면, 응답은 실제 결과처럼 깔끔하게 보일 수 있습니다. 어조는 동일합니다. 아래 프롬프트의 각 줄은 이러한 공백을 하나씩 막습니다.
프롬프트를 주문처럼 사용하지 말고 런북으로 대하세요. 각 번호가 붙은 규칙은 실제 상황에서 문제가 되는 부분에 매핑됩니다. 누락된 호출이 먼저 나오고, 이어 조용한 재시도, 채팅 초기에 기억된 숫자, 마지막으로 월간 갱신에 대한 부재가 있습니다.
시스템 프롬프트, 여섯 가지 규칙
그대로 붙여넣은 후, 노출된 작업 이름에 맞게 작업 이름을 수정하세요.
You answer backlink questions ONLY from tool results.
1. For any question about links, call the tool. Never answer from memory.
2. After each call, print the `ok` value and the `_credits` remaining.
3. If ok is false, or the status is 401 or 402, say that in one line
and stop. Do not retry more than once.
4. Name the action you used (overview, refdomains, anchors, toppages).
5. The data is refreshed about monthly. Mention it when a link is missing.
6. Never state a number you did not receive in this chat.결정 테이블: 어시스턴트가 각 결과로 수행할 작업
| 반환된 결과 | 올바른 응답 | 잘못된 응답 |
|---|---|---|
ok가 true이고 행이 존재함 | 행을 요약하고 _credits를 인용하세요. | 기억에 의존한 '약' 숫자를 추가하세요. |
ok가 true이고 행이 0개임 | 해당 도메인에 대한 인덱스에 아직 데이터가 없다고 말하세요. 철자 확인과 월간 갱신을 권장하세요. | 해당 도메인에 백링크가 전혀 없다고 말하세요. |
| HTTP 401 | 누락되거나 잘못된 키를 보고하고 종료하세요. | 임의로 만든 키로 재시도하세요. |
| HTTP 402 | 크레딧이 소진되었음을 보고하고 무료 overview를 제안하세요. | 사이트가 다운되었다고 주장하세요. |
| 타임아웃, JSON 없음 | 호출이 실패했다고 말하고 숫자는 제공하지 마세요. | 응답이 아마도 무엇을 포함하고 있었을지 설명하세요. |

프롬프트가 데이터를 보유할 수 없는 이유
프롬프트는 채팅에 대한 규칙을 설정합니다. 데이터 소스가 아닙니다. 아래 세 가지는 사람들이 실수하는 지점을 다루며, 각각 해결책으로 끝납니다.
프롬프트는 숫자가 아닌 규칙을 보유합니다
어떤 사람들은 JSON 파일을 프롬프트에 붙여넣고 모든 새로운 질문에서 이를 사용하기를 기대합니다. 프롬프트는 채팅에 대한 규칙을 설정할 뿐 데이터베이스가 아닙니다. 숫자가 중요하다면 가져오세요. 어시스턴트는 매번 호출을 수행해야 합니다.
기억이 아닌 호출을 인용하세요. 위의 규칙은 이미 이를 명시하고 있으며, 호출을 인용하는 응답은 검증하기 쉽습니다. 커스텀 GPT 설정에서 이러한 규칙이 어디에 위치하는지 확인할 수 있습니다.
API가 작동하는 곳에서는 스크래핑이 중단됨
일부 사람들은 결과 페이지에서 동일한 숫자를 가져올 수 있는지 묻습니다. 페이지 스크래핑은 레이아웃이 변경될 때까지 작동합니다. 레이아웃은 변경됩니다. 그러면 스크립트는 아무것도 반환하지 않거나 잘못된 열을 반환합니다.
API 호출은 매번 동일한 필드를 반환하므로 프롬프트에서 이를 명명할 수 있습니다. 월요일에 스크래퍼를 테스트하고 목요일에 고장 난다고 가정해 보세요. 이는 유지보수 작업입니다. 백링크 읽기가 아니며 채팅은 차이를 알지 못합니다. 동료가 스크래핑을 고집한다면, 기대하는 레이아웃과 확인할 날짜를 명명하게 하세요. 그것이 없으면 누구도 고장에 대한 책임을 지지 않습니다.
조용한 실패와 벤더 업데이트
모델은 변경되고, 이를 감싸는 제품도 변경됩니다. 한 버전에서 작동하던 규칙은 다음 버전에서 어긋날 수 있습니다. 이를 알리는 소리는 없습니다. 치료법은 지루합니다: 아래 테스트 세트를 유지하고 변경 후 다시 실행하세요.
동일한 세 도메인과 동일한 세 질문을 유지하세요. 영수증 인쇄가 중단되면 어긋짐이 프롬프트나 모델에 있습니다. 첫 번째 잘못된 응답에 날짜를 기록하세요. 변경 이력이 그 주에 무엇이 변경되었는지 보여줍니다.
주간 통과, 다섯 가지 단계
매주 동일한 다섯 단계를 동일한 어조로 실행하여 차이가 데이터에서 비롯되도록 하세요.
- 1
이미 알고 있는 세 도메인을 선택하세요
자신의 사이트, 경쟁사 하나, 대형 사이트 하나입니다. 각 사이트가 어떻게 보일지 대략 알고 있어야 합니다.
- 2
동일한 세 질문을 하세요
평가, 상위 참조 도메인, 앵커 텍스트. 매주 동일한 어조를 사용하여 차이가 데이터에서 비롯되도록 하세요.
- 3
영수증을 확인하세요
각 응답은 작업 이름을 명시하고
_credits를 출력해야 합니다. 영수증이 없으면 테스트 실패입니다. - 4
curl로 하나의 숫자를 무작위 점검하세요
curl "https://seoaipal.com/api.php?action=refdomains&q=example.com&per=10&key=sk_live_..."를 실행하고 첫 번째 행을 비교하세요. 2개의 크레딧이 필요합니다. - 5
어긋난 내용을 기록하세요
프롬프트가 규칙을 무시하기 시작했다면 해당 규칙을 강화하세요. 규칙을 더 추가하지 마세요.
프롬프트를 조용히 깨뜨리는 세 가지 습관
긴 채팅에서 모델은 첫 번째 메시지보다 최근 텍스트에 더 의존합니다. 상단의 규칙이 흐려집니다. 각 클라이언트마다 새 채팅을 시작하세요.
다른 벤더의 숫자 스크린샷을 동일한 대화에 붙여넣는다고 가정해 보세요. 모델은 두 소스를 혼합할 수 있으며 이후 분리할 수 없게 됩니다. 채팅당 하나의 소스를 유지하세요.
약간의 칭찬이 해를 끼칠 수 있습니다. 숫자가 기대한 것과 일치한다고 모델에게 알려주면 다음 응답이 같은 방향으로 기울어지도록 가르치게 됩니다. 숫자가 이상해 보이면 중립적으로 말하세요. 작업 이름을 요청하세요. 응답이 잘못되면 오류 테이블이 그 원인이 프롬프트, 키 또는 데이터 중 어디에 있는지 알려줍니다.
프롬프트를 팀에 전달하기 전
- 프롬프트 상단에 버전과 날짜를 넣으세요.
- 규칙에 명명된 모든 작업이 스키마에 존재하는지 확인하세요.
- 세 도메인 테스트를 실행하고 문체보다 영수증을 읽으세요.
- 각 팀원에게 채팅을 하나씩 제공하되, 채팅당 하나의 데이터 소스를 유지하세요.
- 누락된 링크가 부인되는 대신 설명되도록 월간 갱신 노트를 추가하세요.

노트에 넣어야 할 날짜
코드에 태그를 붙이듯 프롬프트 상단에 버전과 날짜(예: 2026-10-29)를 넣으세요. 그러면 3월에 응답이 이상할 때 어떤 어조가 이를 생성했는지 알 수 있습니다.
링크 조언도 구글과 함께 변화합니다. 2024년 3월 코어 업데이트와 2025년 8월 스팸 업데이트는 사람들이 링크에 대해 묻는 것을 모두 변화시켰으며, 그 이전에 작성된 프롬프트는 더 이상 유효하지 않은 가정들을 포함하고 있었습니다. 규칙을 연 두 번 검토하세요.
프롬프트 옆에 짧은 변경 이력을 유지하세요. 변경당 세 줄이면 충분합니다. 이는 미스터리를 diff로 바꿉니다.
테스트 세트를 작고 지루하게 유지하세요
주간 통과 테스트 세트가 동일하게 유지될 때만 작동합니다. 한 번 선택하고 기록한 후, 결과가 이상해 보일 때 도메인을 바꾸는 충동을 참고하세요.
눈으로 판단할 수 있는 도메인을 선택하세요
자신의 사이트가 첫 번째 선택입니다. 링크를 누구보다 잘 알기 때문입니다. 밀접하게 추적하는 경쟁사가 두 번째입니다. 매우 큰 사이트가 유용한 세 번째입니다. 그 규모는 판단하기 쉽습니다.
새로운 도메인을 테스트로 피하세요. 숫자가 노이즈가 많습니다. 답변의 어긋남은 거의 알려주지 않습니다. 역사가 보이는 사이트를 선택하세요. 손으로 링크를 읽은 적이 있는 사이트를 포함하세요. 이는 기준 진실입니다.
동일한 세 질문을 동일한 어조로 하세요
어조를 고정하세요. 평가, 상위 참조 도메인, 앵커 텍스트를 매주 동일한 방식으로 질문하세요. 어조를 변경하면 답변이 달라지며, 데이터가 변했는지 질문이 변했는지 알 수 없게 됩니다.
세 응답을 프롬프트 옆에 일반 텍스트로 저장하세요. 한 달 후, 나란히 비교하면 채팅이 어땠는지에 대한 기억보다 더 많은 것을 알려줄 것입니다.
실행 전에 테스트 비용을 책정하세요
테스트의 각 유료 호출은 크레딧을 소모하므로 테스트에도 비용이 있습니다. 평가는 무료이므로 도메인당 두 개의 유료 질문이 남습니다.
세 도메인과 두 개의 유료 질문은 2개의 크레딧을 소모하는 6회 호출로 이어지며, 주간 통과 비용은 12크레딧, 약 $0.0012입니다. 이 수치를 테스트 시트에 기록하고 월 한 번 잔액과 대조하세요.
테스트 실패 시 조치
실패한 테스트는 정보입니다. 마지막에 수정하세요. 먼저 영수증을 확인한 후 상태 코드를, 그 다음 도메인 철자를 확인하세요. 이 세 가지를 거친 후에야 규칙을 수정하세요.
한 번에 하나의 규칙만 변경하세요. 동시에 두 가지를 편집하면 다음 실패를 설명할 수 없게 됩니다.
실패한 응답도 유지하세요. 날짜와 변경한 규칙과 함께 변경 이력에 붙여넣으세요. 그 기록은 실제 수정인지 다음 실행에서의 운 좋은 응답인지 구분하는 유일한 방법입니다.
팀에서 이 프롬프트에 대해 묻는 질문
토큰을 절약하기 위해 규칙을 줄일 수 있나요?
줄일 수 있지만 규칙이 아닌 단어를 잘라내세요. 각 번호가 붙은 줄은 상상할 수 있는 실패를 하나 막습니다. 같은 말을 하는 두 줄을 병합하세요. 영수증 규칙은 그대로 두세요.
프롬프트가 데이터를 읽는 것을 대체하나요?
아니요. 어시스턴트가 읽은 내용을 보고하도록 만듭니다. 평가와 참조 도메인 목록은 여전히 당신의 시선이 필요합니다. 특히 숫자가 놀라울 때 더욱 그렇습니다.
어시스턴트가 먼저 시도해야 할 작업은 무엇인가요?
무료인 overview로 시작하고 목록이 필요할 때 refdomains로 이동하세요. 평가와 링크는 다른 질문에 답하므로 하나의 호출로 둘을 모두 커버할 수 없습니다.
주간 통과 비용은 얼마인가요?
위의 테스트 세트를 사용하면 세 도메인당 두 개의 유료 질문으로 인해 약 12크레딧이 사용됩니다. 이는 작은 수이지만 월 잔액 확인에 기준선을 제공하므로 기록해 두는 것이 좋습니다.
팀이 프롬프트에 없는 규칙을 원한다면 어떻게 하나요?
날짜와 이유를 명시하여 변경 이력에 추가한 후 세 도메인에서 테스트하세요. 세션 중간에 입력된 지시문보다 한 번 작성된 새로운 제한이 감사하기 쉽습니다.
우리의 입장
어조보다 영수증이 우선
우리는 확신하는 유창한 어시스턴트보다 작업 이름과 잔액을 출력하는 지루한 어시스턴트를 선호합니다. 유창함은 저렴합니다. 설명에 대한 첫 번째 눈이 그 이유를 보여줍니다.