https://www.youngju.dev/blog 천천히 올바르게. AI Researcher & DevOps Engineer Youngju's blog. GPU/CUDA, LLM, MLOps, Kubernetes AI workloads, and data engineering — plus mindset essays on confidence, routines, health, and sport psychology. ko fjvbn2003@gmail.com (Youngju Kim) fjvbn2003@gmail.com (Youngju Kim) Wed, 12 Aug 2026 00:00:00 GMT https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.en https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.en Adding more tools and watching the agent success rate drop is not rare. The tool surface is the agent interface, and the names, descriptions, parameters, failure returns, and response sizes are all design material. Part 3 of the harness engineering series covers the curse of tool count, namespacing and description copy, poka-yoke parameters, and the format in which failure comes back. Wed, 12 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) llmagentharness-engineering하네스엔지니어링AI에이전트tool-designmcp https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.ja https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.ja ツールを増やしたのにエージェントの成功率が下がる、という事態は珍しくありません。ツール表面はエージェントのインターフェースであり、名前・説明・パラメータ・失敗の返し方・応答サイズのすべてが設計対象です。ハーネスエンジニアリング連載第3回では、ツール数の呪い、ネームスペーシングと説明文、ポカヨケなパラメータ、失敗を返す形式まで、ツール表面の設計を整理しました。 Wed, 12 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) llmagentharness-engineering하네스엔지니어링AI에이전트tool-designmcp https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface 도구를 더 붙였는데 에이전트 성공률이 떨어지는 일은 드물지 않습니다. 도구 표면은 에이전트의 인터페이스이고, 이름·설명·파라미터·실패 반환·응답 크기가 전부 설계 대상입니다. 하네스 엔지니어링 시리즈 3편에서 도구 수의 저주, 네임스페이싱과 설명 문구, 포카요케 파라미터, 실패를 돌려주는 형식까지 도구 표면 설계를 정리했습니다. Wed, 12 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) llmagentharness-engineering하네스엔지니어링AI에이전트tool-designmcp https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.zh https://www.youngju.dev/blog/llm/2026-08-12-harness-tool-surface.zh 加了更多工具，智能体成功率反而下降，这并不少见。工具表面就是智能体的接口：名字、描述、参数、失败返回、响应大小，全都是设计对象。框架工程系列第 3 篇，整理了工具数量的诅咒、命名空间与描述文案、防错（poka-yoke）参数设计，以及失败以什么格式返回。 Wed, 12 Aug 2026 00:00:00 GMT fjvbn2003@gmail.com (Youngju Kim) llmagentharness-engineering하네스엔지니어링AI에이전트tool-designmcp