Mindlogic Logo
Docs
/
์‚ฌ์šฉ์ž๊ด€๋ฆฌ์ž
API Gateway
ํŒฉํŠธ์ฑ—/์ฑ—๋ด‡ ๋งŒ๋“ค๊ธฐ/์›Œํฌํ”Œ๋กœ์šฐ

์›Œํฌํ”Œ๋กœ์šฐ

์›Œํฌํ”Œ๋กœ์šฐ๋Š” ์ฑ—๋ด‡์ด ๋ฉ”์‹œ์ง€์— ์‘๋‹ตํ•  ๋•Œ ๊ฑฐ์น˜๋Š” ๋‹จ๊ณ„๋ฅผ ๋…ธ๋“œ์™€ ์—ฐ๊ฒฐ์„ ์œผ๋กœ ์ง์ ‘ ์„ค๊ณ„ํ•˜๋Š” ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ํ•œ ๋ฒˆ์˜ LLM ํ˜ธ์ถœ๋งŒ์œผ๋กœ ๋๋‚ด๊ธฐ ์–ด๋ ค์šด ๋ถ„๋ฅ˜ยท๋ถ„๊ธฐยท๊ฐ€๋“œ๋ ˆ์ผยท๋„๊ตฌ ํ˜ธ์ถœ์„ ํ•œ ํ๋ฆ„ ์•ˆ์— ๋ฌถ์–ด, ๊ฐ™์€ ์ฑ—๋ด‡์œผ๋กœ๋„ ํ›จ์”ฌ ์ •๊ตํ•œ ๋™์ž‘์„ ๋งŒ๋“ค ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์ธํ„ฐ๋ž™ํ‹ฐ๋ธŒ ๋ฏธ๋ฆฌ๋ณด๊ธฐ

๋…ธ๋“œ๋ฅผ ํด๋ฆญํ•˜๋ฉด ์„ค๋ช…์ด ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค ยท ์บ”๋ฒ„์Šค๋Š” ๋“œ๋ž˜๊ทธยทํ™•๋Œ€ ๊ฐ€๋Šฅ

์›Œํฌํ”Œ๋กœ์šฐ ๋ฏธ๋ฆฌ๋ณด๊ธฐ๋ฅผ ๋ถˆ๋Ÿฌ์˜ค๋Š” ์ค‘โ€ฆ

์˜ˆ: CS ๋ฌธ์˜ ๋ด‡ โ€” ์‚ฌ์šฉ์ž ๋ฉ”์‹œ์ง€๋ฅผ ๋ถ„๋ฅ˜ํ•ด ํ™˜๋ถˆ/์ผ๋ฐ˜ ํ๋ฆ„์œผ๋กœ ๋‚˜๋ˆˆ ๋’ค ๊ฐ€๋“œ๋ ˆ์ผ์„ ๊ฑฐ์ณ ์‘๋‹ตํ•ฉ๋‹ˆ๋‹ค. ์บ”๋ฒ„์Šค๋ฅผ ๋“œ๋ž˜๊ทธยทํ™•๋Œ€ํ•˜๊ฑฐ๋‚˜ ๋…ธ๋“œ๋ฅผ ๋ˆŒ๋Ÿฌ ์‚ดํŽด๋ณด์„ธ์š”.

๊ฐœ์š”

