正文
获取原文件references/agent-contract.md
Agent 注册表
agent_id,goal,non_goals,input_schema,output_schema,allowed_tools,data_scope,budget,termination,escalation,owner
工具注册表
tool_id,purpose,input_schema,output_schema,permission,side_effect,idempotency,timeout,error_codes,audit,approval
工具错误应稳定、可恢复且不泄露敏感实现细节。
能力与采用
每项能力记录 requirement_id,entry,provider,model,prompt_version,tool_adapter,knowledge_version,context_identity,output,adoption,business_result,acceptance_id。
目录登记、连接、执行、效果评测和业务采用分别验证。配置发布必须说明运行时读取来源及版本。
HOSTED_API 验证真实 API 请求与数据范围;SELF_HOSTED 增加制品、引擎和资源要求。适用门槛具有需求或风险依据。
状态机
至少覆盖:READY、PLANNING、EXECUTING、WAITING_APPROVAL、RETRYING、COMPLETED、FAILED、CANCELLED。按项目裁剪,不强制名称一致。
每条转换记录:事件、守卫条件、动作、预算消耗、验证器、失败去向。
涉及后端任务时,节点状态映射到后端定义的任务 ID、事件和终态,明确取消传播、超时、重复请求与结果采用条件。后端任务管理与 Agent 内部编排按 设计责任 维护各自规范;S006 使用 状态与分支检查 核查边界,S009 验证结果进入实际业务的路径。
上下文与记忆
- 固定规则、任务输入、检索证据、工具结果、对话历史分层。
- PII/PHI/秘密最小化、保留、删除、跨租户隔离。
- 压缩或摘要保留事实来源和未决状态,不保留隐式推理。
- 缓存键包含影响行为的版本;动态能力变化有失效策略。
预算与终止
max_wall_time,max_turns,max_tool_calls,max_retries,cost_or_token_budget,no_progress_rule,cancel_behavior
Evals
eval_id,risk,scenario,dataset_version,metric,threshold_source,judge,variance_policy,release_action
区分确定性验证、模型评测、人工评审和线上监控。