此为预览文档,正式版本尚未发布。
模型接入
Java SDK 提供 OpenAI 及兼容接口、Anthropic、Gemini、Ollama 等模型扩展。它们属于可集成能力;标准 Service 镜像不因 SDK 存在扩展就自动包含全部 provider。模型需要支持任务使用的工具调用和输入类型。
工具与 MCP
内置工具由 Harness 和所选 Environment 提供。agent_toolset 控制内置工具,mcp_toolset 关联一个 mcpServerName;具体连接在 mcpServers 中定义。
mcpServers 常用字段包括 name、transport、url、command、args、headers、env、queryParams、enableTools、disableTools、required、initializationTimeout 和 timeout。command/args 用于 stdio;网络 endpoint 使用 url。超时字段使用适配器接受的时长字符串,例如 PT30S。
工具策略的 enabled 控制是否启用;permissionPolicy.type 使用 always_allow、always_ask 或 deny。只有实际请求需要确认时才会进入相应确认流程,不能把“工具已配置”当作“工具允许执行”。
Skills 与内部 Subagents
Workspace 保存AGENTS.md、Skill 文件和子 Agent 声明。Skills 提供可复用步骤与辅助资料;Subagents 提供 Agent 内部的专项委派。系统依赖仍需安装在实际 Environment 中。
需要独立负责人、持久讨论、跨运行方式或统一交付的协作时,使用 Team。Team 成员不是简单地把同一个进程中的所有 Subagent 暴露为独立服务。
知识、凭据与入口
- Memory Store:已绑定的共享知识,执行期间按需只读访问。
- Vault:解析工具连接凭据,不自动配置所有模型连接。
- Chat:个人多轮会话;Issue:工作交付与验收。
- Automation、Workflow、Team:安排、组合或委派 Managed 工作。
- Endpoint 与 Channel:按发布的协议和路由将能力提供给应用或消息平台。