ํ•ญ๋ชฉ๋™์ž‘
๊ธฐ๋ณธ ๋ชจ๋“œ์ฑ—๋ด‡ (๋‹จ์ผ LLM ํ˜ธ์ถœ)
์ „ํ™˜ ์œ„์น˜๋™์ž‘ ํƒญ โ†’ ์‹คํ–‰ ๋ฐฉ์‹ โ†’ ์›Œํฌํ”Œ๋กœ์šฐ ์„ ํƒ
์—๋””ํ„ฐ ๊ฒฝ๋กœ/dashboard/studio/{chatbot_id}/workflow
๋…ธ๋“œ ์œ ํ˜•7๊ฐœ (์‹œ์ž‘/๋/์—์ด์ „ํŠธ/๋ถ„๋ฅ˜/์กฐ๊ฑด ๋ถ„๊ธฐ/๊ฐ€๋“œ๋ ˆ์ผ/๋ฉ”๋ชจ)
์ €์žฅ ๋‹จ์œ„์ž„์‹œ ์ €์žฅ(์ž๋™) + ๋ช…์‹œ์  ๊ฒŒ์‹œ(๋ผ์ด๋ธŒ ๋ฐ˜์˜)
๊ถŒํ•œํŽธ์ง‘(Editor) ๊ถŒํ•œ ์ด์ƒ

์‹œ์ž‘ํ•˜๊ธฐ

  1. ์ŠคํŠœ๋””์˜ค ์ฑ—๋ด‡ ์ƒ์„ธ ํ™”๋ฉด์—์„œ ๋™์ž‘ ํƒญ์„ ์—ฝ๋‹ˆ๋‹ค.
  2. ์‹คํ–‰ ๋ฐฉ์‹ ์„น์…˜์—์„œ ์›Œํฌํ”Œ๋กœ์šฐ๋ฅผ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.
  3. ์„ ํƒ ์ฆ‰์‹œ ํ‘œ์‹œ๋˜๋Š” ํŽธ์ง‘๊ธฐ ์—ด๊ธฐ ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด๋ฉด ์ „์šฉ ์›Œํฌํ”Œ๋กœ์šฐ ์—๋””ํ„ฐ๋กœ ์ด๋™ํ•ฉ๋‹ˆ๋‹ค.
  4. ์ฒ˜์Œ ์ „ํ™˜ํ•˜๋ฉด Start โ†’ Agent ๋‘ ๋…ธ๋“œ๊ฐ€ ์ž๋™์œผ๋กœ ๋ฐฐ์น˜ยท์—ฐ๊ฒฐ๋œ ์ƒํƒœ๋กœ ์‹œ์ž‘ํ•ฉ๋‹ˆ๋‹ค. Agent์—๋Š” ์ฑ—๋ด‡์˜ ์‹œ์Šคํ…œ ๋ชจ๋ธ๊ณผ ์‹œ์Šคํ…œ ํ”„๋กฌํ”„ํŠธ๊ฐ€ ๋ฏธ๋ฆฌ ์ฑ„์›Œ์ ธ ์žˆ์–ด, ๊ทธ๋Œ€๋กœ ์ €์žฅ๋งŒ ํ•ด๋„ ์ฑ„ํŒ… ๋ชจ๋“œ์™€ ๋™์ผํ•œ ๋™์ž‘์„ ์ˆ˜ํ–‰ํ•ฉ๋‹ˆ๋‹ค. ์ดํ›„ ์ขŒ์ธก ๋…ธ๋“œ ์ถ”๊ฐ€ ํŒจ๋„์—์„œ ๋…ธ๋“œ๋ฅผ ๋Œ์–ด๋‹ค ๋†“์•„ ํ๋ฆ„์„ ํ™•์žฅํ•ฉ๋‹ˆ๋‹ค.

ํ™œ์šฉํ•˜๊ธฐ

๋…ธ๋“œ ์œ ํ˜•

