Skip to content
์—์ด์ „ํŠธ ์„œํ”ผ์Šค

์ด ์‚ฌ์ดํŠธ๋Š” ์ฝ๊ธฐ๋งŒ ๊ฐ€๋Šฅํ•œ ๊ฒƒ์ด ์•„๋‹ˆ๋ผ, ์กฐ์ž‘๋„ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค.

์ด ๋ฒ”์ฃผ์˜ ๊ฑฐ์˜ ๋ชจ๋“  ๋งˆ์ผ€ํŒ… ์‚ฌ์ดํŠธ๋Š” ์—์ด์ „ํŠธ๊ฐ€ ์Šคํฌ๋ฆฐ์ƒท์„ ์ฐ๊ณ  ์ถ”์ธกํ•ด์•ผ ํ•˜๋Š” ๋ฒฝ์ž…๋‹ˆ๋‹ค. ์ด ์‚ฌ์ดํŠธ๋Š” ๋Œ€์‹  ๋ธŒ๋ผ์šฐ์ €์—์„œ WebMCP๋ฅผ ํ†ตํ•ด ๊ทธ๋ฆฌ๊ณ  ๋‹ค๋ฅธ ๊ณณ์—์„œ๋Š” JSON-RPC๋ฅผ ํ†ตํ•ด ํƒ€์ž…์ด ์ง€์ •๋œ ๋„๊ตฌ ๋ชฉ๋ก์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค. ์ด๋Š” ๋งˆ์ผ€ํŒ… ์‚ฌ์ดํŠธ์—์„œ ์ˆ˜ํ–‰๋˜๋Š” ์ œํ’ˆ ์ž์ฒด์˜ ์ฃผ์žฅ์ž…๋‹ˆ๋‹ค.

โ† Back to the agent directory

ํ™•์ธ ์ค‘

๋ธŒ๋ผ์šฐ์ €๊ฐ€ ์•„์ง navigator.modelContext๋ฅผ ์ถœ์‹œํ•˜์ง€ ์•Š์•˜์Šต๋‹ˆ๋‹ค. 2026๋…„๋ถ€ํ„ฐ ๋Œ€๋ถ€๋ถ„์€ ๊ทธ๋ ‡์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ๋™์ผํ•œ ๋„๊ตฌ๋ฅผ /api/mcp์˜ JSON-RPC๋ฅผ ํ†ตํ•ด ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ ๋ธŒ๋ผ์šฐ์ € ์ง€์›์ด ํ•„์š”ํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

  • list_bag_modules์ฝ๊ธฐ ์ „์šฉ

    List every capability module AgentBag ships, each with a published status (live, beta, or bench) and the caveat that goes with it. Optionally filter by status. Use this first to understand what the product actually does.

    example: {"status":"bench"}

  • get_bag_module์ฝ๊ธฐ ์ „์šฉ

    Fetch the full published entry for one module: what it does, why it matters, how it works, its status caveat, and its FAQs. Use after list_bag_modules when you need depth on a specific capability.

    example: {"slug":"trustgraph"}

  • search_bag์ฝ๊ธฐ ์ „์šฉ

    Answer a natural-language question strictly from the published capability ledger, returning citations to the modules the answer came from. Declines rather than speculating when the ledger does not cover the question.

    example: {"question":"What stops one agent reading another agent data?"}

  • check_workspace_address์ฝ๊ธฐ ์ „์šฉ

    Turn a proposed team name into the tenant subdomain it would become, and report whether that label is usable. Does not reveal whether an address is already taken; that is deliberate.

    example: {"name":"Acme Robotics"}

  • answer_faq์ฝ๊ธฐ ์ „์šฉ

    Answer a common question about AgentBag in machine form: a terse declarative answer plus a flat object of primitive-valued facts you can assert against without parsing prose. Prefer this over search_bag for questions about pricing, limits, privacy, tenancy or how to evaluate the product. Call with no arguments to list every question.

    example: {"question":"what is not built yet"}

  • get_pricing_status์ฝ๊ธฐ ์ „์šฉ

    Report the current pricing position honestly, including the fact that billing is deliberately disarmed and no numbers are published yet.

    example: {}

  • join_waitlist๋ถ€์ˆ˜ ํšจ๊ณผ ๋ฐœ์ƒ

    Submit an email address to the AgentBag waitlist, optionally reserving a workspace address. This sends data on the user behalf; confirm with them before calling it.

    example: {"email":"you@example.com","workspace":"acme"}

    ์—ฌ๊ธฐ์„œ ์‹คํ–‰ ๋ถˆ๊ฐ€
์—”๋“œํฌ์ธํŠธ

