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"
}

ドキュメント例

{}