agent_send

Malha de agentes · macOS · Windows

Efeito: envio. 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

Envia uma mensagem de coordenação para um agente em ANOTHER das máquinas do usuário (obtenha seu identificador em agents_list). Use-o para suspender fusões durante um lançamento ('congelar'), anunciar que um PR está pronto ('pr-pronto'), entregar trabalho ('transferência') ou dizer que um lançamento foi enviado ('lançamento'). Sem to_agent ele atinge todos os agentes daquela máquina, que é o que você deseja para um congelamento. Um DIRECTED to_agent deve ser ALIVE - pegue-o de agents_list, nunca o invente: se não estiver vivo, você receberá um 404 listando o agent_ids que ARE está vivo naquela máquina, para que você possa endereçar-se novamente a um deles em vez de a mensagem ser perdida silenciosamente. O destinatário recebe na próxima enquete agent_inbox – isso não é instantâneo e não é uma solicitação que você possa forçar: o outro agente decide o que fazer.

Entradas obrigatórias

to
msg_type

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

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": {
    "from_agent": {
      "description": "Your own agent_id, so the recipient knows who is asking",
      "type": "string"
    },
    "msg_type": {
      "description": "One of: ping, pr-ready, freeze, freeze-clear, release-out, handoff, note",
      "type": "string"
    },
    "payload": {
      "description": "The content: reason, PR number, branch… Keep it small (max 16KB).",
      "type": "object"
    },
    "to": {
      "description": "Handle of the target machine, from agents_list",
      "type": "string"
    },
    "to_agent": {
      "description": "Optional: a single agent_id on that machine (it must have checked in). Omit to reach all of them.",
      "type": "string"
    }
  },
  "required": [
    "to",
    "msg_type"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para agent_send. 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.

{
  "msg_type": "note",
  "payload": {
    "message": "The documentation review is ready."
  },
  "to": "demo-workstation"
}

Windows