블로그로 돌아가기
연동
시스템을 망가뜨리지 않고 에이전트를 연결하는 법
정하늘 · 2026년 4월 30일 · 6분 분량
말만 할 수 있는 에이전트는 조금 더 친절한 대기 안내일 뿐입니다. 가치는 팀이 이미 사용하는 시스템 — 견적, 티켓, 일정, 기록 — 을 읽고 쓸 수 있을 때 드러납니다.
도구를 계약처럼 다루세요
모든 것에 대한 원시 접근 권한 대신, 잘 설명된 소수의 행동 집합을 에이전트에게 주세요. 각 도구는 무엇을 하고, 무엇이 필요하며, 무엇을 돌려주는지 분명히 밝혀야 합니다. 명확한 계약은 에이전트를 예측 가능하게 하고 시스템을 안전하게 지킵니다.
좁고 읽기 쉬운 도구 집합은 실패도 읽기 쉽게 만듭니다. 무언가 깨지면 어떤 행동과 어떤 입력이 관련됐는지 정확히 보입니다.
잘못된 경로를 대비하세요
실제 시스템은 타임아웃이 나고, 호출을 제한하고, 예상치 못한 응답을 돌려줍니다. 호출이 실패했을 때 에이전트가 무엇을 할지 미리 정하세요 — 일시적 오류는 재시도하고, 치명적 오류는 절대 재시도하지 않으며, 모호한 것은 추측하지 말고 사람에게 올립니다.
여기서는 멱등성이 중요합니다. 두 번 일어나서는 안 되는 행동에는 키가 필요합니다. 그래야 재시도가 중복으로 변하지 않습니다.
읽기 전용으로 시작하세요
가장 안전한 첫 연동은 읽기만 하는 연동입니다. 무언가를 바꿀 권한을 주기 전에, 에이전트가 데이터를 조회하고 제대로 이해하는지 먼저 확인하세요. 쓰기 권한을 단계적으로 얻는 길은 느리지만, 뒤처리로 끝날 가능성은 훨씬 낮습니다.