search_emails

macOS

목적

사용자가 이 Mac의 Apple Mail(Mail.app에 추가된 모든 계정)에서 특정 이메일을 찾으려 할 때 사용합니다. 기본적으로 제목과 발신자를 검색하며, 메시지 본문도 검색하려면 scope="body" 또는 scope="all"을 전달하세요. 응답의 search_coverage를 확인하세요. 로컬 색인이 구축 중이면 본문 검색이 부분적일 수 있습니다. Mail.app에 추가되지 않은 Microsoft 365 사서함에는 m365_search_emails를 사용하세요. 중요: 계정이 2개 이상인 컴퓨터에서는 list_email_accounts의 account=<name>으로 호출하세요. 이 값이 없고 빠른 색인이 답할 수 없으면 search_emails는 모든 계정을 검색하는 대신 계정 목록을 반환합니다. 한 번의 호출로 모든 계정을 검색하면 시간 제한이 없고 다른 요청에 대한 Mail도 차단할 수 있습니다. 계정이 정확히 하나이면 영향을 받지 않습니다.

필수 입력

• query

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

권한 및 확인

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

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

{
  "properties": {
    "account": {
      "type": "string"
    },
    "limit": {
      "default": "20",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "mailbox": {
      "type": "string"
    },
    "query": {
      "type": "string"
    },
    "scope": {
      "default": "metadata",
      "description": "\"metadata\" (default, subject+sender — fast, unchanged behavior), \"body\" (message body only, via a local index — see search_coverage in the response), or \"all\" (subject+sender+body).",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

문서 예시

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

{
  "query": "launch checklist"
}