Agent Environment

Agent environment는 agent가 observe하거나 change할 수 있는 external state입니다. File, repository, terminal, web page, API, queue, issue tracker, generated artifact가 포함될 수 있습니다.

간단한 transition view는 아래와 같습니다.

$$s_{t+1}=T(s_t,a_t,e_t)$$

$s_t$는 agent의 working state, $a_t$는 selected action, $e_t$는 environment state, $T$는 action과 observation이 만든 transition입니다.

Environment는 agent 밖에 있는 truth source입니다. 대화 안의 말, plan, memory는 environment state를 대체하지 못합니다.

Environment type

Type	Examples	Typical action	Verification
Read-only	search result, log, documentation, repository file	inspect and cite	source path, selected evidence
Editable	source file, Markdown note, configuration, generated artifact	patch or regenerate	diff, build, rendered check
External	API, CI system, deployment target, issue tracker	query or mutate	remote status, URL, audit log
Human	approval, feedback, task constraint, review decision	ask or wait	explicit response

중요한 이유

Agent는 text context와 actual external state를 혼동할 때 실패합니다. Conversation에 쓴 plan은 file이 바뀌었거나 build가 통과했거나 deployment가 성공했다는 증거가 아닙니다. Environment는 직접 inspect해야 합니다.

State Boundary

Boundary	예	확인 방식
Local workspace	file, git status, generated output	rg, diff, build
Remote service	GitHub Actions, Pages, PR, issue	CLI/API status
Runtime	server, browser, queue job	smoke check, logs
Human state	approval, review decision	explicit response

확인할 것

• agent가 어떤 external state를 observe할 수 있는가?
• agent가 어떤 external state를 change할 수 있는가?
• 어떤 action이 read-only이고 어떤 action이 side-effecting인가?
• environment가 의도대로 바뀌었음을 어떤 evidence가 증명하는가?
• generated 또는 out of scope라서 무시해야 할 state는 무엇인가?
• local success와 remote deployed success를 구분했는가?

Blog/Wiki Environment Map

Environment	Truth source	Typical verifier
Local content	content/**/*.md	diff, link check
Build output	public/ generated by Quartz	npx quartz build
Git state	branch, staged files, commit	git status, git log
Public site	GitHub Pages deployment	Actions run status, rendered URL
Uncurated input	content/inbox/	publishing gate and sanitization check

Related

• Agent loop
• Agent state
• Action space
• Tool use
• Verification loop