Kimi Core workflows

공급사: Moonshot AI (月之暗面) | 공식 문서: platform.kimi.ai/docs 한글화 일자: 2026-07-22

K3의 사고·코딩·도구 호출 능력을 활용한 핵심 워크플로우 패턴을 정리한 가이드 모음입니다. 에이전트 빌드, 부분 응답 이어가기, 사고 effort 제어, 시스템 프롬프트 작성 등 일상적 작업의 베스트 프랙티스를 다룹니다.

---

📚 Kimi Core workflows 가이드

#	문서	설명
1	Kimi Agent Build	K3 추론 + 공식/커스텀 도구 + Multi-turn 루프로 bounded 산업 리서치 에이전트 구축
2	Kimi File-based Q&A	PDF·DOCX·이미지 등 업로드 파일을 컨텍스트로 주입해 Q&A 수행
3	Kimi Partial Mode	finish_reason=length 후 이전 응답에서 이어서 받기 (Partial Mode)
4	Kimi Reasoning Effort	K3/K2.6의 reasoning_effort(low/high/max)로 사고 깊이 제어
5	Kimi Thinking Models	추론 모델 사고 활성화 패턴 + reasoning_content 보존 + 멀티스텝 도구 호출
6	Kimi Prompt Best Practices	명확한 지시·역할·구분자·예시·단계·길이·분해로 효과적인 시스템 프롬프트 작성

---

🎯 패턴 선택 가이드

시나리오	권장 가이드
에이전트 시스템 (K3 + 도구 호출 루프)	Kimi Agent Build
긴 출력 이어서 받기 (finish_reason=length)	Kimi Partial Mode
사고 깊이 조정 (속도 vs 품질)	Kimi Reasoning Effort + Kimi Thinking Models
파일 기반 Q&A (PDF·DOCX·이미지)	Kimi File-based Q&A
시스템 프롬프트 작성 (역할·지시·예시)	Kimi Prompt Best Practices

---

⚡ 빠른 시작

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["MOONSHOT_API_KEY"],
    base_url="https://api.moonshot.ai/v1",
)

completion = client.chat.completions.create(
    model="kimi-k3",
    messages=[{"role": "user", "content": "Hello"}],
)
print(completion.choices[0].message.content)

---

📚 영역 구분

영역	페이지
Models	Kimi K3 Quickstart, Kimi K2.7 Code Quickstart, Kimi K2.6 Quickstart
Capabilities	Thinking, Reasoning Effort, Multi-turn Chat
Tooling	Dynamic Tool Loading, Tool Calling Best Practices

---

📞 추가 리소스

리소스	링크
공식 API 문서	https://platform.kimi.ai/docs
Playground	https://platform.kimi.ai/playground
API Key 발급	https://platform.kimi.ai/console/api-keys
개발자 커뮤니티	https://platform.kimi.ai/docs/api/join-the-community

---

변경 이력

날짜	변경
2026-07-22	Kimi Core workflows를 hub 페이지로 전환, 6개 자식 가이드 한글화