Claude Agent SDK

การเรียก API ของ Claude โดยตรงเพื่อสร้าง Agent นั้นเป็นไปได้ แต่จะต้องมีการ implement รูปแบบซ้ำๆ ทุกครั้ง ไม่ว่าจะเป็น loop การส่งผลลัพธ์ของการเรียก tool กลับไปยัง model, การจัดการ error และการตั้งค่า guardrail Claude Agent SDK คือ framework อย่างเป็นทางการที่ abstract "agent loop" นี้ออกไป เพื่อให้นักพัฒนาสามารถมุ่งเน้นไปที่ business logic ได้ ## ปัญหาที่ SDK แก้ไข ในการพัฒนา Agent จำเป็นต้องรวมคำสั่งสำหรับ LLM (system prompt), การกำหนด external tool และการตัดสินผลการ execute ไว้ใน loop เดียวกัน หากนำไป implement อย่างตรงไปตรงมา กระบวนการต่างๆ เช่น การเพิ่ม return value ของ tool ลงใน message history, การเรียก model อีกครั้ง และการตัดสินเงื่อนไขการสิ้นสุด จะพองตัวขึ้นเป็นหลายร้อยบรรทัด SDK ย่อ loop นี้ไว้ใน class `Agent` นักพัฒนาเพียงแค่กำหนด tool เป็น function แล้วส่งให้ `Agent` เท่านั้น ส่วนการควบคุม loop, การจัดการ token และการสลับการ execute tool แบบ serial/parallel นั้น SDK จะเป็นผู้จัดการ ## โครงสร้างพื้นฐาน ศูนย์กลางของ SDK คือ object `Agent` โดย instantiate ด้วยการส่ง `name`, `instructions` (system prompt) และ `tools` (รายการ tool) จากนั้น execute ด้วย `Runner.run()` ```python from agents import Agent, Runner, function_tool @function_tool def get_weather(city: str) -> str: return f"{city}の天気は晴れです" agent = Agent( name="weather-bot", instructions="天気を聞かれたらツールで取得して回答してください。", tools=[get_weather], ) result = Runner.run_sync(agent, "東京の天気は？") ``` Input/output ของ tool จะถูกแปลงเป็น JSON Schema โดยอัตโนมัติจาก type annotation จึงไม่จำเป็นต้องเขียน schema ด้วยมือ เมื่อผู้เขียนได้ลองใช้ครั้งแรก มีความรู้สึกว่าการแปลงอัตโนมัตินี้เพียงอย่างเดียวช่วยลด boilerplate แบบเดิมลงได้มากกว่าครึ่ง ## Guardrail และ Handoff เพื่อรับมือกับกรณีที่ Agent ทำงานโดยไม่ตั้งใจ สามารถตั้งค่า guardrail สำหรับ input และ output ได้แบบ declarative ตัวอย่างเช่น ข้อจำกัดอย่าง "ปฏิเสธ input ที่มีข้อมูลส่วนบุคคล" หรือ "retry หากคำตอบไม่เป็นไปตาม format ที่กำหนด" สามารถฝังไว้เป็นส่วนหนึ่งของการกำหนด Agent ได้ นอกจากนี้ยังมีฟีเจอร์ "handoff" สำหรับการเชื่อมต่อ Agent หลายตัวเข้าด้วยกัน เป็นกลไกที่ Agent หนึ่งส่งต่อการควบคุมไปยัง Agent อื่นระหว่างการประมวลผล เช่น Agent รับเรื่องขั้นต้นของ customer support ที่เมื่อตรวจพบคำถามทางเทคนิคแล้วส่งต่อให้ Agent ผู้เชี่ยวชาญ ซึ่งสามารถสร้าง multi-agent configuration เช่นนี้ได้โดยไม่ต้องมี orchestration code อย่างชัดเจน ## การเชื่อมต่อกับ MCP SDK รองรับการเชื่อมต่อกับ MCP (Model Context Protocol) server แบบ native สามารถเพิ่ม tool ที่ MCP server เปิดเผยไว้ลงในรายการ tool ของ `Agent` ได้แบบ dynamic จึงสามารถนำฟังก์ชันภายนอก เช่น การดำเนินการกับ database หรือการเข้าถึง file system มาผนวกเข้ากับ agent loop ของ SDK ได้โดยตรง ซึ่งหมายความว่าสามารถ reproduce กลไกเดียวกับที่ Claude Code ใช้ในการดำเนินการกับ Supabase ผ่าน MCP server ใน Agent ของตัวเองได้ ## ความสัมพันธ์กับ Claude Code Claude Code คือ coding agent แบบ CLI ที่ Anthropic ให้บริการอย่างเป็นทางการ โดยมีการใช้ Claude Agent SDK ใน implementation ภายใน กล่าวคือ SDK มีตำแหน่งเป็น "building block สำหรับสร้าง Agent แบบเดียวกับ Claude Code ด้วยตัวเอง" การกำหนด Agent Skills และ flow การ execute tool ก็เป็นไปตาม architecture ของ SDK เช่นกัน อย่างไรก็ตาม SDK เองเป็น framework อเนกประสงค์ที่สามารถรองรับการใช้งานนอกเหนือจากการเขียนโค้ด ไม่ว่าจะเป็นการสนับสนุนการขาย, data analysis pipeline หรือ chatbot ภายในองค์กร ด้วย design pattern เดียวกัน