utility 모듈

도구 구성 요소에 대한 유틸리티 함수를 제공합니다.

함수

build_mcp_server_url

기본 URL 및 서버 이름을 사용하여 전체 MCP 서버 URL을 생성합니다.

build_mcp_server_url(server_name: str) -> str

매개 변수

Name Description
server_name
필수
str

MCP 서버 이름입니다.

반품

형식 Description
str

전체 MCP 서버 URL입니다.

get_chat_history_endpoint

MCP 플랫폼에 채팅 기록을 보내기 위한 채팅 기록 엔드포인트 URL을 가져옵니다.

get_chat_history_endpoint() -> str

반품

형식 Description
str

채팅 기록 엔드포인트 URL입니다.

get_mcp_base_url

MCP 서버의 기본 URL을 가져옵니다.

get_mcp_base_url() -> str

반품

형식 Description
str

MCP 서버의 기본 URL입니다.

get_mcp_platform_authentication_scope

MCP 플랫폼 인증 범위를 가져옵니다.

get_mcp_platform_authentication_scope() -> list[str]

반품

형식 Description
list[str]

적절한 MCP 플랫폼 인증 범위를 포함하는 목록입니다.

get_tooling_gateway_for_digital_worker

지정된 디지털 작업자에 대한 도구 게이트웨이 URL을 가져옵니다.

get_tooling_gateway_for_digital_worker(agentic_app_id: str) -> str

매개 변수

Name Description
agentic_app_id
필수
str

디지털 작업자의 에이전트 앱 식별자입니다.

반품

형식 Description
str

디지털 작업자에 대한 도구 게이트웨이 URL입니다.

is_development_environment

현재 환경이 개발로 구성된 경우 True를 반환합니다.

해결 순서(비어있지 않은 첫 번째 값이 우선):

  1. PYTHON_ENVIRONMENT — 현재 샘플에 사용되는 명시적 Python SDK 변수입니다.
  2. ENVIRONMENT — 레거시 Python SDK 변수(이전 버전과의 호환성).
  3. ASPNETCORE_ENVIRONMENT - Azure 호스팅 규칙.
  4. DOTNET_ENVIRONMENT — 제네릭 호스트 규칙입니다.
  5. "Development" 위의 항목이 설정되지 않은 경우의 기본값입니다.

PYTHON_ENVIRONMENT ENVIRONMENT 호스트 프로세스도 설정하는 ASPNETCORE_ENVIRONMENT경우 명시적으로 설정한 ENVIRONMENT=Production 에이전트가 영향을 받지 않도록 먼저 확인됩니다.

is_development_environment() -> bool

반품

형식 Description
bool

확인된 환경이 "개발"(대/소문자를 구분하지 않는 경우)이면 True입니다.

resolve_token_scope_for_server

지정된 MCP 서버에 대해 요청하도록 OAuth 범위를 확인합니다.

V2 서버는 고유한 대상 그룹을 audience 필드에 전달합니다(GUID 또는 api:// URI 형식). 명시적 scope (예: "Tools.ListInvoke.All")이 제공되면 범위는 다음과 입니다 {audience}/{scope}. 범위가 없는 {audience}/.default 경우 사용됩니다(사전 동의된 범위에 의존). V1 서버(대상 그룹 없음, 대상 그룹은 완전 GUID 또는 api:// URI 형식의 공유 ATG AppId와 같음)는 항상 공유 ATG /.default 범위로 대체됩니다.

resolve_token_scope_for_server(server: MCPServerConfig) -> str

매개 변수

Name Description
server
필수
MCPServerConfig

범위를 확인할 MCP 서버 구성입니다.

반품

형식 Description
str

OAuth 범위 문자열(예: "<guid>/Tools.ListInvoke.All""api://<guid>/.default"공유 ATG"<atg-guid>/.default")