Korean translation (#1816)

Co-authored-by: Kazuhiro Sera <[email protected]>

Author: tylerryu-oai

docs/scripts/translate_docs.py

@@ -26,6 +26,7 @@
 source_dir = "docs"
 languages = {
     "ja": "Japanese",
+    "ko": "Korean",
     # Add more languages here, e.g., "fr": "French"
 }
 
@@ -79,6 +80,40 @@
         "Python first": "Python ファースト",
         # Add more Japanese mappings here
     },
+    "ko": {
+        "agents": "에이전트",
+        "computer use": "컴퓨터 사용",
+        "OAI hosted tools": "OpenAI 호스트하는 도구",
+        "well formed data": "적절한 형식의 데이터",
+        "guardrail": "가드레일",
+        "orchestrating multiple agents": "멀티 에이전트 오케스트레이션",
+        "handoffs": "핸드오프",
+        "function tools": "함수 도구",
+        "function calling": "함수 호출",
+        "tracing": "트레이싱",
+        "code examples": "코드 예제",
+        "vector store": "벡터 스토어",
+        "deep research": "딥 리서치",
+        "category": "카테고리",
+        "user": "사용자",
+        "parameter": "매개변수",
+        "processor": "프로세서",
+        "server": "서버",
+        "web search": "웹 검색",
+        "file search": "파일 검색",
+        "streaming": "스트리밍",
+        "system prompt": "시스템 프롬프트",
+        "Python-first": "파이썬 우선",
+        "interruption": "인터럽션(중단 처리)",
+        "TypeScript-first": "TypeScript 우선",
+        "Human in the loop": "휴먼인더루프 (HITL)",
+        "Hosted tool": "호스티드 툴",
+        "Hosted MCP server tools": "호스티드 MCP 서버 도구",
+        "raw": "원문",
+        "Realtime Agents": "실시간 에이전트",
+        "Build your first agent in minutes.": "단 몇 분 만에 첫 에이전트를 만들 수 있습니다",
+        "Let's build": "시작하기",
+    },
     # Add more languages here
 }
 eng_to_non_eng_instructions = {
@@ -95,6 +130,12 @@
         "* You must consistently use polite wording such as です/ます rather than である/なのだ.",
         # Add more Japanese mappings here
     ],
+    "ko": [
+        "* 공손하고 중립적인 문체(합니다/입니다체)를 일관되게 사용하세요.",
+        "* 개발자 문서이므로 자연스러운 의역을 허용하되 정확성을 유지하세요.",
+        "* 'instructions', 'tools' 같은 API 매개변수와 temperature, top_p, max_tokens, presence_penalty, frequency_penalty 등은 영문 그대로 유지하세요.",
+        "* 문장이 아닌 불릿 항목 끝에는 마침표를 찍지 마세요.",
+    ],
     # Add more languages here
 }
 
@@ -163,6 +204,9 @@ def built_instructions(target_language: str, lang_code: str) -> str:
 *(applies only when {target_language} = Japanese)*  
 - Insert a half‑width space before and after all alphanumeric terms.  
 - Add a half‑width space just outside markdown emphasis markers: ` **太字** ` (good) vs `** 太字 **` (bad).
+*(applies only when {target_language} = Korean)*  
+- Do not alter spaces around code/identifiers; keep them as in the original.  
+- Do not add stray spaces around markdown emphasis: `**굵게**` (good) vs `** 굵게 **` (bad).
 
 #########################
 ##  DO NOT TRANSLATE   ##

mkdocs.yml

@@ -181,6 +181,42 @@ plugins:
                     - realtime/quickstart.md
                     - realtime/guide.md
 
+        - locale: ko
+          name: 한국어
+          build: true
+          nav:
+            - 소개: index.md
+            - 빠른 시작: quickstart.md
+            - 코드 예제: examples.md
+            - 문서:
+                - agents.md
+                - running_agents.md
+                - sessions.md
+                - results.md
+                - streaming.md
+                - repl.md
+                - tools.md
+                - mcp.md
+                - handoffs.md
+                - tracing.md
+                - context.md
+                - guardrails.md
+                - multi_agent.md
+                - usage.md
+                - 모델:
+                    - models/index.md
+                    - models/litellm.md
+                - config.md
+                - visualization.md
+                - release.md
+                - 음성 에이전트:
+                    - voice/quickstart.md
+                    - voice/pipeline.md
+                    - voice/tracing.md
+                - 실시간 에이전트:
+                    - realtime/quickstart.md
+                    - realtime/guide.md
+
 extra:
   # Remove material generation message in footer
   generator: false
@@ -192,6 +228,9 @@ extra:
     - name: 日本語
       link: /openai-agents-python/ja/
       lang: ja
+    - name: 한국어
+      link: /openai-agents-python/ko/
+      lang: ko
 
 markdown_extensions:
   - pymdownx.superfences: