Skip to main content
Glama
zamatewi-cell

Codex Antigravity Subagent MCP

by zamatewi-cell
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

后台启动 Gemini 子代理

start_gemini_task
Destructive

Starts an Antigravity/Gemini background task and returns a job ID for later retrieval with get_gemini_task, designed for long-running operations like /teamwork-preview.

Instructions

后台启动 Antigravity/Gemini 任务并立即返回 job_id，适合 /teamwork-preview 等长任务。之后用 get_gemini_task 查询；后台任务依赖当前 MCP 服务进程保持运行。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modeNoAntigravity 执行模式。plan 只规划；accept-edits 允许提出和执行修改。
agentNo可选的 Antigravity agent 名称。
modelNoAntigravity 模型名；默认 gemini-3.8-flash-high。
effortNo推理强度。
promptYes交给 Gemini 的完整提示词。保留开头的系统斜杠指令，并在末尾补充绝对工作目录，例如：/teamwork-preview <完整任务>。
projectNo可选的 Antigravity project ID 或名称。
new_projectNo为本次调用新建 Antigravity project。
session_modeNoAGY 运行轨道模式：print 为常规单次委托执行（自动化/批量），stream 为交互式流传输长会话（支持多轮人机交互）。print
add_directoriesNo额外加入 AGY 工作区的目录。
continue_latestNo继续最近一次 Antigravity 会话。
conversation_idNo继续指定 Antigravity 会话；值来自上一次结果的 conversation_id。
permission_modeNoAntigravity 权限模式；默认 auto-approve（auto-approve 确保在无头 headless 模式下工具调用免人工交互确认）。auto-approve
timeout_secondsNo单次 AGY 运行超时，30 到 21600 秒。Teamwork 长任务应提高该值或使用后台任务工具。
working_directoryNoGemini 工作目录的绝对路径。涉及当前仓库时必须传入当前 Codex 工作目录。

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv1.5.3
    • addedInput schema / properties / session_mode
      Added value: +{
+  "default": "print",
+  "description": "AGY 运行轨道模式：print 为常规单次委托执行（自动化/批量），stream 为交互式流传输长会话（支持多轮人机交互）。",
+  "enum": [
+    "print",
+    "stream"
+  ],
+  "type": "string"
+}
  2. First observedv1.3.0

TDQS

A3.9/5.0
Behavior3/5

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

标注已声明 readOnlyHint=false、destructiveHint=true，描述没有与标注矛盾。描述补充了标注之外的有用行为信息：任务依赖 MCP 进程存活、异步返回 job_id 的工作流。但鉴于标注已标记破坏性操作，描述并未就破坏性影响、权限需求或安全性提供额外语境，对高破坏性的工具来说披露不够充分。

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

Conciseness5/5

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

仅两句描述，核心异步语义前置，随后的进程依赖警告和查询指引都是必要信息，无冗余。结构与篇幅对该工具恰到好处。

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?

工具复杂度高（14 参数、4 个枚举、无输出 schema），描述虽交代了异步工作流（返回 job_id、用 get_gemini_task 查询）和进程依赖，但未说明返回值结构或其他操作细节。由于无输出 schema，描述本应承担更多返回信息说明职责；params 已由 schema 100% 覆盖，整体基本够用但偏薄。

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?

Schema 描述覆盖率达 100%，所有 14 个参数（含 prompt 的斜杠指令与工作目录示例、permission_mode 的 headless 说明、timeout 的 teamwork 建议）均已由 schema 文档化。描述本身未添加参数级信息，仅提及返回 job_id。在高覆盖场景下取基线 3 分，schema 已承担主要说明职责。

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?

描述明确表述了具体动词（后台启动）、资源（Antigravity/Gemini 任务）和模式（立即返回 job_id 的异步行为），并指出适用于 /teamwork-preview 等长任务。通过'后台'和'立即返回 job_id'的表述与 get_gemini_task（查询）以及 delegate_to_gemini（很可能为同步）等兄弟工具清晰区分。虽然未显式点名 delegate_to_gemini，但异步语义本身已足够区分。

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

Usage Guidelines4/5

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

描述给出了明确的使用场景——'适合 /teamwork-preview 等长任务'，并指出后续用 get_gemini_task 查询，还警示后台任务依赖 MCP 服务进程保持运行，这是重要的使用前提。但未明确说明何时不该使用（如短任务或需要交互的场景），也未点名 delegate_to_gemini 作为同步替代方案，缺少明确的排除性指引。

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

Deploy Server

Other Tools