Back to Details

microsoft-agent-framework

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Microsoft Agent Framework

Microsoft Agent Framework

When to use this skill

何时使用此技能

  • 조직/팀 단위로 유지되는 에이전트 시스템 설계가 필요할 때
  • 책임분리, 거버넌스, 감사 가능한 실행로그가 필요할 때
  • 단발성 데모가 아니라 운영/확장 가능한 구조가 필요할 때
  • 需要设计面向组织/团队级别的可维护Agent系统时
  • 需要职责分离、治理机制和可审计的执行日志时
  • 需要的不是一次性演示，而是可运营/可扩展的架构时

Instructions

操作指南

Step 1) 역할 분리 모델 확정

步骤1) 确定角色分离模型

  • Planner / Executor / Reviewer / Approver 역할을 분리
  • 역할 간 입력/출력 계약(스키마) 먼저 정의
  • 승인 단계(Approver)가 필요한 작업군을 선별
  • 分离Planner / Executor / Reviewer / Approver角色
  • 先定义角色间的输入/输出契约（Schema）
  • 筛选需要Approver审批步骤的任务组

Step 2) 제어흐름 정의

步骤2) 定义控制流

  • 동기/비동기 경로 구분
  • 실패 시 보상 트랜잭션 또는 롤백 전략 설정
  • SLA(응답시간/재시도/중단조건) 명문화
  • 区分同步/异步路径
  • 设置失败时的补偿事务或回滚策略
  • 明确SLA（响应时间/重试/终止条件）

Step 3) 정책 경계 설정

步骤3) 设置策略边界

  • 데이터 접근 범위(읽기/쓰기/외부전송) 역할별 제한
  • 민감정보 마스킹/로그 보존 정책 적용
  • 자동 실행 범위와 인간 승인 범위를 분리
  • 按角色限制数据访问范围（读/写/外部传输）
  • 应用敏感信息掩码/日志保留策略
  • 区分自动执行范围与人工审批范围

Step 4) 운영 관측성 구축

步骤4) 构建运营可观测性

  • 단계별 trace id 부여
  • 실패 원인 분류(정책,도구,모델,입력)
  • 주기적 회귀 점검용 시나리오 유지
  • 为每个步骤分配trace id
  • 分类失败原因（策略、工具、模型、输入）
  • 保留用于周期性回归检查的场景

Examples

示例

  • 요청: "부서 간 승인 흐름을 포함한 에이전트 운영체계를 만들고 싶다"
  • 적용: Planner→Executor→Reviewer→Approver 파이프라인 구성
  • 결과: 감사 가능한 승인 이력과 실패 복구 경로 확보
  • 请求：“想要构建包含部门间审批流程的Agent运营体系”
  • 应用：构建Planner→Executor→Reviewer→Approver流水线
  • 结果：获得可审计的审批历史和故障恢复路径

Best practices

最佳实践

  1. 역할 분리는 프롬프트 문체가 아니라 권한 경계 중심으로 한다.
  2. 승인 없는 자동화는 저위험 작업으로 제한한다.
  3. 관측성 없는 최적화는 금지하고, 로그 체계를 먼저 만든다.
  1. 角色分离应以权限边界为核心，而非提示语风格。
  2. 无审批的自动化应限制在低风险任务中。
  3. 禁止无观测性的优化，优先建立日志体系。

References

参考资料