실무 패턴 & 안티패턴

{
  "name": "PDF Parser Agent",
  "description": "PDF 파일 파싱과 텍스트 추출 전문",
  "skills": [
    {"id": "parse-pdf", "name": "PDF 파싱"},
    {"id": "extract-tables", "name": "표 추출"}
  ]
  // ← Skill 2개: 명확하고 집중
}

task_results: dict[str, dict] = {}

async def run_task(params: dict) -> dict:
    task_id = params["id"]

    # 이미 처리된 Task면 캐시 반환
    if task_id in task_results:
        return task_results[task_id]

    result = await process(params)
    task_results[task_id] = result
    return result

results = await asyncio.gather(
    call_search(query),
    call_analysis(query),
    return_exceptions=True
)

artifacts = []
for i, r in enumerate(results):
    if isinstance(r, Exception):
        artifacts.append({
            "name": f"agent-{i}-error",
            "parts": [{"type": "text",
                         "text": f"[실패] {str(r)}"}]
        })
    else:
        artifacts.append(r)

async def stream_with_progress(params, rpc_id):
    steps = ["검색", "분석", "요약"]
    for i, step in enumerate(steps, 1):
        yield emit({...,
            "result": {
                "status": {
                    "state": "working",
                    "message": {"parts": [{
                        "type": "text",
                        "text": f"[{i}/{len(steps)}] {step} 중..."
                    }]}
                },
                "final": False
            }
        })
        await do_step(step)