tool-design
AI 에이전트를 위한 효과적인 툴 API 설계
또한 다음에서 사용할 수 있습니다: Asmayaseen,ChakshuGautam,muratcankoylan
잘못된 툴 설계는 프롬프트 엔지니어링으로는 해결할 수 없는 실패 모드를 만듭니다. ��� 스킬은 AI 에이전트 추론과 사용에 최적화된 툴 인터��이스 구축을 위한 원칙을 제공합니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
테스트해 보기
"tool-design" 사용 중입니다. 이 툴을 검토하세요: def search(query): "데이터베이스 검색."
예상 결과:
- 발견된 문제: (1) 모호한 이름 - 무엇을 검색? (2) 매개변수 문서 누락 - 어떤 형식? (3) 반환 설명 없음 (4) 오류 처리 없음 (5) 사용 컨텍스트 없음
- 권장사항: search_customers(query, fields)로 이름 변경, 쿼리 구문 문서화, 반환 형식 명시, INVALID_QUERY 및 RATE_LIMITED 오류 케이스 추가
"tool-design" 사용 중입니다. 50개의 전문 툴을 더 간단한 세트로 어떻게 줄이나요?
예상 결과:
- 통합 적용: 데이터 엔티티가 아닌 워크플로우별로 관련 툴 그룹화
- 아키텍처 축소 고려: 파일 시스템 액세스 + 표준 유틸리티가 사용자 정의 툴을 대체할 수 있는가?
- 네임스페이스를 사용하여 10-20개 툴 목표: database.query, database.schema, web.search, web.fetch
보안 감사
안전Static analysis flagged 73 potential issues but all are false positives. The SKILL.md file is documentation-only containing conceptual explanations and Python code examples in markdown blocks. No executable code, network calls, or system commands exist. External command patterns (8) are markdown code snippets, network patterns (3) are documentation URLs, cryptographic warnings (62) are text matches in prose, and reconnaissance flags (6) reference conceptual discussions.
품질 점수
만들 수 있는 것
에이전��� 툴 세트 구축
Claude 또는 Codex가 시스템과 효과적으��� 상호작용할 수 있도록 포괄적인 툴 API 설계
툴 오용 디버깅
에이전트가 툴을 제대로 사용하지 못하는 이유를 진단하고 설계를 개선
툴 복잡성 축소
과도하게 설계된 툴 아키텍처를 단순화하는 아키텍처 축소 적용
이 프롬프트를 사용해 보세요
이 툴 사양을 검토하고 설계 문제를 식별하세요: [툴 코드 붙여넣기]. 모호한 설명, 누락된 매개변수 문서, 명확하지 않은 ���환 형식, 오류 처리 공백을 확인하세요.
이 툴은 명확하지 않은 설계를 가지고 있어 에이전트 실패를 일으킵니다: [툴 붙여넣기]. 툴 설계 원칙을 따라 재설계하세요: 명확한 what/when/returns, 통합된 기능, 실행 가능한 오류 메시지.
현재 툴 세트를 분석하세요: [툴 목록]. 통합 및 축소 기회를 식별하세요. 전문 툴을 대체할 수 있는 최소한의 범용 툴 세트를 추천하세요.
[도메인]을 위한 에이전트를 구축 중입니다. 통합 및 네임스페이스 원칙을 ��용하여 툴 컬렉션을 설계해 주세요. 고려사항: 명확한 워크플로우, 툴 개수 제한(10-20개), 응답 형식 옵션, 복구 지향 오류 메시지.
모범 사례
- 툴의 기능, 사용 시기, 반환 내용을 담는 툴 설명 작성
- 모호성을 줄이기 위해 여러 좁은 툴보다는 단일 포괄적인 툴 선호
- 무엇이 실패했는지뿐만 아니라 복구 방법을 에이전트에게 알려주는 오류 메시지 설계
피하기
- '도움이 됨' 또는 '사용 가능'과 같은 모호한 설명 사용
- x, val 또는 data와 같은 암호적인 매개���수로 툴 이름 지정
- 모���이 처리할 수 있는 추론을 제한하는 가드레일 툴 구축