Skip to main content
Glama

start_agent

Launches a subagent in the background and returns a jobId or conversationId immediately so you can delegate work without waiting, then check status or results separately.

Instructions

子をバックグラウンド実行しjobId/conversationIdを即返す。通常の委譲に推奨。完了待ちはwait_agents、最終結果はget_agent(途中イベントは明示要求時のみ)。full-accessは会話ごとの子プロセスで継続(mode=native)

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "provider": "<provider>",
      "model": "<model>",
      "task": "<task>"
    },
    "name": "start_agent"
  }
}

Input Schema

NameRequiredDescriptionDefault
cwdNo
roleNo
taskYes
filesNo
modelYes必須。許可済みの取得済みモデルID
effortNoEffort対応モデルでは必須。対応・許可済みの値のみ
contextNo
providerYesプロバイダーID
permissionNo省略時full-access(OSユーザー権限の範囲で標準編集・シェル)。read-only/workspace-writeは既存のCLI標準制限。brokeredではread-only/workspace-writeの明示が必須
timeout_msNo
json_schemaNo
conversation_idNo同じサーバーの完了した会話を継続するID
include_detailsNo同期結果に使用量・実行メタデータを含める。既定false。非同期結果はget_agentで指定
notify_progressNo同期実行の進捗通知を送る。既定false。バックグラウンド実行では通知しない
output_instructionsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

A4.2/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

アノテーションが無い中で、非同期実行・即時ID返却・full-accessが会話ごとの子プロセスで継続(mode=native)という挙動を開示している点は価値が高い。ただしbrokered時のpermission必須要件やタイムアウト挙動、エラー時の扱いには触れておらず、もう一歩の情報が欲しい。

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

冒頭で中核動作(バックグラウンド起動+即時ID返却)を提示し、その後に推奨用途と代替ツール、最後にfull-accessの補足という構成で無駄が少ない。ただし末尾の「full-accessは…(mode=native)」はやや圧縮され過ぎて意図が取りにくい。

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

出力スキーマが無い中で即時返却値(jobId/conversationId)と後続フロー(wait_agents/get_agent)を示しており主要導線は把握できる。しかし15パラメータの多様なオプションやエラー・タイムアウト時の挙動までは説明されておらず、複雑さに対して最低限の水準にとどまる。

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

スキーマ記述被覆率が47%と低く、15個のパラメータのうちtask、role、context、files、effort、json_schema、timeout_ms、notify_progress、output_instructionsなどの意味は説明で補われていない。conversation_idによる継続とpermissionの扱いには言及があり一定の補完はあるが、低カバレッジを埋め切れてはいない。

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

「子をバックグラウンド実行しjobId/conversationIdを即返す」は、動作(非同期起動)と資源(子エージェント)、および即時返却値(jobIdとconversationId)を具体的に述べている。同種のwait_agents/get_agentと明確に区別できる。

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

「通常の委譲に推奨」と用途を明示し、完了待ちはwait_agents、最終結果はget_agent、途中イベントは明示要求時のみ、と代替手段とその選択条件を列挙している。エージェントが迷わず選択できる。

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.