Todas as ferramentas

agents_list

Malha de agentes · macOS · Windows

Efeito: leitura. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Lista os agentes atualmente trabalhando nas máquinas do usuário ALL na malha - em qual máquina cada um está, sua função, repositório, capacidades, seu `status` (o que está fazendo RIGHT NOW, com `status_age_s` = quantos segundos esse texto permaneceu inalterado), `last_activity_at` (a última vez que chamou o mesh) e `expires_at` (quando ele sai desta lista se permanecer em silêncio). Use `status` + `last_activity_at` para diferenciar um colega de trabalho de um preso antes de decidir com quem interagir. Use-o antes de iniciar o trabalho pesado (um lançamento, uma refatoração ampla, uma implantação) para ver quem mais está ativo e avisá-los com agent_send, e para obter o `handle` para o qual você endereça uma mensagem. `alive` significa "chamou a malha dentro de seu próprio ttl_seconds" - qualquer chamada conta, não apenas agent_checkin - NOT "está acessível agora": um agente que parou (ou cuja máquina desligou a malha) ainda lê alive até que sua entrada expire. Uma mensagem enviada nessa janela é aceita e armazenada e simplesmente nunca é lida. Se um par não responder, execute novamente antes de concluir qualquer coisa — sua entrada pode ter expirado desde então.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para agents_list. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{}

Windows

Finalidade

Lista os agentes atualmente trabalhando nas máquinas ALL do usuário na malha — em qual máquina cada um está, sua função, repositório e recursos. Use-o antes de iniciar o trabalho pesado (um lançamento, uma refatoração ampla, uma implantação) para ver quem mais está ativo e avisá-los com agent_send, e para obter o `handle` ao qual você endereça uma mensagem. `alive` significa "chamou a malha dentro de seu próprio ttl_seconds" — qualquer chamada conta, não apenas agent_checkin — NOT "está acessível agora": um agente que parou (ou cuja máquina desligou a malha) ainda lê alive até que sua entrada expire. Uma mensagem enviada nessa janela é aceita e armazenada e simplesmente nunca é lida. Se um par não responder, execute novamente antes de concluir qualquer coisa — sua entrada pode ter expirado desde então.

Entradas obrigatórias

O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

Esquema técnico canónico em inglês — 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"
}

Exemplo documental

Exemplo de documentação para agents_list. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{}