Cookbook
Agents & skills · for AI agents

플랫폼 스킬 — 모든 에이전트가 이미 갖춘 기능

에이전트마다 개별적으로 연결하는 대신, 의도에 따라 검색되어 모든 에이전트가 사용할 수 있는 일반적인 작업 방법의 공유 라이브러리입니다.

MCP tools:list_skillscreate_skillupdate_agent

**원칙 — 플랫폼 스킬은 메서드(method)이고, 테넌트 스킬은 귀사의 비즈니스입니다. 공유 라이브러리에는 경쟁사 조사, 규제 문서 읽기, 리드 규모 파악과 같은 일반적인 작업 방식이 담겨 있습니다. 귀사의 산업이나 데이터에 특정한 내용은 별도의 스킬에 포함해야 합니다. 자세한 내용은 디자인 원칙을 참조하십시오.

모든 에이전트는 부여할 필요 없이 일련의 플랫폼 스킬을 기본으로 제공합니다. 이들은 일반적인 작업 방식이며, 다른 스킬과 마찬가지로 필요할 때 로드되며, 일일이 개별적으로 연결하지 않습니다.

왜 단순히 "에이전트에 스킬을 더 추가하는 것"이 아닌가

수백 개 메서드로 구성된 라이브러리를 프롬프트에 직접 포함할 수 없습니다. 모든 스킬을 나열하면 선택 능력이 현저히 저하됩니다. 전체 207개 스킬을 나열했을 때 모델이 올바른 스킬을 선택한 비율은 **30%**였으며, 목록을 가장 관련성 높은 15개로 먼저 좁힌 후 나열했을 때 **51%**였습니다. 따라서 플랫폼은 나열하기 전에 검색을 수행합니다.

검색은 해당 턴의 메시지를 대상으로 공유 라이브러리와 귀사의 라이브러리 모두에서 동시에 실행됩니다. 귀사의 스킬이 일반적인 스킬과 공간을 공유한다고 해서 불리하지 않습니다. 실제로 193개의 일반 스킬에 섞인 18개의 진정으로 산업별 스킬을 대상으로 측정했을 때, 산업별 스킬이 더 높은 신뢰도(86% 대 79%)로 인식되었습니다. 이는 산업별 어휘가 일반 메서드 어휘와 멀리 떨어져 있기 때문입니다.

대략 8개 미만의 스킬에서는 검색이 수행되지 않으며, 전체 목록이 단순히 표시됩니다. 이 정도의 크기에서는 목록이 이미 정확하며, 검색은 새로운 실패 요인만 도입할 수 있습니다. 즉, 짧은 목록에서 올바른 스킬이 누락되고 모델이 자체 지식을 바탕으로 답변하며 로그에 그 흔적이 남지 않는 경우입니다.

귀하가 제어할 수 있는 것과 그렇지 않은 것

연결할 수 없음플랫폼 스킬은 모든 에이전트에 기본적으로 제공됩니다. 에이전트별로 체크리스트가 존재하지 않습니다.
사용 중지 가능운영자는 플랫폼 스킬을 모든 사용자에게 대해 사용 중지할 수 있습니다. 이는 에이전트 단위가 아닌 플랫폼 수준의 결정입니다.
재정의 가능동일한 작업을 수행하는 별도의 스킬을 작성하십시오. 귀사의 스킬은 동일한 기준으로 검색되며, 귀사의 비즈니스와 실제로 관련이 있는 요청에서는 일반적으로 승리합니다.

영어로 작성하십시오

플랫폼 스킬은 description, instructions, menu_label 및 생성된 트리거 구문을 포함하여 영어로 작성됩니다.

