lattice-sdk-integration

构建 Lattice 集成

将 Lattice Sandboxes 用于快速实现 0 → 0.9 集成。默认身份验证方式是 环境令牌。不要猜测具体值——应从正确的来源获取，具体取决于你需要的事实类型。

事实优先级——按事实类型区分：

• 枚举字面值、字段名称、protobuf 消息／服务名称、身份验证标头 → 安装并检查适用于你所用语言的 Lattice SDK（权威来源——安装最新版本）→ enum-literals.generated.md 快照（便于查阅，但可能滞后）→ 文档（备用来源）。
• REST URL 路径（例如 /api/v1/entities）→ REST OpenAPI 规范：https://developer.anduril.com/openapi/rest.json。路径不包含在已安装的 SDK 中——生成的客户端会通过 entities.publish_entity(...) 等方法对其进行抽象，因此检查 SDK 永远无法发现这些路径。请改为获取该规范。
• gRPC 接口（RPC、消息结构）→ 已安装／生成的存根，以及用于浏览的 gRPC 参考：https://developer.anduril.com/reference/grpc。
• 文档中的其他内容 → 从 https://developer.anduril.com/llms.txt 开始，这是 AI Agent 站点地图（在任何文档页面 URL 后附加 .md，即可获取简洁的 Markdown）。

与沙盒进行一次实时往返测试，才算完成。

集成路径

先对集成进行分类，再阅读相关参考资料，然后编写代码：

构建内容……	路径	详情
从某个来源发布实体／轨迹	Entity publisher	<references/entity-fields.md>, <references/enums.md>
接收并执行任务的可执行任务 Agent	Task agent	<references/task-lifecycle.md>
监视／使用实体流	Watcher / consumer	<references/entity-fields.md>
上传或附加媒体／文件	Object / media (REST-only)	<references/objects-api.md>
将外部系统桥接到 Lattice	Bridge	<references/protocol-selection.md>
不确定使用 REST 还是 gRPC	Protocol decision	<references/protocol-selection.md>
向 Sandbox 进行身份验证	Auth	<references/auth-and-deployment.md>

回答任何集成问题或编写代码之前，请先阅读相关参考文件。

关键规则

• 不要猜测枚举字面值、字段名、任务规范 URL、protobuf 消息／服务名称或认证标头。请检查已安装的 SDK——参见 enums.md。对于 REST URL 路径，请获取 OpenAPI 规范（参见上文的事实优先级划分）；SDK 中不包含这些路径。
• 通过导入／解析探测检测 SDK——绝不要搜索文件系统。 使用一次性导入检查 SDK 是否已安装（Python：python -c "import anduril, inspect, os; print(os.path.dirname(inspect.getfile(anduril)))"，或 pip show anduril-lattice-sdk； node -p "require.resolve('@anduril-industries/lattice-sdk')"；go list -m github.com/anduril/lattice-sdk-go）。如果未安装，请安装（pip install anduril-lattice-sdk 等）——安装才是正确的第一步，不是备用方案。不要使用 find／grep 在文件系统中搜寻 Lattice 类或 SDK 文件。
• 完成的定义是进行一次实时往返验证。 进程顺利运行或读取自己的日志都不能证明任何事情——Any 类型的枚举陷阱意味着错误值在本地会通过，但只会在服务端被拒绝。请针对沙箱发布／执行，并在单独的步骤中读回数据。
• 默认使用环境令牌认证；绝不硬编码或记录凭据。 如果缺少凭据，请询问用户——不要自行编造（参见 auth-and-deployment.md）。
• 仅限沙箱。 此插件的工作止于沙箱验证；不要延伸到生产租户的指导。
• 不要假定使用 Python 或 REST。 优先采用代码库现有的语言，并审慎选择协议。

工作流

1. 分类：使用上方的路由表对集成进行分类。
2. 提取四个维度：从用户或代码库中提取语言、协议、认证方式和部署目标。信息不明确时，建议一种协议 （protocol-selection.md）；由用户确认或更改。
3. 尽量精简语言指导——优先使用代码库的语言；对于 REST，优先使用有文档的 SDK；对于 gRPC，优先使用生成的存根。不要强迫用户切换语言。
4. 选择认证方式和目标（auth-and-deployment.md）： 默认使用环境令牌 + 沙箱令牌；可改用 OAuth 客户端凭据。
5. 根据准确的契约构建。 检查已安装的 SDK，确认字面值、字段名和消息名称（如果尚未安装，请先安装——使用导入探测，而不是搜索文件系统）。对于 REST URL 路径，请获取 REST OpenAPI 规范——SDK 中不包含这些路径。不要猜测。
6. 完整映射源数据。 填充源数据确实提供了有效信息的所有字段 （entity-fields.md）；不要编造值。
7. 针对沙箱进行实时验证，并在单独的步骤中读回数据。
8. 使用 Lattice 术语解释结果（lattice-terminology.md），仅介绍集成实际使用的 API。

按协议交接

• REST → 按照 lattice-rest-integration 技能操作。
• gRPC → 按照 lattice-grpc-integration 技能操作。

参考索引

• protocol-selection.md — REST 与 gRPC 的决策树。
• auth-and-deployment.md — 沙盒身份验证：优先使用环境变量的默认值、覆盖项和注意事项。
• entity-fields.md — 实体在操作层面完整所需的内容。
• enums.md — 如何获取精确的字面值（检查 SDK）以及开放字符串枚举陷阱。
• enum-literals.generated.md — 枚举字面值快照（自动生成；可能落后于 SDK）。
• task-lifecycle.md — 可执行任务的 Agent 生命周期不变量 + Python 示例。
• objects-api.md — 仅限 REST 的对象存储和媒体附件。
• lattice-terminology.md — 验证后使用的简洁说明用语。

重要文档（API 概览）

当请求不符合上面任何一行的内容时，请查阅 Lattice 文档。了解各项资料的用途：

• llms.txt — 从这里开始探索文档。 包含所有指南、参考资料和示例的 AI Agent 站点地图。为任意文档页面 URL 添加 .md，即可获取简洁的 Markdown。
• REST OpenAPI 规范 — 可获取的 REST 契约（/api/v1/... 路径、请求/响应架构）。REST URL 路径的来源。
• gRPC 参考 — 用于浏览 gRPC 接口（RPC 名称、消息结构）。仅供参考——请从已安装的 SDK 生成存根，不要使用此处的内容。
• API 参考 — 以 HTML 呈现、供人阅读的参考文档站点。
• 指南 — 入门、实体、任务、对象。
• 示例 — 可运行的示例应用。

注意：https://developer.anduril.com/openapi.json 是 HTML 索引页，不是规范——请使用上面的 openapi/rest.json 获取机器可读的 REST 契约。没有可获取的 gRPC 规范；gRPC 接口以可浏览的 HTML 形式提供，因此请从生成的存根中获取 gRPC 契约。