web_navigate

웹 자동화 · macOS · Windows

효과: 보내기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

웹 세션을 URL로 이동하고(저장된 로그인이 있으면 사용) 결과 URL과 페이지 제목을 반환합니다. 세션이 없으면 엽니다. 읽기 전에 `loaded`를 확인하세요. false이면 페이지가 로드되지 않은 것이며 `message`가 이유를 알려 줍니다. 그 상태에서 세션을 읽으면 사이트가 아니라 빈 문서를 설명하게 됩니다. 페이지는 web_read로 읽으세요. 호출이 클라우드 커넥터를 통해 들어오면 이 Mac 또는 로컬 네트워크의 주소(localhost, 127.0.0.1, 192.168.x.x…)는 모든 web_* 도구에서 relay_local_address로 거부됩니다. Mac 자체에서 실행되는 AI 앱에는 이 제한이 없습니다.

필수 입력

url

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — macOS

{
  "properties": {
    "session": {
      "description": "Session name (default 'default').",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

문서 예시

web_navigate 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "session": "demo-browser",
  "url": "https://example.com"
}

Windows

목적

웹 세션을 URL로 이동하고(저장된 로그인이 있으면 재사용) 결과 URL과 페이지 제목을 반환합니다. 세션이 아직 없으면 엽니다. 이후 web_read로 페이지를 읽으세요. 첫 번째 호출은 미리보기를 반환하며 아무것도 열지 않고, confirm=true로 설정하면 이동합니다.

필수 입력

url

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

영문 정식 기술 스키마 — Windows

{
  "properties": {
    "confirm": {
      "description": "Must be true to act. Without it, returns a preview.",
      "type": "boolean"
    },
    "session": {
      "description": "Session name (a named login profile). Defaults to 'default'.",
      "type": "string"
    },
    "timeout_seconds": {
      "description": "Max seconds to wait for the page to load (default 25).",
      "type": "integer"
    },
    "url": {
      "description": "URL to open (https assumed if no scheme).",
      "type": "string"
    }
  },
  "required": [
    "url"
  ],
  "type": "object"
}

문서 예시

{
  "confirm": false,
  "session": "demo-browser",
  "url": "https://example.com"
}