๋จธ์‹ ์— ํ•„์š”ํ•œ ๋ชจ๋“  ๊ฒƒ.

ํ„ฐ๋ฏธ๋„์—์„œ ์‹คํ–‰ํ•ด ๋ณด๊ธฐ

curl -s https://agentbag.ai/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -s https://agentbag.ai/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"list_bag_modules","arguments":{"status":"bench"}}}'
์–ด๋””์—๋‚˜ ์ž„๋ฒ ๋“œ

์Šคํฌ๋ฆฝํŠธ ํƒœ๊ทธ ํ•˜๋‚˜๋กœ ์‚ฌ์ดํŠธ์— ์—์ด์ „ํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜์„ธ์š”.

์›ํ•˜๋Š” ํŽ˜์ด์ง€์— JavaScript ํ•œ ์ค„๋งŒ ์ถ”๊ฐ€ํ•˜์„ธ์š”. ๊ตฌ์„์— ๋ธŒ๋žœ๋“œ ๋Ÿฐ์ฒ˜๊ฐ€ ํ‘œ์‹œ๋˜๋ฉฐ, ๋ฐฉ๋ฌธ์ž๊ฐ€ ์ด๋ฅผ ํด๋ฆญํ•˜๋ฉด ์ƒŒ๋“œ๋ฐ•์Šค ํŒจ๋„ ๋‚ด์—์„œ ๊ฒŒ์‹œ๋œ ์—์ด์ „ํŠธ์™€ ๋Œ€ํ™”ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ด€๋ฆฌํ•  iframe๋„, ์—ฐ๊ฒฐํ•  ์ธ์ฆ๋„, ๋นŒ๋“œ ๋‹จ๊ณ„๋„ ํ•„์š” ์—†์Šต๋‹ˆ๋‹ค. ์—์ด์ „ํŠธ๋Š” ํŽ˜์ด์ง€๋ฅผ ์ฝ๊ณ  ๋งฅ๋ฝ์— ๋งž๊ฒŒ ๋‹ต๋ณ€ํ•˜๋ฉฐ, ๋™์˜ ์‹œ UI์™€ ์ƒํ˜ธ์ž‘์šฉํ•  ์ˆ˜๋„ ์žˆ์Šต๋‹ˆ๋‹ค.

์‚ฌ์ดํŠธ์— ๋ถ™์—ฌ๋„ฃ๊ธฐ

<script
  src="https://agentbag.ai/embed.js"
  data-agent="<your-agent-folder-id>"
  data-accent="#5f6f3c"
  data-launcher="Chat with us"
  data-voice="on"
  data-page-context="on"
></script>

Shadow DOM ๊ฒฉ๋ฆฌ

์œ„์ ฏ์€ Shadow DOM ๋ฃจํŠธ ๋‚ด์— ๋ Œ๋”๋ง๋ฉ๋‹ˆ๋‹ค. ๊ท€ํ•˜์˜ CSS๊ฐ€ ์œ„์ ฏ์„ ๊นจ๋œจ๋ฆด ์ˆ˜ ์—†์œผ๋ฉฐ, ์œ„์ ฏ ์—ญ์‹œ ๊ท€ํ•˜์˜ CSS๋ฅผ ๊นจ๋œจ๋ฆฌ์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์–ด๋–ค ์‚ฌ์ดํŠธ์—์„œ๋„ ์Šคํƒ€์ผ ์ถฉ๋Œ์ด ์ „ํ˜€ ๋ฐœ์ƒํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ƒŒ๋“œ๋ฐ•์Šค ์ฒ˜๋ฆฌ๋œ iframe

์ฑ„ํŒ… ํŒจ๋„์€ ์—„๊ฒฉํ•œ ์ƒŒ๋“œ๋ฐ•์Šค ๋‚ด์—์„œ ๋กœ๋“œ๋ฉ๋‹ˆ๋‹ค. ์ตœ์ƒ์œ„ ํƒ์ƒ‰(top navigation)์ด ์—†๊ณ , ์ž๊ฒฉ ์ฆ๋ช… ์œ ์ถœ๋„ ์—†์Šต๋‹ˆ๋‹ค. ๊ฒŒ์ŠคํŠธ ํ† ํฐ์€ ํ”„๋ ˆ์ž„ ๋‚ด์— ์œ ์ง€๋ฉ๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŠธ ํŽ˜์ด์ง€๋Š” ์ ˆ๋Œ€ ๋…ธ์ถœ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์ง€์—ฐ ๋กœ๋“œ๋จ

