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 que estão trabalhando agora em TODAS as máquinas do usuário na malha: em qual máquina cada um está, sua função, repositório, capacidades, seu `status` (o que está fazendo NESTE MOMENTO, com `status_age_s` = há quantos segundos esse texto não muda), `last_activity_at` (a última vez que chamou a malha, por qualquer motivo) e `expires_at` (quando sai desta lista se continuar em silêncio). Use `status` + `last_activity_at` para distinguir um par que está trabalhando de um travado antes de decidir com quem interagir. Use antes de começar um trabalho pesado (uma release, uma refatoração ampla, um deploy) para ver quem mais está ativo e avisá-lo com agent_send, e para obter o `handle` ao qual você endereça uma mensagem. `alive` significa "chamou a malha dentro do seu próprio ttl_seconds" (qualquer chamada conta, não só agent_checkin), NÃO "está acessível agora": um agente que parou (ou cuja máquina desligou a malha) continua aparecendo como alive até sua entrada expirar. Uma mensagem enviada nesse intervalo é aceita e armazenada, e simplesmente nunca é lida. Se um par não responder, execute isto de novo antes de concluir qualquer coisa: a entrada dele pode ter expirado nesse meio-tempo.
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.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
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 que estão trabalhando agora em TODAS as máquinas do usuário na malha: em qual máquina cada um está, sua função, repositório, capacidades, seu `status` (o que está fazendo NESTE MOMENTO, com `status_age_s` = há quantos segundos esse texto não muda), `last_activity_at` (a última vez que chamou a malha, por qualquer motivo) e `expires_at` (quando sai desta lista se continuar em silêncio). Use `status` + `last_activity_at` para distinguir um par que está trabalhando de um travado antes de decidir com quem interagir. Use antes de começar um trabalho pesado (uma release, uma refatoração ampla, um deploy) para ver quem mais está ativo e avisá-lo com agent_send, e para obter o `handle` ao qual você endereça uma mensagem. `alive` significa "chamou a malha dentro do seu próprio ttl_seconds" (qualquer chamada conta, não só agent_checkin), NÃO "está acessível agora": um agente que parou (ou cuja máquina desligou a malha) continua aparecendo como alive até sua entrada expirar. Uma mensagem enviada nesse intervalo é aceita e armazenada, e simplesmente nunca é lida. Se um par não responder, execute isto de novo antes de concluir qualquer coisa: a entrada dele pode ter expirado nesse meio-tempo.
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.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
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"
},
"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"
}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.
{}