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, пока его запись не истечёт. Сообщение, отправленное в этот промежуток, принимается и сохраняется, но так и не читается. Если агент не отвечает, запустите это снова, прежде чем делать выводы: его запись могла уже истечь.

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

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

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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

Назначение

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

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

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях 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"
    },
    "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"
}

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

{}