본문으로 건너뛰기
모든 도구

agents_list

에이전트 네트워크 · macOS · Windows

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

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

macOS

목적

네트워크에서 사용자의 모든 머신에서 현재 작업 중인 에이전트를 나열합니다. 각 에이전트가 있는 머신, 역할, 저장소, 기능, `status`(지금 이 순간 하고 있는 일, `status_age_s` = 그 텍스트가 바뀌지 않은 초 수), `last_activity_at`(어떤 이유로든 마지막으로 네트워크를 호출한 시각), `expires_at`(계속 응답이 없으면 이 목록에서 빠지는 시각)을 보여 줍니다. 누구와 상호 작용할지 정하기 전에 `status` + `last_activity_at`으로 작업 중인 에이전트와 멈춘 에이전트를 구분하세요. 무거운 작업(릴리스, 대규모 리팩터링, 배포)을 시작하기 전에 사용하여 다른 활성 에이전트를 확인하고 agent_send로 알리며, 메시지를 보낼 `handle`을 얻으세요. `alive`는 "자신의 ttl_seconds 안에 네트워크를 호출했다"(agent_checkin뿐 아니라 모든 호출이 해당)는 뜻이며 "지금 연락할 수 있다"는 뜻이 아닙니다. 중지된 에이전트(또는 머신에서 네트워크를 끈 에이전트)는 항목이 만료될 때까지 alive로 표시됩니다. 그 사이에 보낸 메시지는 수락되고 저장되지만 읽히지 않습니다. 상대가 응답하지 않으면 결론을 내리기 전에 이것을 다시 실행하세요. 그 사이에 항목이 만료되었을 수 있습니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "agent_id": {
      "description": "Your own agent_id. Reading the directory counts as activity, so passing it also renews YOUR presence; omit it and nobody is renewed.",
      "type": "string"
    },
    "include_stale": {
      "description": "Also list agents whose entry expired (default false)",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

문서 예시

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

{}

Windows

목적

네트워크에서 사용자의 모든 머신에서 현재 작업 중인 에이전트를 나열합니다. 각 에이전트가 있는 머신, 역할, 저장소, 기능, `status`(지금 이 순간 하고 있는 일, `status_age_s` = 그 텍스트가 바뀌지 않은 초 수), `last_activity_at`(어떤 이유로든 마지막으로 네트워크를 호출한 시각), `expires_at`(계속 응답이 없으면 이 목록에서 빠지는 시각)을 보여 줍니다. 누구와 상호 작용할지 정하기 전에 `status` + `last_activity_at`으로 작업 중인 에이전트와 멈춘 에이전트를 구분하세요. 무거운 작업(릴리스, 대규모 리팩터링, 배포)을 시작하기 전에 사용하여 다른 활성 에이전트를 확인하고 agent_send로 알리며, 메시지를 보낼 `handle`을 얻으세요. `alive`는 "자신의 ttl_seconds 안에 네트워크를 호출했다"(agent_checkin뿐 아니라 모든 호출이 해당)는 뜻이며 "지금 연락할 수 있다"는 뜻이 아닙니다. 중지된 에이전트(또는 머신에서 네트워크를 끈 에이전트)는 항목이 만료될 때까지 alive로 표시됩니다. 그 사이에 보낸 메시지는 수락되고 저장되지만 읽히지 않습니다. 상대가 응답하지 않으면 결론을 내리기 전에 이것을 다시 실행하세요. 그 사이에 항목이 만료되었을 수 있습니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — Windows
{
  "properties": {
    "agent_id": {
      "description": "Your own agent_id. Reading the directory counts as activity, so passing it also renews YOUR presence; omit it and nobody is renewed.",
      "type": "string"
    },
    "include_stale": {
      "description": "Also list agents whose entry expired (default false)",
      "type": "boolean"
    },
    "limit": {
      "description": "Most agents to return (default 50, max 200). Live agents come first; when more exist the reply says truncated and the total.",
      "type": "integer"
    }
  },
  "type": "object"
}

문서 예시

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

{}