본문 바로가기
WIKI 기술 지식 베이스

에이전트 파일시스템 변경 감사하기

원문 보기 위키 갱신

AgentFS는 모든 파일 작업과 도구 호출을 기록해서 에이전트 동작을 완전히 들여다볼 수 있게 해줘요. 디버깅, 컴플라이언스, 그리고 에이전트가 어떻게 작동하는지 이해하는 데 꼭 필요한 기능이에요.

출처: 문서

본문

타임라인 보기

도구 호출을 시간 순서대로 나열해서 볼 수 있어요:

agentfs timeline my-session

출력 결과:

ID   TOOL                 STATUS       DURATION STARTED
4    execute_code         pending            -- 2024-01-05 09:44:20
3    api_call             error           300ms 2024-01-05 09:44:15
2    read_file            success          50ms 2024-01-05 09:44:10
1    web_search           success        1200ms 2024-01-05 09:43:45

결과 필터링

특정 도구 유형만 보여주기:

agentfs timeline my-session --filter web_search

오류만 보여주기:

agentfs timeline my-session --status error

항목 수 제한하기:

agentfs timeline my-session --limit 20

JSON 출력

프로그래밍 방식으로 분석할 때:

agentfs timeline my-session --format json

[
  {
    "id": 1,
    "name": "web_search",
    "status": "success",
    "started_at": 1704447825,
    "completed_at": 1704447826,
    "duration_ms": 1200,
    "parameters": {"query": "AI agents"},
    "result": {"results": ["result1", "result2"]}
  }
]

파일 살펴보기

세션의 모든 파일 목록 보기:

agentfs fs ls my-session

출력 결과:

d artifacts
f config.json
f output.txt

하위 디렉터리 목록 보기:

agentfs fs ls my-session /artifacts

파일 내용 읽기:

agentfs fs cat my-session /output.txt

변경 내역 보기 (Diff)

원본 파일시스템과 비교해서 무엇이 바뀌었는지 확인할 수 있어요:

agentfs diff my-session

다음 항목들이 보여요:

  • 새로 생성된 파일
  • 수정된 파일
  • 삭제된 파일

SQL로 조회하기

AgentFS는 SQLite를 사용하므로 자유로운 쿼리를 실행할 수 있어요:

Turso:

tursodb .agentfs/my-session.db

SQLite:

sqlite3 .agentfs/my-session.db

쿼리 예시:

-- Find all tool calls that took longer than 1 second
SELECT name, duration_ms
FROM toolcalls
WHERE duration_ms > 1000;

-- Count tool usage by type
SELECT name, COUNT(*) as count
FROM toolcalls
GROUP BY name
ORDER BY count DESC;

-- Find files modified in the last hour
SELECT path, mtime
FROM fs_inode
WHERE mtime > strftime('%s', 'now', '-1 hour');

-- Get total bytes written
SELECT SUM(size) as total_bytes
FROM fs_inode
WHERE mode & 0170000 = 0100000;  -- regular files only

활용 사례

에이전트 실패 디버깅

에이전트가 실패했을 때 타임라인을 보면 무슨 일이 있었는지 파악할 수 있어요:

# See recent activity
agentfs timeline my-session --limit 20

# Focus on errors
agentfs timeline my-session --status error

# Check what files were created/modified
agentfs fs ls my-session

성능 분석

느린 작업 찾기:

SELECT name, AVG(duration_ms) as avg_ms, COUNT(*) as count
FROM toolcalls
GROUP BY name
ORDER BY avg_ms DESC;

컴플라이언스 감사

에이전트 활동의 전체 기록을 내보내기:

agentfs timeline my-session --format json > audit-log.json

더 알아보기 (Learn more)