์›Œํฌํ”Œ๋กœ์šฐ ์—๋””ํ„ฐ์—์„œ ์ถ”๊ฐ€ํ•  ์ˆ˜ ์žˆ๋Š” ๋…ธ๋“œ๋Š” ๋‹ค์Œ 7๊ฐ€์ง€์ž…๋‹ˆ๋‹ค.
๋…ธ๋“œ์—ญํ• 
์‹œ์ž‘ (Start)์›Œํฌํ”Œ๋กœ์šฐ์˜ ์ง„์ž…์ . ๋ณ„๋„๋กœ ์„ค์ •ํ•  ํ•ญ๋ชฉ์€ ์—†๊ณ , ๋…ธ๋“œ ์นด๋“œ์— ๋ณด์•ˆ ์ •์ฑ… ์นฉ์ด ํ‘œ์‹œ๋˜๋ฉฐ, ์ธ์ŠคํŽ™ํ„ฐ์—๋Š” ์กฐ์ง์—์„œ ์„ค์ •ํ•œ ๊ธฐ๋ณธ ๋ณด์•ˆ ์ •์ฑ…(PII ์ฐจ๋‹จยท๋งˆ์Šคํ‚น, ํŒŒ์ผ ์—…๋กœ๋“œ ์ฐจ๋‹จ)์ด ์–ด๋–ค ์ƒํƒœ๋กœ ์ ์šฉ ์ค‘์ธ์ง€ ์ฝ๊ธฐ ์ „์šฉ์œผ๋กœ ํ‘œ์‹œ
์—์ด์ „ํŠธ (Agent)LLM ํ˜ธ์ถœ ๋‹จ๊ณ„. ํ”„๋กฌํ”„ํŠธ, ๋ชจ๋ธ, ์‹ฌ์ธต ์‚ฌ๊ณ , ์ฑ„ํŒ… ๊ธฐ๋ก ํฌํ•จ ์—ฌ๋ถ€, ์ฐธ์กฐํ•  ์ง€์‹ ํŒŒ์ผ, ์ถœ๋ ฅ ๋ชจ๋“œ(ํ…์ŠคํŠธ ๋˜๋Š” JSON), ์‚ฌ์šฉํ•  ๋„๊ตฌ๋ฅผ ์ง€์ •
๋ถ„๋ฅ˜ (Classify)์‚ฌ์šฉ์ž ๋ฉ”์‹œ์ง€๋ฅผ ๋ฏธ๋ฆฌ ์ •ํ•ด ๋‘” ์—ฌ๋Ÿฌ ์นดํ…Œ๊ณ ๋ฆฌ ์ค‘ ํ•˜๋‚˜๋กœ ๋ถ„๋ฅ˜ํ•˜๊ณ , ์นดํ…Œ๊ณ ๋ฆฌ๋งˆ๋‹ค ๋‹ค๋ฅธ ๊ฒฝ๋กœ๋กœ ํ๋ฆ„์„ ๋ณด๋ƒ„. ๋ถ„๋ฅ˜์— ์“ธ ๋ชจ๋ธ๊ณผ ์นดํ…Œ๊ณ ๋ฆฌ ๋ชฉ๋ก์„ ์ •ํ•˜๊ณ , ํ•„์š”ํ•˜๋ฉด ๋ถ„๋ฅ˜ ์ง€์นจ์ด๋‚˜ ์˜ˆ์‹œ๋ฅผ ์ถ”๊ฐ€ํ•ด ์ •ํ™•๋„๋ฅผ ๋†’์ผ ์ˆ˜ ์žˆ์Œ
์กฐ๊ฑด ๋ถ„๊ธฐ (If-Else)์ง์ ‘ ์ •์˜ํ•œ ์กฐ๊ฑด์‹์œผ๋กœ ๋ถ„๊ธฐ. ๋ถ„๊ธฐ๋Š” ์œ„์—์„œ ์•„๋ž˜๋กœ ํ‰๊ฐ€ํ•˜๊ณ  ๊ฐ€์žฅ ๋จผ์ € ์ผ์น˜ํ•œ ๊ฒฝ๋กœ๋กœ ํ๋ฅด๋ฉฐ, ์–ด๋А ๊ฒƒ์—๋„ ํ•ด๋‹นํ•˜์ง€ ์•Š์œผ๋ฉด ๋ฌต์‹œ์  Else ๊ฒฝ๋กœ๋กœ ํ๋ฆ„
๊ฐ€๋“œ๋ ˆ์ผ (Guardrail)ํ๋ฆ„ ์ค‘๊ฐ„์— ๋ฐฐ์น˜ํ•˜๋Š” ์•ˆ์ „ ๊ฒ€์‚ฌ. PII ์ฐจ๋‹จยท๋งˆ์Šคํ‚น๊ณผ ๊ธˆ์น™์–ด ์ฒดํฌ๋ฅผ ์ผค ์ˆ˜ ์žˆ๊ณ , ๊ฒ€์‚ฌ ํ†ต๊ณผ(Pass) / ๊ฒ€์ถœ(Fail) ๋‘ ์ถœ๊ตฌ๋กœ ํ๋ฆ„์„ ๋ถ„๊ธฐ
๋ฉ”๋ชจ (Note)์‹คํ–‰์—๋Š” ์˜ํ–ฅ์ด ์—†๋Š” ์ฃผ์„. ํ๋ฆ„ ์˜๋„๋ฅผ ์„ค๋ช…ํ•  ๋•Œ ์‚ฌ์šฉ
๋ (End)์›Œํฌํ”Œ๋กœ์šฐ์˜ ์ข…๋ฃŒ ์ง€์ . ์‚ฌ์šฉ์ž์—๊ฒŒ ๋ณด๋‚ผ ์‘๋‹ต ํ…œํ”Œ๋ฆฟ(์˜ˆ: ์š”์ฒญ์„ ์ ‘์ˆ˜ํ–ˆ์Šต๋‹ˆ๋‹ค. ๋ถ„๋ฅ˜: {{input.parsed.category}})์„ ์ง€์ •ํ•˜๊ฑฐ๋‚˜, ๋ถ„๊ธฐ๋ณ„๋กœ ์–ด๋””์„œ ๋๋‚ฌ๋Š”์ง€ ๋ผ๋ฒจ๋งํ•˜๊ณ  ์‹ถ์„ ๋•Œ ๋ช…์‹œ์ ์œผ๋กœ ์ถ”๊ฐ€
์ขŒ์ธก ๋…ธ๋“œ ์ถ”๊ฐ€ ํŒจ๋„์˜ ํ•ญ๋ชฉ์„ ์บ”๋ฒ„์Šค๋กœ ๋“œ๋ž˜๊ทธํ•ด ๋ฐฐ์น˜ํ•ฉ๋‹ˆ๋‹ค.

