본문 바로가기

테크니컬 라이팅/컨퍼런스

(195)
AI The Docs 2024 - AI로 퍼소나 만들고 대화하기 nexio에 합류한 건 3년 정도 되었습니다. 원래는 API 문서화를 담당할 계획이었는데 개발자 포털을 담당하게 되었고 현재는 전반적인 개발자 경험을 개선하는 일을 맡고 있습니다. https://docs.nexiopay.com/몇 가지 유용한 AI 도구, 팁에 대해 공유합니다.(워낙 이런 비슷한 글이 많아서 흥미로운 내용은 많지 않습니다. 후반부에 구글 통계를 활용하는 부분이 오히려 더 유용했을 수도 있는데, 시간이 없어서 그냥 쓰윽 지나가버렸네요).- 온라인 회의 시 요약정리 https://tldv.io/회의를 요약해 주고 이메일로 공유할 수 있고, 회의에서 언급된 할 일 목록을 작성해 준다고 합니다. 무료라고 설명했는데, 유료 옵션이 있고 무료 버전은 일부 기능 제약이 있습니다. - 유용한 문장 수집..
AI The Docs 2024 - pieces.app에 대한 소개 Pieces이라는 앱에 대한 소개입니다. 기술 데모 정도라고 볼 수 있습니다. 보통 다른 세션은 기술 데모를 하더라도 어느 정도 프레젠테이션 후에 진행하는데 이번 세션은 문서 없이 간단히 소개하고 바로 넘어갑니다. 독특하게 운영체제 수준에서 사용자가 가지고 있는 코드, 문서, 채팅 등 데이터를 자동으로 분류해서 처리합니다. 처리 과정에서는 외부 API를 사용할 수도 있고 로컬 머신 러닝을 통해서 처리할 수도 있다고 하네요. 예를 들어 어떤 코드 조각을 웹사이트에서 복사하면 그 시점에서 코드를 분석해서 어떤 용도의 코드이고 어떻게 활용할 수 있는지 분석해서 리포트 형태로 데이터를 보여줍니다. 코드는 분류된 상태로 저장되고 나중에 활용할 수 있게 되는 거죠. 찾아보면 비슷한 유형의 서비스가 없는 것은 아..
AI The Docs 2024 - ChatGPT는 내 데이터를 안전하게 처리하나요 AI The Docs 2024 행사에는 3개의 키노트가 있습니다. 보통 이런 세션은 유명한 강사가 맡거나 아니면 스폰서가 가져가게 됩니다. 이 행사에서는 컨퍼런스 주최 측인 Pronovix에서 첫 번째 키노트를 진행하고 점심시간 직후 키노트와 행사 마지막 순서 키노트를 진행합니다. 그런데 키노트라고 해서 뭔가 주제가 포괄적인 건 아니고 다른 세션과 큰 차이가 없는 것이 특징(?)이네요. 데이터가 어디에 어떤 식으로 저장되고 가공되고 활용되는지는 민감한 부분입니다. 때문에 각 국가에서는 데이터 처리를 규제하는 법안을 만들고 이를 지키도록 하고 있습니다. 예전에는 개인이 어떤 데이터를 입력한다고 할때 정해진 필드에 값을 입력합니다. 예를 들어 전화번호라고 한다면 전화번호 입력 필드가 있고 거기에 입력을 하..
AI The Docs 2024 - 개발자 포털은 이제 최소한의 기준선입니다 개발자 포털은 2000년대 초반 구글이나 세일즈 포스 같은 회사에서 API 서비스가 제공되면서 등장했고, 2010년이 넘어가면서 좀 더 많은 회사들이 API 서비스를 제공하면서 개발자 포털을 구축하는 것이 유행처럼 번졌습니다. 개발자 포털은 단순히 문서를 제공하는 것을 넘어 서비스를 수행하는 방법을 좀 더 쉽게 이해할 수 있도록 안내하고 개발자 포털을 통해 회사는 서비스 비용을 줄일 수 있었습니다. 현재 시점에서 개발자 포털은 "Table Stake"입니다(테이블 스테이크는 경제 용어로 시장에 대한 "최소 진입 요건"이라고 하네요. 참고로 Table Stake는 포커 등의 도박에서 최소한의 판돈을 의미한다고 합니다. 고기 스테이크(steak)와는 철자가 다르군요). API 서비스를 제공한다면 기본적으로 ..
AI The Docs 2024 - LLM의 등장이 OpenAPI 진영에 미치는 영향 발표자인 Marsh Gardiner는 OpenAPI 프로젝트에 초기부터 참여했고, 지금도 보드 멤버로 참여하고 있다고 합니다. 2009년부터 Apigee에 근무하다가 2016년 구글에 인수되면서 구글에서 PM으로 2023년까지 일했습니다. LLM의 등장이 API 진영에 미치는 영향 중 하나는 사용자의 범위가 확대된다는 것입니다. 기존에는 전문적인 개발자를 대상으로 서비스를 제공하고 정보를 전달했다면 이제는 프로그래밍을 전혀 모르는 사용자가 LLM을 통해 API 사용을 시도할 수 있다는 것입니다.그래서 API 제품 사용 여정을 다시 설계하고 고민할 필요가 있습니다. 이와 관련해서 OpenAPI에서는 2025년 문워크 SIG(OpenAPI 4.0)를 조직하고 운영하고 있습니다. 아직 출시 일정은 정해지지 않..
AI The Docs 2024 - 대규모 문서를 LLM으로 다루는 방식 커피 전문점(스타벅스 같은)에서는 커피를 커스텀하게 만드는 방법이 17만 가지라고 합니다. 예를 들어 온도를 10의 점수로 부여하고 커피의 진하기를 10의 점수로 부여한다면 벌써 100가지 조합이 가능하죠. 그런 식으로 수십 가지의 측정할 수 있는 항목이 있고 그 조합이 17만 가지라고 합니다. 이런 커피 스토리를 가지고 LLM, RAG가 어떻게 동작하는지를 쉽게 설명해주고 있습니다. 머신 러닝 시절에는 기계한테 커피 만드는 방법을 학습시키는 방식으로 몇 가지의 커피를 만드는 방법을 배우게 하는 것이라면 LLM은 온갖 커피 레시피 관련 정보를 스스로 탐색하고 정리해서 수백 개의 커피 레시피를 만들고 변형시킬 수 있다는 점입니다. 그리고 실제적인 사용 사례로 시맨틱 검색으로 들어가는데, 여기부터는 갑자기 ..
AI The Docs 2024 - APIs.json으로 AI 에이전트가 좀 더 쉽게 정보를 이해하게 만들기 AI 에이전트가 API 문서를 이해하기 위해 단순히 OpenAPI, AsyncAPI 같은 API 명세만으로는 충분하지 않으며, API를 제대로 이해하고 활용하려면 전체 API 운영 정보를 기계가 읽을 수 있는 형태로 제공해야 한다고 강조합니다. 이런 정보를 제공할 수 있는 적절한 방법이 APIs.json이라고 합니다. APIs.json은 문서, 인증, 버전, 가이드 뿐 아니라 가격 정보까지 API 전반에 걸친 정보를 구조화해서 담을 수 있으며 확장할 수 있기 때문에 AI 에이전트가 적절하게 정보를 탐색할 수 있는 안내를 제공할 수 있다고 합니다. 웹사이트에서 sitemap.xml 파일을 SEO를 위해 활용한 것과 비슷한 개념이라고 할 수 있습니다. https://apisjson.org/https://..
WTD 포틀랜드 2025 - 라이트닝 토크 모음 (2) Jennifer Evans: But did you die? Doing things scared두렵고 무서운 일이라도 시도했을 때 죽지 않는다. 그러니 괜찮다. 그런 격려의 메시지입니다. Michelle Knight: Document: your most valuable data asset메시지가 좀 모호하긴 한데, 조직 내에서 기술 문서도 데이터 자산으로 관리되어야 하고 이에 대한 거버넌스 체계가 필요하다는 이야기입니다.전통적인 데이터 거버넌스 범위는 실제 데이터에 초점을 맞추고 있지만, 최근에는 문서 역시 대상이 될 수 있다고 합니다. 좀 더 상세한 내용은 어떤 식으로 관리한다는 것인가를 찾아봐야 할 텐데, 그런 자료는 찾기가 쉽지 않네요. Ashley Gordon: I Come Back Stronger..

반응형