AgentBase presentation preview
← → để chuyển slide

AgentBase

Source-backed knowledge for AI-assisted teams

VẤN ĐỀ 02 / 24
THE CONTEXT GAP

Context nằm giữa
các repository.

Source có authority trong từng repo. System behavior lại đi qua dependency, event và ownership boundary.

MULTIrepository change
EVENTScross boundaries
REPEATrebuild context
PRODUCT / DELIVERYKhó thấy đúng impact
ENGINEERING / AGENTPhải dựng lại dependency
AGENTBASE / PROBLEM SPACE 02
AGENTBASE LÀ GÌ? 03 / 24
PRODUCT PROMISE

Một mental model
đơn giản.

Shared Markdown knowledge, được kết nối với AI agent qua MCP.

KNOWLEDGE BASEMarkdownknowledge
CONSUMERAI Agentask · retrieve · use
THREE PROPERTIESSource-backed · Reviewable · Compounding
AGENTBASE / INTRODUCTION 03
IROCO2 · ƯỚC TÍNH PHÁT THẢI CLOUD04 / 24
CUR = AWS COST AND USAGE REPORT

Từ yêu cầu mơ hồ
đến đúng điểm bắt đầu.

CHANGE REQUESTRetry và visibility cho luồng CUR Analyzer → backend sẽ chạm vào đâu?
REPOSITORYIroco2 Lambdas
→
BOUNDARYAnalyzer SQS
→
REPOSITORYIroco2 Backend
→
RESULTKết quả phân tích
KNOWNproducer · consumer · owning repositories
OPENdeployed identity · retry policy · recovery owner
Không phải câu trả lời hoàn chỉnh — là đúng điểm bắt đầu.
AGENTBASE / PROBLEM → PROOF04
THỨ MÌNH CẦN 05 / 24
PERSISTENT · COMPOUNDING

Knowledge phải được
tích lũy.

Không đọc và dựng lại mọi thứ từ đầu sau mỗi câu hỏi.

“The wiki is a persistent,
compounding artifact.”

ANDREJ KARPATHY · LLM WIKI
MỖI CÂU HỎIRaw sources → Retrieve → Tổng hợp lạiKnowledge bị dựng lại
VS
LLM WIKISources + Questions → Linked MarkdownKnowledge tiếp tục lớn dần ↗
AGENTBASE / KNOWLEDGE PRINCIPLE 05
FOUNDATION · ENOUGH TECHNOLOGY TO TRUST THE STORY06 / 24
OPEN STRUCTURE · CONTROLLED ACCESS · VERIFIABLE CLAIMS

Ba foundation.
Một knowledge lifecycle.

01 · STRUCTUREOKF

Markdown + metadata
portable knowledge

02 · ACCESSMCP

contract tools
agent integration

03 · AUTHORITYExact source

repo · revision
path · line span

AGENTreason · investigate · authorMCPvalidate boundariesHUMANSreview · publish
AGENTBASE / FOUNDATION06
KNOWLEDGE LIFECYCLE · AUTHORITY STAYS EXPLICIT07 / 24
SOURCE → SHARED KNOWLEDGE

Agent chuẩn bị.
Con người quyết định.

AUTHORITYExact
source
repo · revision · lines
→
AGENT + MCPReviewable
proposal
investigate · author · validate
→
HUMAN CONFIRMATIONConfirm
Publish
review material changes
→
HUMAN REVIEWPublished
Hub
Direct · or PR policy
VALIDcontract-compliant, not necessarily complete
MCP LIMITnever approves or merges
AGENTBASE / LIFECYCLE07
PRODUCT DEMO · ONE CONTROLLED STORY08 / 24
IROCO2 DOMAIN

Một yêu cầu minh hoạ
đi qua AgentBase thế nào?

CHANGE REQUEST Cải thiện retry và khả năng theo dõi lỗi cho luồng CUR Analyzer → backend. Yêu cầu ngắn · impact xuyên repository
01IMPACTNó chạm vào đâu?
→
02CONFIDENCEFact và unknown là gì?
→
03HANDOFFPhase tiếp theo nhận gì?
FEATURE DISCOVERY→DIAGRAM→DOMAIN HUB→TASK PLANNING
AGENTBASE / DEMO SETUP08
ỨNG DỤNG · XÁC ĐỊNH PHẠM VI09 / 24
HUB FIRST · SOURCE LATER

Discovery bắt đầu bằng
đúng boundary.

MINH HOẠ · KHÔNG PHẢI TRANSCRIPT
YOU

Retry và visibility cho luồng CUR Analyzer → backend sẽ chạm vào đâu?

AGENT

Mình sẽ bắt đầu từ Published Hub của domains/iroco2.

RESULT

2 repositories · producer + consumer evidence