๋…ธ๋“œ ์—ฐ๊ฒฐ๊ณผ ๋ถ„๊ธฐ

๋…ธ๋“œ์˜ ์ถœ๋ ฅ ํฌํŠธ๋ฅผ ๋‹ค๋ฅธ ๋…ธ๋“œ์˜ ์ž…๋ ฅ ํฌํŠธ๋กœ ๋Œ์–ด์„œ ์—ฐ๊ฒฐ์„ ์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค. ๋ถ„๊ธฐ ๋…ธ๋“œ(๋ถ„๋ฅ˜ยท์กฐ๊ฑด ๋ถ„๊ธฐ)๋Š” ์ถœ๋ ฅ ํฌํŠธ๊ฐ€ ์—ฌ๋Ÿฌ ๊ฐœ์ด๋ฉฐ, ๊ฐ ์—ฐ๊ฒฐ์„ ์— ๋ผ๋ฒจ์„ ๋‹ฌ ์ˆ˜ ์žˆ์–ด ํ๋ฆ„์„ ํ•œ๋ˆˆ์— ์ฝ์„ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
๋‹จ์ถ• ๋™์ž‘์„ค๋ช…
์ž๋™ ์ •๋ ฌ์บ”๋ฒ„์Šค์˜ ๋…ธ๋“œ๋ฅผ ๋ณด๊ธฐ ์ข‹๊ฒŒ ์žฌ๋ฐฐ์น˜
์‹คํ–‰ ์ทจ์†Œ / ๋‹ค์‹œ ์‹คํ–‰์ตœ๊ทผ ๋ณ€๊ฒฝ ๋˜๋Œ๋ฆฌ๊ธฐ
์บ”๋ฒ„์Šค ์ž ๊ธˆ์‹ค์ˆ˜๋กœ ์œ„์น˜๊ฐ€ ๋ฐ”๋€Œ์ง€ ์•Š๋„๋ก ํŽธ์ง‘ ์ž ๊ธˆ
์œ ํšจ์„ฑ ๊ฒฝ๊ณ ๋ฏธ์—ฐ๊ฒฐ ํฌํŠธยทํ•„์ˆ˜ ํ•„๋“œ ๋ˆ„๋ฝ ๋“ฑ์ด ์žˆ์œผ๋ฉด ๋…ธ๋“œ์™€ ์ƒ๋‹จ ๋ฐฐ๋„ˆ์— ๊ฒฝ๊ณ  ํ‘œ์‹œ

