Skip to main content
此为预览文档，正式版本尚未发布。
External 应用保留自己的进程与框架。下面的参数连接目录身份、HTTP 合约和可选 ASDP 事件通道。可直接嵌入应用的 Java/Python 代码见接入用法。

​
SDK 参数对照

Java 的 startHttpRegister(true) 可以独立启动 HTTP 注册；未指定时由是否配置 controlPlaneHttp 决定。Python 当前的自动注册位于 ASDP 初始化路径，关闭 start_grpc 不会变成独立的 HTTP 注册方案。

​
网络与部署模式

标准 Service Compose/Helm 运行 standalone HTTP，不启动 ASDP listener。需要 Python 自动接入或 ASDP 实时通道时，先准备支持 ASDP 的 Kubernetes-native Aistio 部署。开启 SDK 开关不会让 Gateway 自动提供 gRPC listener。

​
身份与凭据的生命周期

首次注册后保存返回的身份和 registration credential。普通实例重启复用身份；扩容时分配新的 instance key。generation 属于控制面身份与派发校验，不能手动递增来绕过过期执行检查。 Bootstrap 凭据由管理员交付给受信任应用；它与浏览器登录 token、Endpoint API key、Runtime Host enrollment token 的用途不同。模型和业务工具密钥仍由 External 应用管理，不因目录注册而自动读取 Managed Vault。

​
配置后验收

先检查目录中的框架、实例和合约地址，再从应用自身执行一次对话，检查上下文和历史是否可读取。最后按适配器能力测试命令、取消和任务派发。只有观测能力的实例不应以 Issue 派发成功作为注册的默认承诺。