이것은 데모만을 위한 것이 아닙니다. 동일한 193개의 중국어 스킬 라이브러리에서 측정했을 때, 플랫폼 스킬 3개를 중국어에서 영어로 전환하면 각 스킬의 인식 신뢰도가 상승했습니다: 경쟁사 조사 75% → 83%, 정책 읽기 83% → 100%, 리드 자격 부여 50% → 62%. 영어 스킬은 벡터 공간에서 중국어 스킬 군집으로부터 더 멀리 떨어져 있으므로 구별하기가 더 쉽습니다. (이 이점은 영어 자체보다는 차이에서 비롯되며, 모든 영어 라이브러리에서는 사라집니다.)

언어는 모델이 스킬을 호출할 수 있는지에 영향을 미치지 않습니다. 자체 호스팅 35B 모델과 호스팅 모델 모두 중국어 및 영어 설명에서 정확하고 잘 구성된 load_skill 호출을 생성했습니다. 영어를 선택하는 것은 기술적 우회책이 아닌 제품 결정입니다.

귀사의 스킬은 사정이 다릅니다 — 고객이 사용하는 언어로 작성하십시오.

스킬이 실행되기 전에 플랫폼이 조사하게 하기

스킬은 시작 전에 자료를 모아 두도록 요청할 수 있습니다. instructions 맨 위에 이 줄을 넣으십시오.

PREFETCH: web x4

플랫폼은 방문자의 메시지를 그 수만큼의 검색어로 바꾸어 실행하고, 인용할 수 있도록 번호가 붙은 사실 표를 스킬에 건넵니다. PREFETCH: web만 쓰면 기본값인 두 개이고, 이 줄을 빼면 아무것도 검색하지 않습니다.

질문이 여러 갈래일 때만 폭을 요청하십시오. 어떤 제품 조사—가격, 제한, 내보내기—는 좁은 조사에서 2,957자에 출처 5개였고, 거기 적힌 가격은 모두 어떤 출처에도 없는 구체적인 숫자였습니다. 검색어를 네 개로 늘리자 같은 질문이 출처 17개와 함께 돌아왔습니다. 초안을 쓰거나 고쳐 쓰거나 계산하는 스킬은 아무것도 선언하지 않아야 합니다. 필요 없는 검색은 시간과 비용의 순수한 손실입니다.

이것이 규칙을 적어 두는 일을 대신하지는 않지만, 실제로 작동하는 쪽 절반입니다. 같은 스킬의 지침에는 자료에 없는 가격은 절대 쓰지 말 것이라고 이미 적혀 있었고, 그래도 썼습니다. 답을 바꾼 것은 자료였지 그 문장이 아니었습니다.

실제로 사용되는 스킬 작성하기

일반 스킬과 동일한 규칙에, 규모가 커질 때만 나타나는 하나의 규칙이 추가됩니다:

  • description은 고객이 사용할 언어로 언제 사용해야 하는지 명시합니다. 이것이 검색이 일치시키는 대상입니다.
  • instructions는 스킬이 다루지 않는 내용으로 끝납니다. 수백 개의 스킬이 존재하면 유사한 스킬이 불가피하게 존재합니다. 이 마지막 문장은 모델이 잘못된 스킬을 열었음을 인지하게 하는 유일한 수단입니다.
  • 트리거 구문은 자동으로 생성됩니다 — 누군가가 이를 요청할 수 있는 8가지 평이한 언어 표현 —이며 이를 편집할 수 있습니다. 이는 일치용으로 사용되며 방문자에게 표시되지 않으며, 편집 내용은 재생성으로 인해 덮어쓰이지 않습니다.

스킬을 작성한 후 실행해 볼 가치가 있는 확인 작업이 하나 있습니다. 라이브러리에게 자체 트리거 구문 각각이 어떤 스킬을 검색하는지 물어보십시오. 만약 어떤 스킬의 자체 구문이 항상 다른 스킬로 반환된다면, 해당 스킬은 라이브러리에 있지만 도달할 수 없습니다. 항상 승리하는 스킬과 병합하거나, 두 스킬이 어떻게 다른지 명확히 명시하십시오.