์ž„์‹œ ์ €์žฅ๊ณผ ๊ฒŒ์‹œ

๋‹จ๊ณ„๋™์ž‘
์ž„์‹œ ์ €์žฅํŽธ์ง‘์„ ๋ฉˆ์ถ”๋Š” ์ฆ‰์‹œ ์ž‘์—… ์‚ฌ๋ณธ(working copy)์— ์ž๋™ ์ €์žฅ. ๋‹ค๋ฅธ ์‚ฌ์šฉ์ž์—๊ฒŒ๋Š” ๋ณด์ด์ง€ ์•Š์Œ
๊ฒŒ์‹œ (Publish)์ƒ๋‹จ์˜ ๊ฒŒ์‹œ ๋ฒ„ํŠผ์„ ๋ˆ„๋ฅด๋ฉด ํ™•์ธ ๋ชจ๋‹ฌ์ด ํ•œ ๋ฒˆ ๋œฌ ๋’ค, ์ž‘์—… ์‚ฌ๋ณธ์ด ๋ผ์ด๋ธŒ ๋ฒ„์ „์œผ๋กœ ์Šน๊ฒฉ
๊ฒŒ์‹œํ•  ๋•Œ๋งˆ๋‹ค ๋ฒ„์ „ ๊ธฐ๋ก์— ์ƒˆ ํ•ญ๋ชฉ์ด ์ถ”๊ฐ€๋ฉ๋‹ˆ๋‹ค. ์‚ฌ์šฉ์ž์—๊ฒŒ ์‘๋‹ตํ•˜๋Š” ํ๋ฆ„์€ ๊ฐ€์žฅ ์ตœ๊ทผ์— ๊ฒŒ์‹œํ•œ ๋ฒ„์ „์ด ์‚ฌ์šฉ๋ฉ๋‹ˆ๋‹ค.

ํ…Œ์ŠคํŠธ ์ฑ„ํŒ…