PUBLISHED IMPACT SURFACEqualification · 040eb38df7fa
REPOSITORYIroco2 LambdasCUR Analyzer
→
BOUNDARYAnalyzer SQSsource-backed · AWS mock
→
REPOSITORYIroco2 BackendSQS consumer
AnalysisEstimates
STILL OPENDeployed identity?Desired retry policy?Alarm?Recovery owner?
DIAGRAM SHOWSaccepted scopeEVIDENCE BOUNDSwhat knowledge can claim
AGENTBASE / FEATURE DISCOVERY09
DOMAIN HUB · HUMAN-READABLE PROJECTION10 / 24
FROM MAP TO EVIDENCE

Con người có thể
drill down.

Published Domain · Iroco2AWS MOCK · 040eb38df7fa
Iroco2 System map với embedded resources bật sẵn và các kết nối Published
01Choose a viewSystem map · By repository
02Explore connectionssearch · select · focus
03Inspect evidencesource · provenance · commit
DOMAIN HUBreview & exploreAUTHORITYPublished OKF + source citations
AGENTBASE / DOMAIN HUB10
ỨNG DỤNG · CHUẨN BỊ KẾ HOẠCH11 / 24
FROM SHARED SCOPE TO EXACT SOURCE

Knowledge thu hẹp.
Source quyết định.

FEATURE DISCOVERY HANDOFF Accepted route CUR Analyzer → analyzer SQS → backend consumer Owner decisions

desired retry policy · alarm · recovery

CODE GRAPH→EXACT SOURCE
TASK LIST MINH HOẠstructured, reviewable
T1
Confirm deployed queueLambdas producer · backend consumer
AWS mock → verify live
T2
Retry / redrivecandidate: Lambdas Terraform + backend listener
review existing policy
T3
Operational visibilityalarm · notification · runbook
acceptance criteria
EACH TASK CARRIESdependency · acceptance · citation · remaining unknown
AGENTBASE / TASK PLANNING11
UPDATE KNOWLEDGE · ONE INTENTION12 / 24
FAST BY DEFAULT · RECOVER WHEN NEEDED

Knowledge thay đổi.
Knowledge còn thiếu.

DEFAULTCập nhật thay đổi

Exact Git delta
new + changed evidence

FAST PATH
EXPLICIT RECOVERYBổ sung phần thiếu

Weak or sparse coverage
source may be unchanged

BOUNDED PATH
USER INTENT
Add repositoryUpdate knowledge
Preview before Publish · no automatic provider reads
FRESHNESS WARNSuser requests updateNO AUTO DELETEabsence ≠ evidenceNO COMPLETENESS CLAIM
AGENTBASE / REFRESH & RECOVERY12
POSITIONING · WHAT AGENTBASE ADDS13 / 24
NOT A BINARY CHOICE

AgentBase thêm một
knowledge lifecycle.

Không tuyên bố Markdown hay RAG là sai — chúng giải quyết những lớp khác.

PLAIN MARKDOWNDurable documents

Con người đọc và chỉnh sửa tốt.

Schema, provenance và lifecycle cần xây thêm.
RAGRelevant retrieval

Tìm source chunks phù hợp lúc hỏi.

Reviewed synthesis và authority cần xây thêm.
AGENTBASEGoverned knowledge

Source-backed · reviewable · compounding.

Không thay thế mọi search/RAG use case.
POSITIONMột lifecycle cho shared knowledge — không phải replacement cho mọi search hoặc RAG.
AGENTBASE / POSITIONING13
RELEASE BOUNDARY · NOW WHAT14 / 24
READY TO LEARN FROM REAL USE

Internal release.
Bounded pilot.

READY NOWCore lifecycle
  • Add repository
  • Update knowledge · Query
  • Confirm Publish · Direct/PR
  • Linux x64 release path
NOT CLAIMEDNo false certainty
  • perfect completeness
  • generalized ROI / scale
  • public hostile security
  • every workflow benefits
PILOT ASKOne real Domain
  • named owners
  • bounded repositories
  • review real changes
  • measure usefulness
LEARNreview effort · escaped semantic defects · context reuse · unresolved questions
AGENTBASE / INTERNAL RELEASE14
AGENTBASE

Context agents can explain.
Knowledge teams can correct.

01SOURCE-BACKEDbiết từ đâu
02REVIEWABLEcon người sửa được
03COMPOUNDINGtốt dần theo thời gian
OPTIONAL TECHNICAL DEEP DIVE · ~7 MINUTES

How AgentBase keeps
knowledge reviewable.

TAKEAWAY NẾU DỪNG Ở ĐÂYAgent reasons·MCP validates boundaries·Humans publish
AGENTBASE / OPTIONAL APPENDIX16
PIPELINE OVERVIEW17 / 24
FIVE STAGES · ONE REVIEWABLE RESULT

Từ source đến knowledge
có thể review.

