์„ธ์…˜

์„ธ์…˜์€ ๋Œ€ํ™”ํ˜• ์—์ด์ „ํŠธ(Dialogflow CX) ์—์ด์ „ํŠธ์™€ ์ตœ์ข… ์‚ฌ์šฉ์ž ๊ฐ„์˜ ๋Œ€ํ™”๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค. ๋Œ€ํ™”๋ฅผ ์‹œ์ž‘ํ•  ๋•Œ ์„ธ์…˜์„ ๋งŒ๋“ค๊ณ  ๋Œ€ํ™” ์ฐจ๋ก€๋งˆ๋‹ค ์ด ์„ธ์…˜์„ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. ๋Œ€ํ™”๊ฐ€ ์ข…๋ฃŒ๋˜๋ฉด ์„ธ์…˜ ์‚ฌ์šฉ์„ ์ค‘๋‹จํ•ฉ๋‹ˆ๋‹ค.

์—ฌ๋Ÿฌ ์ตœ์ข… ์‚ฌ์šฉ์ž์™€ ๋™์‹œ์— ์ง„ํ–‰๋˜๋Š” ๋Œ€ํ™”์—์„œ ๋™์ผํ•œ ์„ธ์…˜์„ ์‚ฌ์šฉํ•˜๋ฉด ์•ˆ ๋ฉ๋‹ˆ๋‹ค. ์„ธ์…˜์— ๋Œ€ํ•œ ๋งˆ์ง€๋ง‰ ์š”์ฒญ์„ ๋ณด๋‚ธ ํ›„ 30๋ถ„ ๋™์•ˆ ์„ธ์…˜์ด ํ™œ์„ฑ ์ƒํƒœ๋กœ ์œ ์ง€๋˜๊ณ  ์„ธ์…˜ ๋ฐ์ดํ„ฐ๊ฐ€ ์ €์žฅ๋ฉ๋‹ˆ๋‹ค.

๊ฐ ์„ธ์…˜์€ ์‹œ์Šคํ…œ์—์„œ ์ƒ์„ฑ๋˜๋Š” ์„ธ์…˜ ID๋กœ ๊ณ ์œ ํ•˜๊ฒŒ ๊ตฌ๋ถ„๋ฉ๋‹ˆ๋‹ค. ์ธํ…ํŠธ ์ธ์‹ ์š”์ฒญ ๋ฐ ๊ธฐํƒ€ ์„ธ์…˜ ๋ฉ”์„œ๋“œ์—์„œ ์ƒˆ๋กœ์šด ์„ธ์…˜ ID๋ฅผ ์ œ๊ณตํ•˜์—ฌ ์ƒˆ ์„ธ์…˜์„ ๋งŒ๋“ญ๋‹ˆ๋‹ค. ์„ธ์…˜ ID๋Š” ์ตœ๋Œ€ 36๋ฐ”์ดํŠธ ํฌ๊ธฐ์˜ ๋ฌธ์ž์—ด์ž…๋‹ˆ๋‹ค. ์‹œ์Šคํ…œ์€ ๊ณ ์œ ํ•œ ์„ธ์…˜ ID๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค. ์„ธ์…˜ ID๋Š” ๋‚œ์ˆ˜, ํ•ด์‹ฑ๋œ ์ตœ์ข… ์‚ฌ์šฉ์ž ์‹๋ณ„์ž ๋˜๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์ƒ์„ฑํ•˜๊ธฐ ํŽธ๋ฆฌํ•œ ๊ธฐํƒ€ ๊ฐ’์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์„ธ์…˜ ์ด๋ฆ„์˜ ์œ„์น˜ ID ๊ฐ’์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๋ฆฌ์ „ํ™” ๋ฌธ์„œ๋ฅผ ํ™•์ธํ•˜์„ธ์š”.

์˜ค๋ž˜ ์ง€์†๋˜๋Š” ์„ธ์…˜

