Google Antigravity SDK 是一个用于设计、实现和调试自主 AI 智能体及多智能体系统的 Python SDK。本技能围绕该 SDK 提供安装配置指引、主题路由、参考文档和示例代码，帮助开发者快速上手并深入使用。
用途 该技能适用于使用 Google Antigravity（AGY）SDK 构建自主 AI 智能体和多智能体系统的场景。当用户希望设计、实现或调试此类智能体时，可激活本技能获取相应指导。
安装与设置 在开始任何 Google Antigravity 任务前，需确保环境就绪：验证在现有代码库中使用该 Python SDK 是否可行且合适；检查项目依赖（如 requirements.txt、pyproject.toml）中是否列出 google-antigravity；确保已安装 google-antigravity Python 包；检查是否存在有效的 GEMINI_API_KEY 环境变量或 .env 文件（访问 Gemini 模型所必需）。若缺少凭据，需主动帮助用户获取 API 密钥，默认指向 Google AI Studio：https://aistudio.google.com/app/api-keys。API 密钥可在代码中显式传入（如 LocalAgentConfig(api_key="...")），也可自动从环境读取。
主要能力与参考文档 技能提供主题路由，按用户需求指向相应参考文件：
- 架构总览与核心概念（Agent、Conversation、Connection）：references/architecture.md
- 高级智能体配置、模型选择及模型标识符规则：references/agent_configuration.md
- 集成 Model Context Protocol（MCP）服务器、配置工具权限：references/mcp_integration.md
- 定义安全策略、解析执行顺序、用谓词限制智能体操作：references/safety_policies.md
- 调试失败智能体、流式日志、用钩子实现错误恢复：references/error_handling.md
- 监控成本、跟踪 token 用量（含思考 token）、构建自定义审计日志：references/observability.md
- 内置工具列表及其默认状态：references/built_in_tools.md
示例 技能提供入门示例，覆盖：基础智能体行为、流式响应与内部思考展示（hello_world.md）；基于 Python 函数的自定义工具及跨工具执行保持状态（custom_tool.md）；人格塑造、系统指令与动态行为（persona_config.md）；处理图像和 PDF 及生成视觉内容的多模态智能体（multimodal.md）；多智能体委派与子智能体编排（subagents.md）；通过 MCP（Stdio 或 SSE）连接外部服务（mcp_tools.md）；响应时间事件或文件系统触发的后台主动智能体（periodic_trigger.md）；拦截智能体生命周期事件（如回合前后、工具执行、错误）以定制执行流程（hooks.md）；跨会话记忆的持久化智能体（persistence.md）；覆盖默认应用数据目录（app_data_dir_override.md）；输出符合 Pydantic schema 的结构化数据（structured_output.md）；向 SDK 智能体添加、配置或加载智能体技能（agent_skills.md）。
适用场景 适合需要构建自主智能体、多智能体系统、工具集成、MCP 连接、安全策略、可观测性、持久化记忆或结构化输出的 Python 开发项目。
限制 使用需具备有效的 GEMINI_API_KEY 以访问 Gemini 模型；具体功能、收费、价格、平台支持及效果等细节以官方资料为准，本技能资料中暂未提供。