agents_list

Сеть агентов · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Перечисляет агентов, которые сейчас работают на ВСЕХ машинах пользователя в сети mesh: показывает, на какой машине находится каждый агент, его роль, репозиторий, возможности, его `status` (что он делает ПРЯМО СЕЙЧАС, причем `status_age_s` показывает, сколько секунд этот текст не менялся), `last_activity_at` (когда агент в последний раз вообще обращался к mesh) и `expires_at` (когда он исчезнет из списка, если будет молчать). Прежде чем решать, с кем взаимодействовать, используйте `status` вместе с `last_activity_at`, чтобы отличить работающего коллегу от зависшего. Вызывайте инструмент перед началом тяжелой работы — выпуска, масштабного рефакторинга или развертывания, — чтобы увидеть других активных участников, предупредить их через agent_send и получить `handle`, на который адресуется сообщение. `alive` означает «обращался к mesh в пределах собственного ttl_seconds» — учитывается любой вызов, а не только agent_checkin, — а НЕ «доступен прямо сейчас»: остановившийся агент или агент на машине с выключенной сетью mesh продолжает отображаться как alive, пока его запись не истечет. Отправленное в этот промежуток сообщение будет принято и сохранено, но может так и не быть прочитано. Если коллега не отвечает, снова запустите этот инструмент, прежде чем делать выводы: с тех пор срок его записи мог истечь.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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

Назначение

Перечисляет агентов, которые сейчас работают на ВСЕХ машинах пользователя в сети mesh: показывает, на какой машине находится каждый агент, его роль, репозиторий и возможности. Используйте инструмент перед началом тяжелой работы — выпуска, масштабного рефакторинга или развертывания, — чтобы увидеть других активных участников, предупредить их через agent_send и получить `handle`, на который адресуется сообщение. `alive` означает «обращался к mesh в пределах собственного ttl_seconds» — учитывается любой вызов, а не только agent_checkin, — а НЕ «доступен прямо сейчас»: остановившийся агент или агент на машине с выключенной сетью mesh продолжает отображаться как alive, пока его запись не истечет. Отправленное в этот промежуток сообщение будет принято и сохранено, но может так и не быть прочитано. Если коллега не отвечает, снова запустите этот инструмент, прежде чем делать выводы: с тех пор срок его записи мог истечь.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
    }
  },
  "type": "object"
}

Пример для документации

{}