01PreflightĐúng repo
và revision
→
02DiscoverChọn điều
đáng giữ
→
03InvestigateKiểm chứng
bằng source
→
04AuthorViết
knowledge
→
05ValidateKiểm tra
contract
SAU 5 BƯỚCFinalize · Inspect → Confirm Publish → Direct hoặc PR
AGENTBASE / INITIAL INGEST OVERVIEW17
HOW I DESIGNED THE PIPELINE18 / 24
STAGE 01

Preflight

Khóa identity, revision và preliminary home scope trước khi đọc code.

VẤN ĐỀAgent có thể hiểu đúng code nhưng gắn nó vào sai context.
Ý TƯỞNG CỦA MÌNH
01REPOSITORY IDENTITYĐúng repository

origin · checkout · ownership

02SOURCE REVISIONExact commit

evidence cùng một snapshot

03PRELIMINARY HOMEInitial scope

grouped plan confirmed later

OUTPUTAuthorized Source Snapshotidentity + revision + preliminary home scope
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST18
HOW I DESIGNED THE PIPELINE19 / 24
STAGE 02

Discover

Tìm phần đáng trở thành knowledge, không inventory toàn bộ codebase.

VẤN ĐỀCopy mọi source artifact sang Markdown chỉ tạo ra một knowledge base nhiễu và nhanh stale.
Ý TƯỞNG CỦA MÌNH
RAW SIGNALSfunctionseventsqueuesroutesresourcesconfigs
→BOUNDED
DISCOVERY
KNOWLEDGE CANDIDATESConcept · RelationQuestion · Ignore(reason)
OUTPUTBounded candidate setsparse by design · Question/Ignore được phép
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST19
HOW I DESIGNED THE PIPELINE20 / 24
STAGE 03

Investigate

Dùng Code Graph để tìm đường, dùng exact source để kiểm chứng.

VẤN ĐỀCandidate chỉ là một giả thuyết; agent không được biến suy đoán thành fact.
Ý TƯỞNG CỦA MÌNH
INPUTCandidategiả thuyết
→
NAVIGATECode Graphsymbols · callers · paths
→
VERIFYExact Sourcepath · revision · lines
→
OUTPUTEvidencenormalized · bounded
BOUNDARYRaw graph stays localchỉ normalized evidence đi tiếp
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST20
HOW I DESIGNED THE PIPELINE21 / 24
STAGE 04

Author

MCP giữ structure; coding agent tập trung viết meaning.

VẤN ĐỀĐể agent tự dựng YAML, ID và relation từ đầu khiến format dễ drift và khó kiểm soát.
Ý TƯỞNG CỦA MÌNH
AGENTBASE-MCPGenerated OKF skeleton

paths · IDs · frontmatter
sources · relations · navigation

STRUCTURE CONTRACT
+
CODING AGENTEnriched meaning

purpose · architecture
behavior · limitations

REASONING + WRITING
OUTPUTEditable Markdown proposalcon người đọc và sửa trực tiếp
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST21
HOW I DESIGNED THE PIPELINE22 / 24
STAGE 05

Validate

MCP kiểm tra deterministically trước khi gọi output là proposal.

VẤN ĐỀAgent không thể tự chứng nhận citation, relation và schema do chính nó vừa viết.
Ý TƯỞNG CỦA MÌNH
01CITATIONSrepo · revision
path · line span
02RELATIONSendpoints
evidence · type
03SCHEMAOKF type
frontmatter · nav
04LIMITSprotected bytes
size · sensitive data
PASSFinalized inspectionvalid ≠ complete
FAILRepairable workspace
01Preflight
02Discover
03Investigate
04Author
05Validate
AGENTBASE / INITIAL INGEST22
AFTER THE FIVE STAGES23 / 24
HUMAN AUTHORITY

Sau Validate,
con người quyết định.

EDITABLEValidated
Workspace
Finalize · Inspect
→
HUMAN CONFIRMATIONConfirm
Publish
exact reviewed result
→
HUB POLICYDirect
or PR
one complete change
→
QUERY AUTHORITYPublished
OKF
Direct recognition · or PR sync
HUMANPreview · confirm PublishMCP LIMITNever approve or merge
AGENTBASE / REVIEW & PUBLICATION23
RUNTIME ARCHITECTURE24 / 24
SEPARATE REASONING FROM AUTHORITY

Agent reasoning.
MCP giữ boundary.

AI AGENT + SKILLSreason · investigate · synthesize · authorNO MODEL SDK / KEY INSIDE MCP
↓ MCP · stdio / Streamable HTTP
BUSINESS TOOLS + WORKFLOW ORCHESTRATIONfive-stage authoring · refresh · query · review/publishscope · scaffold · validate · transition
↓
CORE CONTRACTScode intelligence · knowledge · hub · queryprovider-neutral
↓ ADAPTERS
Codebase MemoryLocal Git / HubGitHubProvider observations
PRIVATE BOUNDARYsource: read-only authority · raw graph: rebuildable
SHARED BOUNDARYreviewed Git-backed Published Hub
AGENTBASE / MCP ARCHITECTURE24
1 / 1