팁
권장: 지원되는 프로 코드 선언적 에이전트 및 플러그인 시나리오에 대한 Work IQ Dev 도구 로 시작하십시오. WIQD 빠른 시작을 참조하세요. 도구 키트 기반 지침은 이를 필요로 하는 기존 프로젝트 및 워크플로에 계속 사용할 수 있습니다. 도구를 선택하기 전에 기능 및 대상 환경 지원을 확인하세요. WIQD는 사용자 지정 엔진 에이전트를 대상으로 하지 않습니다.
플러그 인을 사용하면 Microsoft 365 Copilot의 선언적 에이전트가 MCP(모델 컨텍스트 프로토콜) 서버 또는 REST API를 호출하여 데이터를 검색하고 작업을 수행할 수 있습니다. Microsoft 365 Copilot은 인터넷을 통해 MCP 또는 API 서버에 연결해야 합니다. 일반적으로 디버깅 도구는 디버깅 도구를 실행하는 컴퓨터에서만 액세스할 수 있는 (127.0.0.1)에서 localhost 디버그 세션을 호스팅합니다.
개발 터널과 같은 역방향 프록시를 사용하면 디버그 세션을 인터넷에 노출하여 Microsoft 365 Copilot에서 호출을 디버깅할 수 있습니다.
이 문서에서는 MCP 서버 또는 API에 대한 로컬 디버깅을 사용하도록 도구를 사용하는 방법을 devtunnel 보여줍니다.
참고
디버깅 도구가 이미 역방향 프록시 솔루션을 제공할 수 있습니다. 개발자 도구의 설명서에서 확인하는 것이 좋습니다. 예를 들어 Microsoft 365 에이전트 도구 키트를 사용하여 새 API를 만든 경우 도구 키트에서 역방향 프록시 구성을 처리합니다.
필수 구성 요소
-
devtunnel디버그 세션을 호스트하는 컴퓨터에 설치된 CLI - 디버깅 도구에서 사용하는 HTTP 포트 번호입니다
영구 개발 터널 만들기
devtunnel CLI를 사용하면 호스트된 URL을 변경하지 않고 필요에 따라 중지하고 시작할 수 있는 터널인 영구 개발 터널을 만들 수 있습니다. 영구 URL이 있는 터널을 사용하면 선언적 에이전트 앱 패키지를 새 URL로 업데이트할 필요가 없으므로 플러그인에 대한 디버깅이 간소화됩니다.
devtunnel CLI에 아직 로그인하지 않은 경우 사용 가능한 옵션을 확인하는 데 사용합니다
devtunnel user login --help. 계속하기 전에 CLI에 로그인합니다.익명 액세스를 허용하는 터널을 만듭니다. 익명 액세스는 Microsoft 365 Copilot이 터널에 액세스할 수 있도록 하는 데 필요하며 API에 필요한 인증과 관련이 없습니다.
devtunnel create --allow-anonymous팁
새 터널을 생성하면 기본 터널이 새로 생성된 터널로 전환됩니다. 이렇게 하면 후속 명령에 대한 인수를 생략
tunnel-id할 수 있습니다. 여러 터널을 만드는 경우 인수를tunnel-id사용하여 예상 터널을 사용하고 있는지 확인해야 할 수 있습니다. 자세한 내용은 명령을 사용devtunnel --help하거나 개발 터널 명령줄 참조를 참조하세요.디버깅 도구에서 사용하는 HTTP 포트 번호를 추가합니다. 포트 번호로 바꾸
<port>고 디버깅 도구가 포트에서 HTTPS를 사용하는 경우 또는httpHTTPS를 사용하지 않는 경우 매개 변수https를--protocol설정합니다.devtunnel port create --port-number <port> --protocol https개발 터널을 시작합니다.
devtunnel host이 개발 터널을 처음 실행하는 경우 브라우저를 통해 연결이라고 레이블이 지정된 URL을 복사합니다. 브라우저에서 이 URL을 열고 계속을 선택하여 터널을 사용하도록 설정합니다.
참고
계속을 선택하면 브라우저에 오류가 표시됩니다. 이는 예상된 것이며 무시될 수 있습니다.
터널이 활성화되면 CTRL + C를 사용하여 터널을 중지할 수 있습니다. 명령을 사용하여 터널을 다시 시작할 수 있습니다.devtunnel host host-id
개발자 터널 사용
디버깅에 개발 터널을 사용하려면 서버 URL 대신 개발 터널의 URL을 사용하여 앱 패키지를 사이드로드합니다.
플러그 인 매니페스트 내에서 MCP 서버 사양 개체의 속성을 설정합니다url.
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "<your-dev-tunnel-url>",
}
}
]
Visual Studio Code에서 에이전트 도구 키트를 사용하여 선언적 에이전트를 관리하는 경우 환경 변수를 /env/.env.dev.user 파일에 PLUGIN_SERVER_URL 추가하고 개발 터널 URL 대신 사용할 수 있습니다.
수명 주기 창의 프로비저닝 단계를 사용하여 에이전트를 사이드로드합니다.
/env/.env.dev.user 파일에 다음을 추가합니다.
OPENAPI_SERVER_URL=<your-dev-tunnel-url>
플러그인 매니페스트에서 속성을 업데이트합니다.url
"runtimes": [
{
"type": "RemoteMCPServer",
"spec": {
"url": "${{PLUGIN_SERVER_URL}}",
}
}
]
에이전트 도구 키트를 사용하지 않는 경우 새 앱 패키지 ZIP 파일을 생성하고 에이전트를 업로드할 수 있습니다.