์‚ฌ์šฉ์ž๊ฐ€ ๋Ÿฐ์ฒ˜๋ฅผ ํด๋ฆญํ•˜๊ธฐ ์ „๊นŒ์ง€๋Š” iframe์ด ์ƒ์„ฑ๋˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ํŽ˜์ด์ง€ ๋กœ๋“œ์— ๋ฏธ์น˜๋Š” ์˜ํ–ฅ์€ ์ „ํ˜€ ์—†์Šต๋‹ˆ๋‹ค. ์‹ค์ œ๋กœ ๋Œ€ํ™”๋ฅผ ์›ํ•˜๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ๋‚˜ํƒ€๋‚˜๊ธฐ ์ „๊นŒ์ง€๋Š” ์ˆจ๊ฒจ์ง„ ๋„คํŠธ์›Œํฌ ์š”์ฒญ์ด ๋ฐœ์ƒํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

์„ค์ •

  • data-agent"<folder-id>"
    Your published agent folder ID. Required.
  • data-accent"#5f6f3c"
    Brand color for the launcher button and accents.
  • data-launcher"Chat with us"
    Custom text on the launcher pill. Up to 40 characters.
  • data-voice"on"
    Enable voice input. Users can speak instead of type.
  • data-position"left" | "right"
    Which corner the launcher appears in. Default: right.
  • data-theme"light" | "dark" | "auto"
    Color scheme for the chat panel.
  • data-page-context"on"
    Let the agent read visible page content to give contextual answers.
  • data-page-actions"on"
    Let the agent interact with the page: click, scroll, highlight elements.
  • data-context-selector"main"
    CSS selector scoping which content the agent can read. Default: main or article.

๋‚ด๋ถ€ ์ž‘๋™ ์›๋ฆฌ

  1. 1. ๋กœ๋”๊ฐ€ ํŽ˜์ด์ง€์—์„œ ์‹คํ–‰๋ฉ๋‹ˆ๋‹ค. Shadow DOM ํ˜ธ์ŠคํŠธ๋ฅผ ์ƒ์„ฑํ•˜๊ณ  ๋Ÿฐ์ฒ˜ ๋ฒ„ํŠผ์„ ๊ทธ๋ฆฝ๋‹ˆ๋‹ค. ์•„์ง iframe์€ ์ƒ์„ฑ๋˜์ง€ ์•Š์œผ๋ฉฐ ๋„คํŠธ์›Œํฌ ๋น„์šฉ๋„ ๋ฐœ์ƒํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.
  2. 2. ์‚ฌ์šฉ์ž๊ฐ€ ๋Ÿฐ์ฒ˜๋ฅผ ํด๋ฆญํ•ฉ๋‹ˆ๋‹ค. iframe์ด ์ƒ์„ฑ๋˜๋ฉฐ sandbox ์ œํ•œ ์‚ฌํ•ญ์ด ์ ์šฉ๋œ ์ƒํƒœ๋กœ ๋‹น์‚ฌ ์˜ค๋ฆฌ์ง„์—์„œ ๋กœ๋“œ๋ฉ๋‹ˆ๋‹ค. ๊ฒŒ์ŠคํŠธ ์„ธ์…˜์ด ์‹œ์ž‘๋ฉ๋‹ˆ๋‹ค.
  3. 3. ํŽ˜์ด์ง€ ๋งฅ๋ฝ ์œ ์ž… (์„ ํƒ ์‚ฌํ•ญ). ๋งŒ์•ฝ data-page-context="on", ๋กœ๋”๊ฐ€ ํŽ˜์ด์ง€์—์„œ ๋ณด์ด๋Š” ํ…์ŠคํŠธ๋ฅผ ์ถ”์ถœํ•˜์—ฌ ๋งฅ๋ฝ์— ๋งž๋Š” ๋‹ต๋ณ€์„ ์ œ๊ณตํ•  ์ˆ˜ ์žˆ๋„๋ก ์—์ด์ „ํŠธ์— ์ „์†กํ•ฉ๋‹ˆ๋‹ค.
  4. 4. ํŽ˜์ด์ง€ ์•ก์…˜์œผ๋กœ UI ์ œ์–ด (์„ ํƒ ์‚ฌํ•ญ). ๋งŒ์•ฝ data-page-actions="on", ์—์ด์ „ํŠธ๊ฐ€ ์‚ฌ์šฉ์ž๋ฅผ ์•ˆ๋‚ดํ•˜๊ธฐ ์œ„ํ•ด ํŽ˜์ด์ง€์˜ ์š”์†Œ๋ฅผ ๊ฐ•์กฐ ํ‘œ์‹œํ•˜๊ณ , ์Šคํฌ๋กคํ•˜๊ณ , ํด๋ฆญํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.