์—๋””ํ„ฐ ์šฐ์ธก ์ƒ๋‹จ์—๋Š” โœ๏ธ(ํŽธ์ง‘) / ๐Ÿ’ฌ(ํ…Œ์ŠคํŠธ ์ฑ„ํŒ…) ๋‘ ์•„์ด์ฝ˜์œผ๋กœ ์ด๋ฃจ์–ด์ง„ ํ† ๊ธ€์ด ์žˆ์Šต๋‹ˆ๋‹ค. ๐Ÿ’ฌ๋ฅผ ๋ˆ„๋ฅด๋ฉด ์šฐ์ธก ์ธ์ŠคํŽ™ํ„ฐ ํŒจ๋„์ด ํ…Œ์ŠคํŠธ ์ฑ„ํŒ… ํŒจ๋„๋กœ ๋ฐ”๋€Œ๊ณ , โœ๏ธ๋ฅผ ๋‹ค์‹œ ๋ˆ„๋ฅด๋ฉด ์ธ์ŠคํŽ™ํ„ฐ๋กœ ๋Œ์•„์˜ต๋‹ˆ๋‹ค.
ํ…Œ์ŠคํŠธ ์ฑ„ํŒ…์€ ํ•ญ์ƒ ์•„์ง ๊ฒŒ์‹œํ•˜์ง€ ์•Š์€ ์ž„์‹œ ์ €์žฅ๋ณธ(์ดˆ์•ˆ) ์œผ๋กœ ์‘๋‹ตํ•˜๋ฏ€๋กœ, ๋ผ์ด๋ธŒ ์‚ฌ์šฉ์ž์—๊ฒŒ ์˜ํ–ฅ์„ ์ฃผ์ง€ ์•Š๊ณ  ๋ณ€๊ฒฝ์„ ๊ฒ€์ฆํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํŒจ๋„ ์ƒ๋‹จ์— ์ดˆ์•ˆ ํ…Œ์ŠคํŠธ ๋ฐฐ์ง€๊ฐ€ ํ•จ๊ป˜ ํ‘œ์‹œ๋˜์–ด ์‘๋‹ต์ด ๋ผ์ด๋ธŒ๊ฐ€ ์•„๋‹˜์„ ๋ช…ํ™•ํžˆ ์•Œ๋ ค ์ค๋‹ˆ๋‹ค.
ํ…Œ์ŠคํŠธ ์ฑ„ํŒ… ๊ฒฐ๊ณผ์—๋Š” ์›Œํฌํ”Œ๋กœ์šฐ ์‹คํ–‰์ด ์–ด๋А ๋ถ„๊ธฐ๋กœ ํ˜๋Ÿฌ๊ฐ”๋Š”์ง€(๋ถ„๋ฅ˜ยท์กฐ๊ฑด ๋ถ„๊ธฐ ๊ฒฐ์ • ๋ผ๋ฒจ)๋„ ํ•จ๊ป˜ ํ‘œ์‹œ๋ฉ๋‹ˆ๋‹ค.
์›Œํฌํ”Œ๋กœ์šฐ ํŽธ์ง‘๊ณผ ๊ฒŒ์‹œ๋Š” ํŽธ์ง‘ ๊ถŒํ•œ(Editor) ์ด์ƒ์—์„œ๋งŒ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค. ๊ถŒํ•œ ๊ตฌ์„ฑ์€ ๊ณต์œ  (ํ—ค๋” ํŒ์˜ค๋ฒ„)์—์„œ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
์‹คํ–‰ ๋ฐฉ์‹์„ ์›Œํฌํ”Œ๋กœ์šฐ โ†’ ์ฑ—๋ด‡์œผ๋กœ ๋‹ค์‹œ ์ „ํ™˜ํ•˜๋ฉด, ์›Œํฌํ”Œ๋กœ์šฐ ๋ผ์ด๋ธŒ ๋ฒ„์ „์€ ๊ทธ๋Œ€๋กœ ๋ณด์กด๋˜์ง€๋งŒ ์‘๋‹ต์—๋Š” ์‚ฌ์šฉ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์›Œํฌํ”Œ๋กœ์šฐ ์ž์ฒด๋Š” ์‚ฌ๋ผ์ง€์ง€ ์•Š์œผ๋ฏ€๋กœ ์–ธ์ œ๋“  ๋‹ค์‹œ ์›Œํฌํ”Œ๋กœ์šฐ ๋ชจ๋“œ๋กœ ๋ณต๊ท€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

๋งˆ์ง€๋ง‰ ์ˆ˜์ • ๋‚ ์งœ: Jun 23, 2026

์ด์ „

์ฑ—๋ด‡ ํŽธ์ง‘ โ€” ์ง€์‹

๋‹ค์Œ

๋ฒ„์ „ ๊ธฐ๋ก

๋ชฉ์ฐจ