๐จ OpenAI Developers์ ๊ฐ๋ ฅํ ์ ๋ฐ์ดํธ: Responses API์ ์น ๊ฒ์์ด ์ด์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ๋ ์ง์ํฉ๋๋ค! ๐ธ
์์ฝ
OpenAI์ Responses API๊ฐ ์น ๊ฒ์ ๋๊ตฌ์์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ ๋ฐํ ๊ธฐ๋ฅ์ ์ง์ํ๊ธฐ ์์ํ์ต๋๋ค. ์ด์ ๊ฐ๋ฐ์๋ ๋จ์ผ API ํธ์ถ๋ก ํ ์คํธ์ ์ด๋ฏธ์ง๋ฅผ ๋์์ ๋ฐ์ ์๊ฐ์ ์ผ๋ก ํ๋ถํ AI ์ ํ๋ฆฌ์ผ์ด์ ์ ๊ตฌ์ถํ ์ ์์ต๋๋ค.
ํต์ฌ ํฌ์ธํธ
- Responses API์ ์น ๊ฒ์ ๋๊ตฌ๊ฐ ํ ์คํธ์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ๋ฅผ ๋์์ ์ง์
- search_content_types ํ๋ผ๋ฏธํฐ๋ฅผ ํตํด ์ด๋ฏธ์ง ๊ฒฐ๊ณผ ์์ฒญ ๊ฐ๋ฅ
- ์ ํ ๋น๊ต, ๋์์ธ ์๊ฐ, ์ผํ ์ด์์คํดํธ ๋ฑ ๋ค์ํ ์๋๋ฆฌ์ค ํ์ฉ ๊ฐ๋ฅ
- ์ถ๊ฐ ๋๊ตฌ ํตํฉ ์์ด ๋จ์ผ ํธ์ถ๋ก ์๊ฐ์ ๊ทธ๋ผ์ด๋ฉ ๊ตฌํ ๊ฐ๋ฅ
๐จ OpenAI Developers๊ฐ ๊ฐ๋ฐ์๋ค์๊ฒ ์ ํ๋ ๊ฐ๋ ฅํ ์ ๋ฐ์ดํธ: Responses API์ ์น ๊ฒ์์ด ์ด์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ๋ ์ง์ํฉ๋๋ค! ๐ธ
@OpenAIDevs๊ฐ ๊ณต์ ํ ์์์ ๋ฐ๋ฅด๋ฉด, OpenAI๋ Responses API์ ์ค์ํ ๋ฅ๋ ฅ์ ์ถ๊ฐํ๋ค๊ณ ๋ฐํํ์ต๋๋ค: ์น ๊ฒ์ (Web search) ๋๊ตฌ๊ฐ ์ด์ ํ ์คํธ๋ฟ๋ง ์๋๋ผ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ๋ ๋ฐํํ ์ ์์ต๋๋ค.
์ด๋ฅผ ํตํด ์ฌ๋ฌ๋ถ์ ์ ํ๋ฆฌ์ผ์ด์ ์ ์ ํ ์ฌ์ง, ์ฅ์, ์๊ฐ์ ์ฐธ์กฐ, ์๊ฐ์ ์์ฒ ๋ฐ ์์ค ๋งํฌ๋ฅผ ์ง์ ์ ์ผ๋ก ๋๋ฌ๋ผ ์ ์์ต๋๋ค. ์ด์ AI ์ง์ ์ ํ๋ฆฌ์ผ์ด์ ์ ๋จ์ํ "์ค๋ช "ํ๋ ๊ฒ์ ๊ทธ์น์ง ์๊ณ , ์ง์ "๋ณด์ฌ์ฃผ๊ธฐ"๊น์ง ํฉ๋๋ค!
Responses API๋ ๋ฌด์์ธ๊ฐ? (์งง๊ณ ๊น์ ํต์ฐฐ)
Responses API๋ OpenAI์ ๊ฐ์ฅ ์ง๋ณด๋๊ณ ๊ถ์ฅ๋๋ API ์ธํฐํ์ด์ค์ ๋๋ค. Chat Completions์ ๋จ์ํจ๊ณผ Assistants API์ ๊ฐ๋ ฅํ ๋๊ตฌ ๋ฐ ์ํ ๊ด๋ฆฌ (state management) ๋ฅ๋ ฅ์ ๊ฒฐํฉํฉ๋๋ค. ์ํ ์ ์ง (Stateful) ์ํธ์์ฉ, ๋ด์ฅ ๋๊ตฌ (์น ๊ฒ์ (web search), ํ์ผ ๊ฒ์ (file search), ์ปดํจํฐ ์ฌ์ฉ (computer use) ๋ฑ), ์ถ๋ก (reasoning) ๋ชจ๋ธ ๋ฐ ๋ฉํฐ๋ชจ๋ฌ (multimodal) ์ํฌํ๋ก์ฐ๋ฅผ ์ํด ์ค๊ณ๋์์ต๋๋ค. ์๋ก์ด ํ๋ก์ ํธ์๋ Chat Completions ๋์ Responses API ์ฌ์ฉ์ ๊ถ์ฅํฉ๋๋ค.
์ด API๋ฅผ ํตํด ๋ชจ๋ธ์ ์ธ๋ถ ๋ฐ์ดํฐ์ ์ ๊ทผํ๊ณ ์์ด์ ํธ (agent)์ ์ ์ฌํ ๋์์ ์ํํ ์ ์์ต๋๋ค. ์น ๊ฒ์ (web search) ๋๊ตฌ ๋ํ ์ด ์ํ๊ณ์ ์ค์ํ ๋ถ๋ถ์ ๋๋ค.
์๋ก์ด ๊ธฐ๋ฅ: ์น ๊ฒ์ (Web Search)์์์ ์ด๋ฏธ์ง ์ง์ (GA)
์ด์ ์๋ ์น ๊ฒ์์ด ํ ์คํธ ๊ฒฐ๊ณผ์ ์ธ์ฉ (citations)๋ง์ ์ ๊ณตํ์ต๋๋ค.
์ด์ search_content_types ํ๋ผ๋ฏธํฐ๋ฅผ ํตํด ํ ์คํธ์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ๋ฅผ ๋์์ ์์ฒญํ ์ ์์ต๋๋ค.
์ฃผ์ ํ๋ผ๋ฏธํฐ:
โ
search_content_types: ["image", "text"] โ ์๊ฐ์ ๊ฒฐ๊ณผ์ ํ
์คํธ ๊ฒฐ๊ณผ๊ฐ ๋ชจ๋ ํ์ฑํ๋ฉ๋๋ค.
โ
image_settings: { "max_results": 5, "caption": true } โ ์ํ๋ ์ด๋ฏธ์ง ๊ฐ์์ ์๋ ์บก์
(caption, ์งง์ ์ค๋ช
) ์์ฒญ ์ฌ๋ถ๋ฅผ ๊ฒฐ์ ํฉ๋๋ค.
โ
include: ["web_search_call.results"] โ ์์ ์ด๋ฏธ์ง ๊ฒฐ๊ณผ (image_url, thumbnail_url, source_website_url, caption)๋ฅผ ๋ณ๋๋ก ๋ฐ์ต๋๋ค.
๋ชจ๋ธ์ ์ด ์ด๋ฏธ์ง๋ค์ ํ ์คํธ ๊ฒฐ๊ณผ์ ํจ๊ป ์ฌ์ฉํ์ฌ ํ๋ถํ๊ณ ์ธ์ฉ์ด ํฌํจ๋ ์๋ต์ ์์ฑํฉ๋๋ค. ์ด๋ฏธ์ง๋ ์น์์ ์ค์๊ฐ์ผ๋ก ๊ฐ์ ธ์ค๋ฉฐ ์ถ์ฒ์ ํจ๊ป ์ ๊ณต๋ฉ๋๋ค.
์์ ์ฌ์ฉ ์๋๋ฆฌ์ค:
โ
์ ํ ๋น๊ต: โ๋น ์ค๋ ๋์์์์ ๋ฐฉ์ ๋ฌ๋ํ ๋น๊ตํด์คโ โ ์ค์ ์ ํ ์ฌ์ง + ์ค๋ช
.
โ
์๊ฐ์ ์ฐธ์กฐ: โ๋ฏธ๋๋ฉํ ํจํค์ง์ ์ฌํ์ฉ ๊ฐ๋ฅํ ์คํจ์ผ์ด ์ ํ ์ฐพ์์คโ โ ๋์์ด๋๋ฅผ ์ํ ์๊ฐ์ ์ฃผ๋ ์ด๋ฏธ์ง.
โ
์๊ฐ ์ฐฝ์ถ: โ๋ฐ๋ปํ ์ ๊ตฌ์์ด ์ฅ์ฐฉ๋ ๋ฆฌ๋ธ๋ ๊ธ๋ผ์ค ํ๋ํธ ์กฐ๋ช
๊ฒ์ํด์คโ โ ํ ๋ฐ์ฝ, ์ ํ ๋์์ธ ์ ํ๋ฆฌ์ผ์ด์
์ ์๋ฒฝํจ.
โ
์ผํ ์ด์์คํดํธ, ์ธํ
๋ฆฌ์ด ๋์์ธ ๋๊ตฌ, ๋ ์ํผ ์ถ์ฒ๊ธฐ, ์ฌํ ํ๋๋, ์ฐ๊ตฌ ์ ํ๋ฆฌ์ผ์ด์
โฆ ์ด ๋ชจ๋ ๋ถ์ผ๊ฐ ํฐ ํํ์ ์
์ ๊ฒ์
๋๋ค.
์ ์ด๋ ๊ฒ ์ค์ํ๊ฐ์?
โ
์๊ฐ์ ๊ทธ๋ผ์ด๋ฉ (Visual grounding): ํ
ใใญในใ + ์ด๋ฏธ์ง์ ํจ๊ป ์๋ต์ด ํจ์ฌ ๋ ํ๋ถํด์ง๊ณ ์ฌ์ฉ์ ์นํ์ ์ผ๋ก ๋ณํฉ๋๋ค. โ๋ฐฑ๋ฌธ์ด ๋ถ์ฌ์ผ๊ฒฌโ์ด๋ผ๋ ๊ฒฉ์ธ์ด API ์์ค์์ ์คํ๋ฉ๋๋ค.
โ
๊ฐ๋ฐ์ ํธ์์ฑ: ์ถ๊ฐ์ ์ธ ๋๊ตฌ ํตํฉ ์์ด, ๋จ ํ ๋ฒ์ API ํธ์ถ๋ก ์ ๋ณด์ ์ด๋ฏธ์ง๋ฅผ ๋ชจ๋ ์ป์ ์ ์์ต๋๋ค. ์ง์ฐ ์๊ฐ (Latency) ๋ฐ ๋น์ฉ ์ธก๋ฉด์์ ํจ์จ์ ์
๋๋ค.
โ
์ ํ๋ฆฌ์ผ์ด์
ํ์ง: ์ผํ, ๋์์ธ, ๊ต์ก, ์ฌํ๊ณผ ๊ฐ์ ์์ง์ ์์ฅ (Verticals)์์ ๋
๋ณด์ ์ธ ๊ฒฝํ์ ์ฐฝ์ถํ ์ ์์ต๋๋ค.
โ
์ธ์ฉ (Citations)์ ํตํ ํฌ๋ช
์ฑ๊ณผ ์ ๋ขฐ์ฑ ํฅ์ โ ๋ชจ๋ธ์ ๋จ์ํ โ์ฐพ์๋คโ๋ผ๊ณ ๋งํ๋ ๊ฒ์ ๊ทธ์น์ง ์๊ณ , ์ถ์ฒ๋ ํจ๊ป ๋ณด์ฌ์ค๋๋ค.
์ด ๊ธฐ๋ฅ์ ์ผ๋ฐ์ ์ผ๋ก ์ฌ์ฉ ๊ฐ๋ฅ (Generally Available, GA) ์ํ๋ก ์ถ์๋์์ผ๋ฉฐ ์ฆ์ ์ฌ์ฉํ ์ ์์ต๋๋ค.
Curl, Python, JavaScript ์์ ๋ ์ค๋น๋์ด ์์ต๋๋ค. ๊ฐ๋จํ ์์ฒญ๋ง์ผ๋ก โGolden Gate Bridge ์ผ๋ชฐโ๊ณผ ๊ฐ์ ์ฟผ๋ฆฌ์ ๋ํด ํ ์คํธ์ ๋ฉ์ง ์ด๋ฏธ์ง, ๊ทธ๋ฆฌ๊ณ ์ถ์ฒ๋ฅผ ๋ชจ๋ ๋ฐ์ ์ ์์ต๋๋ค.
์ด ๊ธฐ๋ฅ์ด ์ด๋ค ์ข ๋ฅ์ ์ ํ๋ฆฌ์ผ์ด์ ์ ๊ฐ์ฅ ํฌ๊ฒ ๋ณํ์ํฌ ๊ฒ์ด๋ผ๊ณ ์๊ฐํ์๋์? ์ผํ ์ด์์คํดํธ์ผ๊น์, ์ฐฝ์์ ์ธ ๋์์ธ ๋๊ตฌ์ผ๊น์, ์๋๋ฉด ๊ต์ก/์ฐ๊ตฌ ์ ํ๋ฆฌ์ผ์ด์ ์ผ๊น์?
์ง์ ์ฌ์ฉํด ๋ณด์ ๋ถ์ด ์๋ค๋ฉด ๊ฒฝํ์ ๊ณต์ ํด ์ฃผ์ธ์. ํจ๊ป ๋ฐฐ์๋ด ์๋ค! ๐๐ฅ
AI ์๋ ์์ฑ ์ฝํ ์ธ
๋ณธ ์ฝํ ์ธ ๋ X @kaan_alper (์๋ ๋ฐ๊ฒฌ)์ ์๋ฌธ์ AI๊ฐ ์๋์ผ๋ก ์์ฝยท๋ฒ์ญยท๋ถ์ํ ๊ฒ์ ๋๋ค. ์ ์ ์๊ถ์ ์์ ์์์๊ฒ ์์ผ๋ฉฐ, ์ ํํ ๋ด์ฉ์ ๋ฐ๋์ ์๋ฌธ์ ํ์ธํด ์ฃผ์ธ์.
์๋ฌธ ๋ฐ๋ก๊ฐ๊ธฐ