에이전트 도구를 설계할 때 확인할 정보·판단·실행의 경계

About this offer

자동화 시스템을 이해하고 통제하려면 무엇부터 살펴야 할까요? 무엇을 읽을 수 있는지, 어디까지 판단하는지, 어떤 조건에서 행동하는지 살펴야 합니다. 자동화가 개입하면 이 경계가 기능의 개수보다 시스템을 이해하고 통제하는 데 중요한 기준이 됩니다. 자동화 기능을 늘릴 때는 사용자가 그 동작을 이해할 기준도 필요합니다. 배포 상황을 묻는 일과 과거 기록을 찾는 일 SkillsMP의 discord-clawd 설명에서는 전송 전의 대상 확인과 실행 후의 보고가 짝을 이룹니다. 보내기 전에는 누구에게 전달할지 확인합니다. 실행한 뒤에는 대상과 전달 모드를 알려 줍니다. 이렇게 하면 대상 선택과 전달 방식, 실행 결과를 각각 살펴볼 수 있습니다. ( https://skillsmp.com/skill/openclaw-openclaw-agents-skills-discord-clawd-skill-md ) 배포 상황에 관한 두 요청은 작업을 구별하기 위한 설명용 예시입니다. 유지보수 담당자에게 묻는 요청에서는 새로운 대화를 시작해야 합니다. 예전에 논의한 내용을 찾는 요청에서는 이미 남은 기록을 읽어야 합니다. 다루는 주제가 같아도 사용자가 원하는 결과에 따라 필요한 작업이 달라집니다. 문서에 대상 확인을 요구하는 것과 코드가 잘못된 대상으로의 전송을 막는 것은 서로 다른 문제입니다. 사용자에게 명시적인 게시 요청을 받지 않은 강제 전송을 거부하는지도 별도로 살펴야 합니다. 스킬 설명만으로는 이 두 조건을 코드가 강제하는지 알 수 없습니다. OHTTP가 나누는 정보와 보호의 조건 GeekNews의 Cloudflare OHTTP 게이트웨이 소개에서 릴레이가 받는 요청 본문은 암호문입니다. 릴레이에는 클라이언트 IP 같은 연결 정보가 보입니다. 반면 게이트웨이는 요청의 암호화를 풀어 앱 서버에 전달합니다. 요청을 전달하는 과정에서 각 역할이 접하는 정보가 달라지는 구조입니다. ( https://news.hada.io/topic?id=34719 ) 이 정보 분리에는 운영 조건이 붙습니다. 기사에서는 릴레이와 앱 서버를 서로 공모하지 않는 별도 주체가 운영해야 한다고 설명합니다. 앱 서버가 Cloudflare 뒤에 있다면 외부 릴레이와 Cloudflare OHTTP Gateway를 조합하는 방식을 제시합니다. 암호화 방식뿐 아니라 누가 각 역할을 운영하는지도 설계에 포함됩니다. 기사에 따르면 Workers나 Cloudflare 프록시 호스트에서 들어온 요청은 복호화를 거부합니다. 같은 사업자 안에서 역할이 겹치는 상황을 막기 위한 조건입니다. 그러나 개발자가 요청 본문에 이메일이나 사용자 이름을 넣으면 앱 서버는 그 내용을 받습니다. 연결 정보의 분리와 본문에 담을 식별 정보의 선택은 각각 살펴야 합니다. GeekNews 소개 당시 게이트웨이는 비공개 베타 상태였습니다. 가을에 유료 부가 기능으로 내놓겠다는 내용은 당시의 출시 계획입니다. 현재 정식 출시 여부는 이 소개만으로 알 수 없으므로, 제품 상태를 읽을 때는 소개 시점과 계획의 성격을 함께 보아야 합니다. 창 배치를 제안하는 모델과 변경하는 코드 GeekNews의 tmux를 OS로 만들자에 소개된 구상은 데스크톱을 끝없이 펼쳐지는 작업 공간으로 봅니다. 물리 모니터는 그 공간의 일부를 보여 줍니다. 모니터 연결이 달라져도 창의 순서와 어떤 작업에 속한 창인지를 유지하려는 생각입니다. ( https://news.hada.io/topic?id=34720 ) 이 구상은 tmux에서 세션을 유지하고 작업을 중심으로 사용하는 경험을 일반 사용자에게 확장하려는 Linux 실험입니다. 로컬 언어 모델인 LLM은 창 배치안을 만들고 미리보기를 보여 주는 역할을 맡습니다. 실제 변경은 사용자 승인을 거친 뒤 결정론적 코드가 맡도록 설계합니다. 모델이 창을 직접 조작하지 못하게 하고, 고정해 둔 창도 변경하지 못하게 합니다. 초기 실험에서는 행동 데이터 수집이 프라이버시와 충돌했고, 캔버스가 끝없이 쌓이는 문제도 나타났습니다. 입력이 없는 유휴 상태를 근거로 창을 숨기자 읽기를 방해했습니다. 사용자가 키보드나 마우스를 움직이지 않아도 읽기는 계속될 수 있습니다. 따라서 입력이 없다는 신호를 작업 종료로 해석해도 되는지 판단해야 합니다. 새 도구의 설명에서 실행 조건까지 점검하기 세 사례를 참고해 새 에이전트 도구를 어떤 순서로 점검할 수 있을까요? 먼저 설명문에 기록 읽기와 새 대화 중 도구의 역할, 대상 확정 시점, 결과에 남길 전달 정보를 명시합니다. 이어서 넘길 데이터가 필요한 범위인지 확인하고, 중요한 실행 조건이 문서 밖에서도 검사되는지 점검합니다. 점검할 대상은 사례마다 다릅니다. 새 도구에 적용할 때도 어떤 경계를 정하려는지 먼저 분명히 해야 합니다. 도구 설명을 구체화합니다 — 작업 역할과 대상 확정 시점, 결과에 남길 전달 정보를 명시합니다. 넘길 데이터를 살핍니다 — 도구에 전달할 데이터가 작업에 필요한 범위인지 확인합니다. 실행 단계의 검사를 살핍니다 — 중요한 실행 조건이 문서 밖에서도 검사되는지 점검합니다. 무엇을 근거로 누가 실행하는지 드러내기 적용할 기준은 기능이 다루는 대상에 맞춰 잡아야 합니다. 메시지를 보내는 도구에는 전달 조건이, 요청을 중계하는 구조에는 정보의 분리가 필요합니다. 창 배치를 제안하는 모델에는 실제 변경으로 이어지는 조건이 필요합니다. 각 사례에서 나누는 대상을 구체적으로 짚는 것이 설계 점검의 출발점입니다. 원문: webi 기술 블로그 참고한 자료: SkillsMP Agent Skill: discord-clawd (openclaw) Cloudflare OHTTP 게이트웨이 tmux를 OS로 만들자