先选择接入路径
标准 Service Compose/Helm 使用 standalone HTTP,不提供 ASDP listener。Python
instrument() 的自动注册与 ASDP 连接绑定;不能通过 start_grpc=False 把它当作完整 HTTP 注册方案。需要这条路径时,先由管理员提供启用 ASDP 的 Kubernetes-native Aistio 部署与真实 gRPC 地址。
选择接入方式后,区分三个验收层次:目录可见、会话可用、可接受工作派发。只有观察能力的应用不会因为注册成功就自动拥有任务执行能力。
Java:添加 HTTP 注册与合约
在应用 Maven 配置中添加正式发布的版本:agent 是你已创建的 Agent。环境变量由部署者提供,AGENT_CONTRACT_URL 必须能从控制面访问:
Python:连接支持 ASDP 的部署
在应用环境安装aistio-sdk 的对应发布版本:
target 是已有框架对象,支持的适配器包括 AgentScope、OpenAI Agents、LangChain、ADK 等;实际可用方法以适配器能力为准。
AISTIO_CONTROL_GRPC 是 host:port,不是带 HTTP scheme 的 Gateway URL。每个副本使用不同 instance key,同一副本重启保持身份稳定。保存 event journal 以支持事件恢复。
接受 Issue / Team 工作
任务适配器需要实现真实的执行入口,例如 PythonFrameworkAdapter.handle_agent_task,Java AgentTaskStarter。应用为每次 Attempt 建立隔离执行,读取注入的工作上下文,使用任务范围凭据发表评论和上传 Artifact,并按协议上报成功、失败或取消。
不要把“发出最终消息”代替 Attempt 完成,也不要用过期 generation 的凭据回报另一次执行。Coordinator 还需要显式完成或失败对应 Run node;详见 Team 协作。
自定义适配器与验收
Python 可实现FrameworkAdapter 并通过 adapter= 传入,按需要扩展 context、messages、commands 和 task execution;只声明实际实现的能力。Java 使用对应 FrameworkAdapter 与 AgentScopeAdapter 扩展点。
依次验证:注册与重启身份、应用侧一轮对话、历史读取、控制面可达的合约、一次支持的工作派发、失败和取消回报。容器 localhost、只有单向网络、错误 gRPC 端口和虚报 capability 是常见接入问题。
相关:SDK 与组件选择 · API 参考。