발표자가 최근 진행한 실제 프로젝트에서 활용했던 것이라고 합니다. 최근 7개의 서로 다른 API가 있는 SDK 제품을 위한 문서를 제한된 시간 내에 작성해야 하는 미션이었다고 합니다. 검토할 자료가 너무 많아서 수작업으로는 시간 내에 마칠 수 없어서 AI의 도움을 받았다고 합니다. 완전한 자동화는 아니지만, 대량의 자료를 검토하고 문서를 작성할 때 작업 시간을 줄일 수 있는 가이드 정도로 보면 될 것 같네요.
5가지 프로세스에 대해 설명합니다. 발표 영상에서는 제한된 시간 때문에 짧게 이야기했는데, 각 단계에 대한 상세 내용과 영상을 자신의 사이트에 공유해 놓았습니다. 자세한 내용은 링크를 참고하세요.
1. Gather source material
문서의 초안을 작성하기 위해서는 관련 소스 자료를 준비해야 합니다. 일반적으로 테크니컬 라이터가 기술 문서를 작성할 때도 마찬가지입니다. 설계 문서를 확인하고, 관련 회의에 참석하거나 회의록을 확인하고, 이메일 등의 자료를 확인하면서 초안을 작성하게 됩니다. LLM도 마찬가지로 소스 자료를 제공해 주어야 이에 근거해서 초안을 작성할 수 있습니다.
LLM을 사용하는 것은 비용과 연관될 수 있고, 불필요한 소스가 포함되면 그만큼 잘못된 정보를 생성할 수 있기 때문에 적절한 소스 자료를 정리하는 선행 작업이 필요하긴 합니다.
그리고 소스 자료는 내부 문서일 수도 있는데, 이런 경우에는 공개된 LLM을 사용하는 것은 위험이 뒤따를 수 있습니다. 내부에서 안전하게 사용할 수 있는(또는 회사에서 검증된) LLM을 사용해야 합니다.
https://idratherbewriting.com/ai/prompt-engineering-source-material-context
2. Decide on a template
소스 자료를 기반으로 제시된 템플릿을 채우는 작업입니다. 템플릿의 내용이 구체적으로 있는 경우에 가능한 방법일 것 같구요. 일반적인 문서 템플릿의 경우에는 애매한 활용 방안이 될 수 있습니다.
리버스 엔지니어링은 이미지 생성 시 많이 활용하는 것인데, 모범적인 문서를 기반으로 리버스 엔지니어링을 통해 프롬프트를 생성하고 이를 내 문서에 반영하는 방식입니다. 프롬프트 자체가 스타일 가이드처럼 만들어지네요.
https://idratherbewriting.com/ai/prompt-engineering-populating-documentation-templates.html
https://idratherbewriting.com/ai/reverse-engineering-prompts.html
3. Go section by section
프롬프트 엔지니어링에서 대용량 자료의 처리 시 누락되거나 생략되는 부분이 있으니 이를 적절하게 잘라서 처리해야 한다는 이야기입니다. 하지만 LLM이 발전하면서 이런 방법이 별로 필요가 없어질 수도 있으니 참고하세요.
회의를 정리하는 방법은 국내에서는 클로바 노트가 단연 독보적입니다. 클로바 노트에도 요약 기능이 있지만, 발표자가 제시한 방법으로 요약 내용을 따로 정리하는 것도 좋을 것 같습니다.
https://idratherbewriting.com/ai/prompt-engineering-summarizing-meeting-notes.html
https://idratherbewriting.com/ai/prompt-engineering-task-decomposition.html
4. Error check the output
5. Review with experts
AI 도구를 사용하더라도 최종적인 검토는 사람이 담당해야 합니다. 관련 소스 자료와 비교해서 잘못된 부분이 없는지 확인하고 적절하게 작성되었는지 확인합니다.
https://idratherbewriting.com/ai/prompt-engineering-error-checking.html
* 발표 당시에는 AI 관련 글이 몇 개 없었는데 지금은 그 뒤로 잔뜩 글이 추가되었습니다. 이전 내용도 간혹 업데이트되고 있습니다.
* 2025년 2월에 진행한 Tom Johnson의 다른 발표(릴리스 노트 관련)도 같이 보시면 좋습니다.
2025.03.24 - [테크니컬 라이팅/컨퍼런스] - WTD 호주 2025(Virtual) - AI 도구를 사용해 릴리스 노트 자동으로 생성하기
* 발표 자료와 영상 링크입니다.
https://idbwrtng.com/prompteng5steps
https://youtu.be/o-dQ8WaU7XI?si=wUrGDsWffcOgfsIY
