Loading...

Back to Details

openai-agents-python

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

OpenAI Agents Python

OpenAI Agents Python

When to use this skill

何时使用该技能

OpenAI Agents SDK 기반으로 멀티에이전트 워크플로우를 만들 때
```
tool calling
```
,
```
handoff
```
,
```
guardrail
```
이 필요한 에이전트 설계를 할 때
프로토타입이 아니라 운영 가능한 에이전트 루프 구조가 필요할 때

基于OpenAI Agents SDK构建多Agent工作流时
需要进行包含
```
tool calling
```
、
```
handoff
```
、
```
guardrail
```
的Agent设计时
需要可投入运行而非仅原型的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）而非重试。

References

参考资料

https://github.com/openai/openai-agents-python

https://github.com/openai/openai-agents-python