API 문서는 참고 자료인 반면, 개발자용 프레젠테이션은 온보딩 과정입니다. 문서에는 모든 엔드포인트, 매개변수, 응답 코드가 나열되어 있지만, 개발자 대상 청중에게는 먼저 ‘API가 무엇을 하는지’, ‘인증은 어떻게 이루어지는지’, ‘첫 호출은 어떻게 하는지’와 같은 개념적 이해가 필요합니다. Gamma를 사용하면 문서 소스를 연결하거나 내용을 붙여넣기만 하면, AI 에이전트가 복잡한 참조 자료를 몇 분 만에 명확하고 시각적인 개발자용 프레젠테이션, 개념, 흐름, 호출 예시로 변환해 줍니다.
문제는 순서 구성입니다. 문서는 조회 용이성, 알파벳순 엔드포인트, 모든 매개변수를 망라하는 방식으로 구성되어 있는 반면, 프레젠테이션은 단계적으로 이해가 쌓이도록 가르쳐야 합니다. 참조 문서를 처음부터 끝까지 읽는다고 해서 개발자를 온보딩할 수는 없습니다. Gamma의 에이전트는 귀사의 문서를 읽고, 누가 통합 작업을 수행하며 무엇을 달성해야 하는지 파악한 뒤, 개발자가 첫 호출을 성공적으로 수행할 수 있도록 자료를 재구성하여 프레젠테이션으로 만들어 드립니다.
효과적인 개발자 프레젠테이션은 참조 문서를 이해로 이끌어 줍니다:
API의 기능과 이 API가 해결하는 문제를 처음부터 명확히 설명합니다.
인증 없이는 아무것도 작동하지 않으므로, 이 부분을 초반에 다룹니다.
엔드포인트에 앞서 핵심 개념과 리소스 모델을 설명합니다.
구체적인 요청과 응답을 예로 들어 첫 번째 호출 과정을 단계별로 살펴봅니다.
개발자들이 실제로 가장 많이 사용할 주요 엔드포인트를 강조합니다
그 외 모든 내용에 대해서는 전체 문서를 참조하십시오.
훌륭한 개발자 프레젠테이션은 청중이 “모든 엔드포인트를 다 봤다”가 아니라 “이걸 어떻게 사용하는지 알겠다”라고 생각하게 만듭니다.
문서가 저장된 곳(Confluence, GitHub를 통한 문서 저장소, Notion 등)에 도구를 연결하기만 하면 Gamma가 콘텐츠를 직접 가져오므로 복사-붙여넣기할 필요가 없습니다. 파일을 직접 편집하는 것을 선호하시나요? 참조 문서를 붙여넣거나 마크다운 코드를 입력하세요. 어느 쪽이든 Gamma는 자료를 분석하여 API 문서임을 파악합니다. 소스 연결은 1분도 채 걸리지 않으며, API가 변경될 때 프레젠테이션을 신속하게 업데이트할 수 있게 해줍니다.
Gamma의 담당자는 누가 통합 작업을 진행하는지, 그리고 무엇을 달성하고자 하는지 확인한 뒤, 문서를 검토하여 이를 ‘개요’, ‘인증’, ‘개념’, ‘첫 호출’, ‘주요 엔드포인트’, ‘리소스’ 순으로 구성된 학습 흐름에 따라 정리합니다. 이렇게 정리된 참고 자료는 이해를 돕는 서사적 구조로 재구성됩니다.
Gamma는 예시 요청을 읽기 쉬운 코드 블록으로, 인증 및 요청 흐름을 다이어그램으로, 리소스 모델을 명확한 시각 자료로 자동으로 변환합니다. 개발자들은 방대한 참조 문서를 마주하는 대신, 개념이 체계적으로 정리된 형태를 확인하여 내용을 쉽게 이해할 수 있습니다.
문서 소스를 연결하거나 참조할 내용을 복사해 붙여넣을 수 있도록 준비해 두세요. 개요, 인증 및 몇 가지 주요 엔드포인트만으로도 에이전트가 작업을 수행하는 데 충분한 정보를 얻을 수 있습니다.
gamma.app을 열고 프롬프트 창에서 시작하세요. 문서를 연결하거나 내용을 붙여넣은 다음, 필요한 내용을 요청하세요. 예를 들어, “이 API 문서를, 우리 API를 통합하는 엔지니어들을 위해 인증, 핵심 개념, 첫 호출을 다루는 개발자 온보딩 프레젠테이션으로 만들어 주세요.”라고 요청하면 됩니다. 에이전트에게 한두 가지 간단한 답변을 제공하면 에이전트가 작업을 시작합니다.
Gamma는 개요를 제안합니다. 일반적인 개발자 프레젠테이션은 다음과 같은 흐름으로 진행됩니다:
API의 기능과 사용 시점
인증 및 자격 증명 가져오기
핵심 개념과 리소스 모델
첫 번째 요청과 응답
주요 평가 지표 및 일반적인 워크플로우
오류, 제한 사항 및 모범 사례
전체 문서 및 자료
대상 고객에 맞춰 섹션의 순서를 변경하거나, 추가하거나, 삭제하세요. 인증 정보가 먼저 필요한 파트너를 온보딩하고 계신가요? 해당 섹션을 앞쪽으로 이동시키세요.
Gamma는 사용자의 코드 블록과 흐름도, 그리고 전체적으로 일관된 디자인을 반영하여 완성도 높은 개발자용 프레젠테이션을 생성합니다. 파트너 브리핑이나 출시 브리핑의 경우, Max 모드는 가장 강력한 모델을 활용하여 프레젠테이션을 한층 더 세련되게 다듬어 줍니다.
레이아웃이 이미 구성되어 있으므로 각 개념이 자연스럽게 자리 잡습니다. 코드 블록이나 다이어그램을 정확한 위치에 배치하고 싶다면 자유 형식 편집 모드로 전환하여 정밀하게 위치를 조정하세요. 변경 사항을 설명하는 방식을 선호하시나요? AI 편집 기능을 사용해 요소를 선택한 다음, “인증 흐름을 다이어그램으로 표시해 줘” 또는 “필수 매개변수를 강조 표시해 줘”와 같이 Gamma에게 수행할 작업을 지시하세요. 각 헤드라인을 핵심 아이디어 하나로 명확하게 다듬으세요.
실시간으로 프레젠테이션을 진행하거나, 개발자들이 나중에 다시 확인할 수 있는 상호작용형 웹 링크를 공유하거나, PowerPoint, PDF 또는 Google Slides로 내보낼 수 있습니다. 코드, 다이어그램 및 서식 정보가 그대로 유지되므로, 개발자들은 원하는 형식으로 자료를 확인할 수 있습니다.
Gamma 대 문서에서 직접 표시하기
형식: 문서는 검색하기 편리하도록 정리되어 있는 반면, 프레젠테이션은 내용을 전달할 수 있는 순서가 필요합니다.
Pace: 방 안이 참고 자료로 가득 차 있지만, Gamma는 개발자들이 가장 먼저 필요로 하는 자료만 선별해 제공합니다.
시각 자료: 문서는 텍스트 위주인 경우가 많은데, Gamma는 흐름과 개념을 다이어그램으로 변환해 줍니다.
솔직한 조언: API 문서를 완벽한 참조 자료로 유지하세요. 그게 바로 API 문서의 존재 이유니까요. 개발자들을 대상으로 실시간 온보딩을 진행할 때는 Gamma를 활용해 문서를 교육용 프레젠테이션으로 변환하고, 자세한 내용은 전체 참조 자료를 참고하도록 안내하세요.
감마 대 파워포인트
출처: PowerPoint가 빈 화면으로 시작되며, Gamma는 문서나 연결된 소스를 직접 읽어옵니다.
업데이트: API가 변경될 때, PowerPoint는 수동으로 처리해야 하지만 Gamma에서는 소스 데이터를 바탕으로 빠르게 다시 생성할 수 있습니다.
디자인: 파워포인트의 품질은 사용자에게 달려 있습니다. 감마 값은 일관되게 유지됩니다.
솔직한 평가: 파워포인트는 맞춤형 브리핑을 위해 모든 기능을 자유롭게 제어할 수 있게 해줍니다. 문서를 온보딩 프레젠테이션 자료로 빠르게 전환해야 할 때는 감마를 사용하면 더 빨리 완성할 수 있으며, 언제든지 파워포인트로 다시 내보낼 수 있습니다.
멘탈 모델부터 시작하세요. 개발자는 엔드포인트보다 먼저 API의 구조를 이해해야 합니다.
인증 처리는 초기에 완료하세요. 인증이 완료되기 전까지는 다른 어떤 작업도 진행될 수 없으므로, 이 부분을 뒷전으로 미루지 마세요.
실제 첫 통화 상황을 보여주세요. 구체적인 요청과 응답은 매개변수 표보다 더 많은 것을 가르쳐 줍니다.
모든 엔드포인트를 나열하지 마세요. 개발자들이 가장 자주 사용하는 몇 가지를 강조하고, 나머지는 링크로 연결하세요.
전체 참고 자료를 항상 확인할 수 있도록 해 두세요. 모든 세부 사항을 한데 뭉뚱그려 담기보다는 관련 문서를 참조하도록 안내하세요.
네. Confluence, GitHub 문서 저장소, Notion 또는 문서가 저장된 곳 어디든 연결하기만 하면 Gamma가 해당 콘텐츠를 직접 가져옵니다. 원하신다면 참고 자료를 직접 붙여넣을 수도 있습니다.
네. Gamma는 코드를 깔끔하고 읽기 쉬운 블록 단위로 표시합니다. 제시하는 예제는 핵심 내용에 집중하도록 하고, AI 편집 기능을 활용하여 필수 매개변수나 핵심 문장을 강조해 주세요.
Gamma는 사용자가 설명한 흐름을 명확한 다이어그램으로 변환해 줍니다. 자유 형식 편집 기능을 사용하여 다이어그램을 다듬거나, 에이전트에게 흐름을 단순화해 달라고 요청할 수 있습니다.
문서 소스가 연결되어 있다면, Gamma에 업데이트된 내용으로 새로 고침을 요청하거나 템플릿으로 저장하세요. 구조는 그대로 유지되고 내용만 업데이트됩니다.
문서에는 이미 모든 엔드포인트가 설명되어 있습니다. 다만 이 문서는 조회용으로만 구성되어 있을 뿐, 온보딩 용도로는 만들어지지 않았습니다. 문서를 연결하거나 내용을 붙여넣고, Gamma에 대상 사용자와 그들의 목표를 알려주면, 에이전트가 해당 참고 자료를 코드와 다이어그램이 포함된 교육용 프레젠테이션으로 변환해 줄 것입니다. 이를 통해 개발자들이 빠르게 첫 번째 호출을 성공적으로 수행할 수 있게 될 것입니다.
