도구 검색으로 필요할 때 도구 불러오기

소개

MCP 서버 및 기타 외부 도구를 코파일럿 CLI 연결하는 것은 강력하지만 추가하는 모든 도구에는 비용이 발생합니다. 즉, 해당 정의는 모델의 컨텍스트 창에서 공간을 차지하며, 긴 도구 메뉴를 사용하면 에이전트가 올바른 도구를 선택하기가 더 어려워집니다. 주문형 도구 로드(또는 "도구 검색")를 사용하면 에이전트가 사용하지 않는 도구에 대한 정의로 인해 컨텍스트 창이 복잡해지지 않습니다. 에이전트는 기본 제공 도구와 나머지를 조회하는 방법으로 시작한 다음 작업을 완료하는 데 필요한 경우에만 추가 도구를 로드합니다.

도구 검색은 점점 더 많은 도구와 관련된 두 가지 문제를 해결합니다.

낭비된 컨텍스트입니다. 수십 개의 도구 정의는 에이전트가 작업을 수행하기 전에 10~20K 토큰을 사용할 수 있습니다.
도구 선택 정확도가 저하되었습니다. 한 번에 수십 개의 도구가 표시되면 모델이 잘못된 도구에 도달할 가능성이 더 높습니다.

세션 중 발생하는 일

프롬프트를 입력할 때마다 CLI는 현재 도구 인벤토리를 확인하고 도구 검색을 사용할지 여부를 결정합니다. 약 30개의 도구 아래에서는 도구 검색을 통해 얻을 수 있는 절감액이 가치가 없으므로 코파일럿 CLI 도구 검색을 완전히 건너뛰고 모든 것을 로드합니다.

처음에는 도구 검색을 사용할 때 CLI의 기본 제공 도구만 로드됩니다. MCP 도구 및 기타 외부 도구와 같은 다른 모든 항목은 보류됩니다. 에이전트는 이러한 도구가 존재하고 대략적인 것을 볼 수 있지만 전체 정의는 아직 로드되지 않았습니다.

에이전트가 로드되지 않은 도구가 ��요한 단계에 도달하면 사용 가능한 도구에 대해 빠른 검색을 실행하고 가장 가까운 일치 항목을 컨텍스트로 가져옵니다. 그러면 이러한 도구는 대화가 끝날 때까지 계속 사용 가능하므로, 각 도구에 대한 조회는 처음 필요할 때 한 번만 수행됩니다.

첫 번째 조회는 모델과의 추가 교환 비용이 들지만 이후 턴마다 컨텍스트를 작게 유지하여 여러 번 다시 가져옵니다.

항상 로드되는 도구

소수의 도구가 도구 검색을 건너뛰고 즉시 준비됩니다.

코파일럿 CLI'의 기본 제공 도구(grep, glob, bash, edit 등).
deferTools: "never"로 구성한 MCP 서버의 도구 이 문서의 후반부에 있는 MCP 서버의 도구를 항상 로드된 상태로 유지하기를 참조하세요.
사용자 지정 에이전트에서 로드한 도구입니다. 이 문서의 뒷부 분에 있는 사용자 지정 에이전트에서 도구 지연 구성 을 참조하세요.

도구 검색을 사용하지 않도록 설정

도구 검색은 기본적으로 사용하도록 설정되며 지원되는 모델에 있을 때마다 자동으로 활성화되며, 연결된 도구가 충분히 있어 가치 있게 사용할 수 있습니다. 도구 검색을 사용하지 않도록 설정하고 모든 도구 로드로 돌아가려면 개인 설정에서 설정합니다 toolSearch: false . GITHUB COPILOT CLI 구성 디렉터리을(를) 참조하세요.

지원되는 모델

패밀리	지원되는 버전
클로드(앤트로픽)	Mythos Preview, Fable, Sonnet 4.0 이상, Opus 4.0 이상(하이쿠 아님)
GPT(OpenAI)	GPT-5.4 이상

다른 모델에서는 모든 도구가 앞에 로드됩니다.

MCP 서버의 도구가 항상 로드된 상태로 유지

경우에 따라 특정 MCP 서버의 도구가 항상 에이전트 앞에 배치되도록 할 수 있습니다(예: 도구가 지속적으로 사용되는 서버 또는 추가 검색 단계가 가치가 없는 서버). 각 MCP 서버에는 다음을 deferTools 제어하는 설정이 있습니다.

"auto" (기본값) - 서버의 도구는 다른 도구와 같이 동작하며 임계값을 초과하면 지연될 수 있습니다.
"never"- 다른 모든 항목에 대해 도구 검색이 활성화되어 있는 동안에도 서버의 도구는 항상 에이전트의 도구 목록에 포함됩니다.

이를 설정하는 가장 쉬운 방법은 슬래시 명령을 사용하는 /mcp edit 것입니다. MCP 서버를 편집하기 위한 양식에서 Defer Tools 를 Never로 전환합니다. ~/.copilot/mcp-config.json에서 직접 설정할 수도 있습니다:

{
    "mcpServers": {
        "my-server": {
            "type": "stdio",
            "command": "npx",
            "args": ["-y", "@example/mcp-server"],
            "deferTools": "never",
            "tools": ["*"]
        }
    }
}

사용자 지정 에이전트에서 도구 지연 구성

사용자 지정 에이전트가 해당 도구를 이름으로 나열하면 에이전트가 즉시 사용할 수 있도록 해당 도구가 항상 로드됩니다. 일반적으로 원하는 것이지만 에이전트가 큰 도구 집합을 선언하고 지정된 실행에서 그 중 몇 개만 터치하는 경우 도구 검색에 해당 목록을 다시 전달하여 모든 도구가 한 번에 로드되지 않고 필요에 따라 검색되도록 할 수 있습니다.

Markdown 에이전트(.github/agents/*.md)의 경우 프런트매터 앞부분에 deferred-tool-loading: true를 추가하세요:

---
name: my-agent
description: Works with a large catalog of tools
tools:
    - some_mcp_tool
    - another_mcp_tool
    # ...many more
deferred-tool-loading: true
---

Agent instructions here.

설정과 관련하여 다음 사항에 유의하세요 deferred-tool-loading .

도구 검색이 활성화된 경우에만 영향을 줍니다(즉, 임계값을 초과할 수 있는 충분한 도구가 있는 지원되는 모델에서).
도구 이름을 지정하는 에이전트의 경우에만 중요합니다. * 와일드카드를 사용하는 에이전트는 이미 도구 검색을 사용하고 있습니다.

도구 검색을 위한 도구 최적화

도구 검색은 에이전트가 각 도구의 이름, 설명 및 매개 변수 이름 및 설명에 대해 수행하려는 작업과 일치합니다. 명확한 특정 단어를 사용하면 올바른 요청에 대한 도구가 표시됩니다.

쉽게 찾을 수 있도록 도구가 하는 일이 드러나게 이름을 지정하세요.
사람들이 모호한 것이 아니라 실제로 검색할 단어로 설명을 작성합니다.

도구 검색으로 필요할 때 도구 불러오기

이 기사에서