๊ธฐ๋ณธ์ ์œผ๋กœ ๋Œ€ํ™”ํ˜• ์—์ด์ „ํŠธ(Dialogflow CX)๋Š” 30๋ถ„ ๋™์•ˆ ์„ธ์…˜ ๋ฐ์ดํ„ฐ๋ฅผ ์œ ์ง€ํ•ฉ๋‹ˆ๋‹ค. ์„ธ์…˜์˜ ์ „์ฒด ๊ธฐ๊ฐ„์„ ์—ฐ์žฅํ•˜๋Š” ๋ฐฉ๋ฒ•์—๋Š” ๋‘ ๊ฐ€์ง€๊ฐ€ ์žˆ์Šต๋‹ˆ๋‹ค.

  • (๊ถŒ์žฅ) QueryParameters.session_ttl์„ ์‚ฌ์šฉํ•˜์—ฌ ์„ธ์…˜ TTL์„ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค. ํ—ˆ์šฉ๋˜๋Š” ์ตœ๋Œ“๊ฐ’์€ 24์‹œ๊ฐ„์ž…๋‹ˆ๋‹ค.
  • DetectIntentRequest์—์„œ QueryParameters.current_page ๋ฐ QueryParameters.parameters๋ฅผ ์„ค์ •ํ•˜์—ฌ ์ด์ „ ์„ธ์…˜ ์ƒํƒœ๋ฅผ ๋˜์‚ด๋ฆด ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    ์›Œํฌํ”Œ๋กœ ์˜ˆ์‹œ๋Š” ๋‹ค์Œ๊ณผ ๊ฐ™์Šต๋‹ˆ๋‹ค.

    1. ์ตœ์ข… ์‚ฌ์šฉ์ž๊ฐ€ ์„ธ์…˜ A์—์„œ ์—์ด์ „ํŠธ์™€ ๋Œ€ํ™”ํ•ฉ๋‹ˆ๋‹ค.
    2. ์ฝ”๋“œ๋Š” API ์‘๋‹ต์—์„œ ๋ฐ˜ํ™˜๋œ ์„ธ์…˜ A์™€ ์—ฐ๊ฒฐ๋œ ์ƒํƒœ(QueryResult.current_page ๋ฐ QueryResult.parameters)๋ฅผ ๊ธฐ๋กํ•ฉ๋‹ˆ๋‹ค.
    3. ์ตœ์ข… ์‚ฌ์šฉ์ž๊ฐ€ 50๋ถ„ ํ›„ ์—์ด์ „ํŠธ์™€์˜ ์ƒํ˜ธ์ž‘์šฉ์„ ์ค‘์ง€ํ•ฉ๋‹ˆ๋‹ค.
    4. ์ตœ์ข… ์‚ฌ์šฉ์ž๊ฐ€ ์—์ด์ „ํŠธ์—๊ฒŒ ๋‹ค์‹œ ๋ฌธ์˜ํ•ฉ๋‹ˆ๋‹ค.
    5. ์ฝ”๋“œ๋Š” ์•ž์—์„œ ๊ธฐ๋กํ•œ QueryParameters.current_page ๋ฐ QueryParameters.parameters์™€ ํ•จ๊ป˜ ์ตœ์ข… ์‚ฌ์šฉ์ž ์ž…๋ ฅ์„ ์ „์†กํ•˜์—ฌ ์ด์ „ ์„ธ์…˜ ์ƒํƒœ์˜ ์ธํ…ํŠธ๋ฅผ ๊ฐ์ง€ํ•ฉ๋‹ˆ๋‹ค. ์„ธ์…˜ A์™€ ๋™์ผํ•œ ์„ธ์…˜ ID๋ฅผ ์‚ฌ์šฉํ•  ํ•„์š”๋Š” ์—†์Šต๋‹ˆ๋‹ค.

์ฐธ์กฐ

์„ธ์…˜ ๊ฐ€๊ฒฉ ์ฑ…์ •์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ๊ฐ€๊ฒฉ ์ฑ…์ • ํŽ˜์ด์ง€๋ฅผ ์ฐธ์กฐํ•˜์„ธ์š”.

์„ธ์…˜์— ๋Œ€ํ•œ ์ž์„ธํ•œ ๋‚ด์šฉ์€ ํ•˜์„ธ์š”.

์„ธ์…˜ ์ฐธ์กฐ์˜ ํ”„๋กœํ† ์ฝœ ๋ฐ ๋ฒ„์ „์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค.

ํ”„๋กœํ† ์ฝœ V3 V3beta1
REST ์„ธ์…˜ ๋ฆฌ์†Œ์Šค ์„ธ์…˜ ๋ฆฌ์†Œ์Šค
RPC ์„ธ์…˜ ์ธํ„ฐํŽ˜์ด์Šค ์„ธ์…˜ ์ธํ„ฐํŽ˜์ด์Šค
C++ SessionsClient ํ•ด๋‹น ์‚ฌํ•ญ ์—†์Œ
C# SessionsClient ํ•ด๋‹น ์‚ฌํ•ญ ์—†์Œ
Go SessionsClient ํ•ด๋‹น ์‚ฌํ•ญ ์—†์Œ
์ž๋ฐ” SessionsClient SessionsClient
Node.js SessionsClient SessionsClient
PHP ์—†์Œ ํ•ด๋‹น ์‚ฌํ•ญ ์—†์Œ
Python SessionsClient SessionsClient
Ruby ์—†์Œ ํ•ด๋‹น ์‚ฌํ•ญ ์—†์Œ