openai-agents-python
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseOpenAI Agents Python
OpenAI Agents Python
When to use this skill
何时使用该技能
- OpenAI Agents SDK 기반으로 멀티에이전트 워크플로우를 만들 때
- ,
tool calling,handoff이 필요한 에이전트 설계를 할 때guardrail - 프로토타입이 아니라 운영 가능한 에이전트 루프 구조가 필요할 때
- 基于OpenAI Agents SDK构建多Agent工作流时
- 需要进行包含、
tool calling、handoff的Agent设计时guardrail - 需要可投入运行而非仅原型的Agent循环结构时
Instructions
操作指南
Step 1) 작업 목표를 에이전트 토폴로지로 분해
Step 1) 将工作目标拆解为Agent拓扑结构
- Coordinator 1개 + Specialist N개 기본 구조로 시작
- 각 Specialist는 단일 책임(검색/분석/실행/검증) 원칙 유지
- handoff 조건을 자연어가 아니라 명시 규칙으로 기록
- 从1个Coordinator + N个Specialist的基础结构开始
- 每个Specialist遵循单一职责（检索/分析/执行/验证）原则
- 用明确规则而非自然语言记录handoff条件
Step 2) 최소 실행 루프 먼저 만들기
Step 2) 先构建最小执行循环
- 첫 단계는 “한 입력 → 한 handoff → 한 결과”의 최소 루프
- 도구 호출 실패/타임아웃을 표준 에러 포맷으로 수집
- 로그는 ,
agent,tool,handoff기준으로 남김latency
- 第一步构建“一次输入 → 一次handoff → 一个结果”的最小循环
- 将工具调用失败/超时以标准错误格式收集
- 日志按、
agent、tool、handoff维度记录latency
Step 3) Guardrail 추가
Step 3) 添加Guardrail
- 금지 작업(파괴적 명령, 외부 전송)을 정책으로 명시
- 출력 스키마를 고정(JSON schema)해 후속 파이프라인 안정화
- 재시도 횟수/중단 조건(max turns) 명시
- 将禁止操作（破坏性命令、外部传输）明确为规则
- 固定输出模式（JSON schema）以稳定后续流水线
- 明确重试次数/终止条件（max turns）
Step 4) 품질 점검
Step 4) 质量检查
- 케이스 3종: 정상, 경계, 실패
- handoff 오탐/미탐 비율을 체크
- 에러가 반복되면 프롬프트보다 라우팅 규칙을 먼저 수정
- 三类测试用例：正常、边界、失败
- 检查handoff的误判/漏判率
- 若错误重复出现，优先修改路由规则而非提示词
Examples
示例
- 요청: "리서치/요약/검증을 분리한 에이전트 파이프라인을 만들고 싶다"
- 적용: Coordinator가 intent 분류 후 Researcher/Writer/Verifier로 handoff
- 결과: 단계별 산출물과 검증 로그를 분리 저장
- 请求："想要构建将研究/总结/验证分离的Agent流水线"
- 实施：Coordinator完成意图分类后，将任务交接给Researcher/Writer/Verifier
- 结果：分阶段保存产出物及验证日志
Best practices
最佳实践
- 처음부터 5개 이상 에이전트로 시작하지 않는다.
- handoff 규칙은 문장보다 조건식으로 기록한다.
- 모델 교체 가능성을 위해 도구 인터페이스를 고정한다.
- 실패 복구는 재시도보다 fallback route(다른 specialist)로 푼다.
- 不要一开始就使用5个以上的Agent。
- handoff规则用条件表达式而非自然语句记录。
- 为支持模型替换，固定工具接口。
- 故障恢复优先使用 fallback route（其他Specialist）而非重试。