Продакшн-агенты на базе AI з FastAPI, LangGraph і чыстай архітектуры.
Межы слоёў, стан графа, тэставаныя сервісы і формат развертывання, які дазволяе агентам залишацца падтрымуванымі.
У гэтым керавану практычнаю праця перакладзець парадокс з сыр'ём да рабочай системы для: «Як я структурую агентаў AI для прыметнай вырабоцтва з FastAPI, LangGraph і чыстай архітектуры». Акцэнт ставяцца на практычныя крокі, чысткія пераконтаванні і код, які можна проста дадзець у репазітарый без неабяснення меты. Для адгледзення, перш чым зменяць код, неабходна визначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыёныя працавікі должны магчымае перадзець крок з вядомай точкі контролю без неабяснення схованага стану. Конфігурацыю трэба залічыць пазначкай ад коду прыемленае. Файлы сераўіса, храненні секрэтных дадзенаў і флагі функцияў должны знаходзіцца ў аднам месцы, якое працавікі можу аудытуваты без чытання всей структуры.
@router.post("/suppliers")
async def create_supplier(request: SupplierRequest):
policies = opensearch.search(
index="supplier-policies",
query=request.description,
)
response = bedrock.converse(
modelId=MODEL_ID,
messages=build_messages(request, policies),
)
supplier = Supplier(
name=request.name,
tax_id=request.tax_id,
)
db.add(supplier)
db.commit()
sqs.send_message(
QueueUrl=SUPPLIER_QUEUE,
MessageBody=serialize(supplier),
)
return {"status": "created"}
FastAPI — это інтэрфейс, а не сама прыемленае
Колькі FastAPI ёсць толькі інтэрфейс, а не сама прыемліка, перш чым зменяць код, неабходна ясная працэвыкладка вхідных дадзеных, адпаведнага власніка крока і крэтарыяў завершэння. Аперацыйныя працавікі павінны магчымае перзапускаць крок з вядомай точкі контролю, не прабуючы спадарацца пра схованы стан. Неабходна адночасная документацыя як стандартнага, так і альтернатыўнага падхоўду. Практыка перапрыбуткі, людзкія контрольны пункты і обработка некоректных паведамленняў ёсць часткай самага продукту, а не елементамі пазнейшай дапрацоўкі. Перад масовым запрашэнням дадзеных неабходна выкарыстоўваць обмежэнняі і індэксы. Абеспека унікальнасці за дапамою бізнес-клучоў ператварае пазнейшыя з’еднання дадзеных у прагнозаваныя операцыі адправкі/замены, утрымліваючы такім чынам падазроўныя дуплікаты.
@router.post("/suppliers")
async def create_supplier(
request: CreateSupplierRequest,
use_case: CreateSupplierUseCase = Depends(
get_create_supplier_use_case
),
):
command = CreateSupplierCommand(
name=request.name,
tax_id=request.tax_id,
country=request.country,
)
result = await use_case.execute(command)
return CreateSupplierResponse.from_result(result)
HTTP Request
↓
FastAPI
↓
Application
↓
Domain
↓
Ports
↓
Adapters
Прыемліка вярбуецца з можнасцямі, а не з тэхналогіямі
Калі прыкладанне взаімаеся з можлівасцямі, а не з тэхналогіямі, перш чым зменшваць код, неабходна адзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыіям павінна быць можлівасць перзапускаць крок з вядомай точкі контролю, не спрабоўваючы з’ясаваць захаваны стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына нехарактернага рэзультата павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Перш чым адбываецца масовая загрузка, неабходна выкорыстоўваць обмежэнняі і індэксы. Унікальнасць бізнес-ключоў дапамагае перетвараць пазнейшыя з’еднання на прывідныя дзеянні, а не на ситуацыю з дуплікатамі.
class CreateSupplierUseCase:
def __init__(
self,
repository: SupplierRepository,
policy_service: SupplierPolicyService,
event_publisher: EventPublisher,
):
self.repository = repository
self.policy_service = policy_service
self.event_publisher = event_publisher
async def execute(
self,
command: CreateSupplierCommand,
) -> Supplier:
existing = await self.repository.find_by_tax_id(
command.tax_id
)
if existing:
raise SupplierAlreadyExists(command.tax_id)
policy = await self.policy_service.evaluate(
country=command.country
)
supplier = Supplier.create(
name=command.name,
tax_id=command.tax_id,
country=command.country,
requires_approval=policy.requires_approval,
)
await self.repository.add(supplier)
await self.event_publisher.publish(
SupplierCreated(supplier.id)
)
return supplier
Порты ствараюць межу
Для портаваў стварыце межу, задайце вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры перамены коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю без адгадвання захаванага стану. Спрэчыце гэты этап як кантракт межа вхіднымі данымі і перакананымі выходнымі даннымі. Дайце назвы артыфактам, задайце перакананні пра успех і адмовіцеся ад тых падчасовых завершэнняў, калі няма чыткай інформаціі. Ўжывайце обмежэння і індэксы пры масовай абрабоце. Яедынственнасць у бізнес-клучах ператварае пазнейшыя з’еднання ў прывідныя дадзеныя, а не ў ситуацыю дуплікацый. Для портаваў стварыце межу, задайце вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры перамены коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю без адгадвання захаванага стану. Зберагачыце настройкі праза код аплікацыі. Файлы сераў, хранільнікі секрэтных дадзеных і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжнага чытання всіх дадзеных.
ph.
from typing import Protocol
class SupplierRepository(Protocol):
async def find_by_tax_id(
self,
tax_id: str,
) -> Supplier | None:
...
async def add(
self,
supplier: Supplier,
) -> None:
...
class PolicyRetriever(Protocol):
async def retrieve(
self,
query: str,
) -> list[PolicyDocument]:
...
class LLMProvider(Protocol):
async def reason(
self,
context: AgentContext,
) -> AgentDecision:
...
class EventPublisher(Protocol):
async def publish(
self,
event: DomainEvent,
) -> None:
...
SupplierRepository
PolicyRetriever
LLMProvider
EventPublisher
PostgreSQL
Amazon OpenSearch
Amazon Bedrock
AWS SQS
Дзе належы Amazon Bedrock
Для падтрымкі «Дзе належы Amazon Bedrock» неабяжна прадзефінаваць вхідныя даны, абоўтчыка крока і крэтынія выходу пры змены коду. Аператары должны магчымае перзапускаць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вяснавання проблем. Перапрыбуткі, людзкія перакрыцця і обробка некоректных паведамленняў є часткай продукту, а не яго пазнейшай дапрацоўкі. Пасля першага пакета неабяжна адзірнуць прыкладны район. Засобы типу Cypher працююць дагэнь эфектываў для выявлення змян у атрыбутах і ўтраты власнасцей, чым тэсты на всю дыялогавую лінію.
class BedrockLLMProvider(LLMProvider):
def __init__(self, client, model_id: str):
self.client = client
self.model_id = model_id
async def reason(
self,
context: AgentContext,
) -> AgentDecision:
response = self.client.converse(
modelId=self.model_id,
messages=build_messages(context),
)
return map_bedrock_response(response)
Application
↓
LLMProvider
↑
BedrockLLMProvider
Дзе належы RAG
Ёнколі трэба вялічы, дзе мае быць RAG, перш чым зменіць код, неабходна ўзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыі должны магчымае перадзеяць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест абмежлівых скрыптав. Калі крок не выйшаў, прычына нехасабності павінна вказываць на адзіну адпаведальнасць, а не на заплутаны ланцужок задач. Пасля першага пакета дадзеных трэба перагледзець прыкладны артыкул. Засобы типу Cypher дапамагаюць выявіць змены ў атрыбутах і відсутныя характерыстыкі дарожэй, чым тесты чату ад пачатку да канца.
FastAPI
↓
OpenSearch
↓
LLM
class OpenSearchPolicyRetriever(PolicyRetriever):
def __init__(
self,
opensearch_client,
embedding_provider,
):
self.client = opensearch_client
self.embedding_provider = embedding_provider
async def retrieve(
self,
query: str,
) -> list[PolicyDocument]:
vector = await self.embedding_provider.embed(query)
results = self.client.search(
index="supplier-policies",
body=build_vector_query(vector),
)
return map_documents(results)
RAG дае контэкст. Ён не прыймае рашэння.
Для RAG даець контэкст. Ён не прыймае рашынку. Перад змянайом коду неабходна ясная дэфініцыя вхідных дадзеных, адміністратара крока і крэтэрыяў завершэння. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Спрыяйце цэй стадзіі як кантракту межа вхіднымі дадзенымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаць крэтэрыяў успеху і не падтрымайце безсловеснае частковае завершэння. Апрацавайце прыкладны набор дадзеных пасля першай партіі. Заставні тэсты лепей выяўляюць змены ў меткіх дадзеных і відсутнае свайності, чым тэсты чату з початку до канца. Для RAG даець контэкст. Ён не прыймае рашынку. Перад змянайом коду неабходна ясная дэфініцыя вхідных дадзеных, адміністратара крока і крэтэрыяў завершэння. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Конфігурацыю трэба зберагаць паза кодам прыкладнення. Файлы сяродавішча, хранілішча секрэтных дадзеных і флагі функций должны знаходзіцца ў аднам месцы для аператараў.
Можна аудытаваць, не чытаючы весь граф.RAG
↓
LLM
↓
"Looks fine"
↓
Create Supplier
RAG
↓
Relevant Context
↓
Agent Reasoning
↓
Application
↓
Domain Rules
↓
Decision
Дзе мае знаходзіцца LangGraph
Щодо таго, дзе мае знаходзіцца LangGraph, неабяжна пазначыць вхідныя даны, абоўязкі виконавца крока і критэрыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчыма ўвайсці крок з вядомай точкі контролю, не спрабоўваючы здогадвацца пра схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкі контроль і обработка некоректных паведамленняў є частью продукту, а не чымсь, што дадаецца пазней. Ствараюць моделі вузлаў і зв’язкаў для запитанняў, якія вы будете ставіць, а не для кожнага іменніка ў дакументе. Рэдкія, типаваныя ребры кращыя за ўжоўтучныя, незрозумелы графы.
Understand Request
↓
Retrieve Policies
↓
Evaluate Information
↓
Need More Data?
↙ ↘
Yes No
↓ ↓
Ask User Continue
↓
Approval Required?
↙ ↘
Yes No
↓ ↓
Human Approval Continue
↘ ↙
Request Action
graph = StateGraph(AgentState)
graph.add_node(
"understand_intent",
understand_intent,
)
graph.add_node(
"retrieve_policies",
retrieve_policies,
)
graph.add_node(
"evaluate",
evaluate_request,
)
graph.add_node(
"human_approval",
request_human_approval,
)
graph.add_node(
"request_action",
request_application_action,
)
graph.add_edge(
"understand_intent",
"retrieve_policies",
)
graph.add_edge(
"retrieve_policies",
"evaluate",
)
graph.add_conditional_edges(
"evaluate",
determine_next_step,
{
"approval": "human_approval",
"execute": "request_action",
},
)
LangGraph не должен стаць новым монолітом
Ёнколі LangGraph не павярэцца новым моналітам, перад зменой коду неабходна ўзначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння. Аперацыі должны магчымае перадзягаць крок з вядомай точкі контролю, не спрабоўваючы з’ясаваць захаваны стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшаў, прычына нехасабності павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Ствараюце вузлы і зв’язкі для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакументе. Рэдкія, типаваныя ребры кращыя за ўжоўткнутыя, незрозумелыя графы.
def evaluate_node(state):
if state.amount > 100_000:
state.requires_approval = True
if state.country == "BR":
...
if state.supplier_type == "CRITICAL":
...
decision = supplier_policy.evaluate(
supplier=supplier,
context=context,
)
LangGraph → orchestrates
Domain → decides
Дзе падходзіць MCP
Ёнколі MCP падходзіць, перш чым зменяць код, неабяжна пазначыць вхідныя даны, адпаведальнага за крок і критэрыі завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце цэму этапу як кантракту межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, пазначыце критэрыі успеху і адмовіцеся ад беззвучнага частковага завершэння. Стварыце моделі вузлаў і ўзаінтэресаванняў для запытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, типаваныя рэшткі кращыя за ўжоўтучаныя, загадковыя графы. Ёнколі MCP падходзіць, перш чым зменяць код, неабяжна пазначыць вхідныя даны, адпаведальнага за крок і критэрыі завершэння. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Зберагачыце настройкі параду ўнутры коду прыемленае. Файлы сераў, хранільнікі секрэтных дадзеных і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць, не чытаяўшы весь граф.
LLM
↓
PostgreSQL
LLM
↓
SAP
Agent
↓
MCP Tool
↓
Application API
↓
Use Case
↓
Domain
↓
Infrastructure
create_supplier
execute_sql
PostgreSQL таксама ўжо адаптар
Для PostgreSQL таксама ўжо адаптар неабходна пазначыць вхідныя даны, адпаведальнага за крок і критэрыя завершэння пры зміне коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю без неабясненняя схованага стану. Неабходна адначасна документаванне шляху успеху і шляху вярнення. Перапрыбуткі, людзкіе контралі і обработка некоректных паведамленняў є часткай продукту, а не наступным этапам дапрацоўкі. Ўжо пад час масовага запрацоўкі даных трэба выкарыстоваць обмежэння і індэксы. Унікальнасць бізнес-клучоў ператварае пазнейшыя з’еднання на прывідныя аператыўныя дзеяння заместа стварэння дуплікатаў.
class SupplierRepository(Protocol):
async def add(
self,
supplier: Supplier,
) -> None:
...
class PostgresSupplierRepository(
SupplierRepository
):
def __init__(self, session):
self.session = session
async def add(
self,
supplier: Supplier,
) -> None:
entity = SupplierModel.from_domain(
supplier
)
self.session.add(entity)
FastAPI → doesn't know PostgreSQL exists
Application → doesn't know PostgreSQL existsDomain → doesn't know PostgreSQL existsInfrastructure → does
SAP должна знаходзіцца за іншай межой
Для SAP, які знаходзяцца за іншай межаючай структурой, неабяжна ўзначыць даннэ, адпаведальную за кожны крок і критэрыі завершэння працы перад змянай коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не падозрываючы прыхованы стан системы. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выконваецца, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаную структуру працы. Ўжывайце обмежэнняі і індэксы пры масовай загрузцы даных. Унікальнасць бізнес-клучоў дапамагае перетвараць пазнейшыя злучэння даных у працоўнае адчыненне/змяну, а не у ситуацію дуплікацый.
CreateSupplierUseCase
↓
Persist State
↓
SupplierCreated
↓
AWS SQS
↓
Integration Worker
↓
SAP
Стварэнне архітектуры
Для стварэння архітектуры неабяжна практычна визначыць інпуты, адміністратара крока та крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце гэтаму этапу як даговору межа інпутамі та перакананымы выходнымі даннымі. Дайце назвы артыфактам, визначыце крэтыры успеху та адмовіцеся ад бяспрэчнага частковага завершэння. Ўжывайце обмежэнні та індэксы пры масовай абрабоце. Унікальнасць у бізнес-клучах ператварае пазнейшыя з’еднання на прывідныя апдэты, а не на штормы дуплікатаў. Для стварэння архітектуры неабяжна практычна визначыць інпуты, адміністратара крока та крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Зберагачыце настройкі за межамі коду прыемлівання. Файлы сяродавішча, хранілішчы секрэтных дадзеных та флагі функций должны знаходзіцца ў аднам месцы, якое працавнікі можуць аудытаваць без дапамогі спецыяльных інструментаў.
Перакладзіце всю дыяграму.
USER
│
▼
FastAPI
│
▼
LangGraph
│
┌────────────┼────────────┐
│ │ │
▼ ▼ ▼
RAG LLM MCP
│ │ │
▼ ▼ │
OpenSearch Bedrock │
▼
Application
│
▼
Domain
│
┌─────────┴─────────┐
│ │
▼ ▼
PostgreSQL AWS SQS
│
▼
Worker
│
▼
SAP
Два светы
Для проекту «Два светы» неабяжна прадзефінаваць вхідныя даны, абяронца крока і крэтынія выходу пры перадзеўранні коду. Аператары должны магчымае перадзначыць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вяснавання проблем. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Празвярце прыкладны район пасля першай партіі. З’явы Cypher выкрываюць змены атрыбутаў і ўтрату власнасцей дышэўней, чым тесты чату з канца ў канец.
PROBABILISTICLLM
RAG
Natural Language
Intent Understanding
Agent Reasoning
Tool Selection
DETERMINISTIC
Authorization
Business Rules
Transactions
Persistence
Idempotency
Integration
Auditability
Практычны тэст для архітектуры
Для практычнага тэставання архітектуры неабяжна ўзначыць вхідныя даны, адпаведальнага за кожны крок і критэрыя завершэння пры зміне коду. Аперацыйныя працавнікі должны магчыма ўвайсці зноў у кожны крок, выкарыстоўваючы вядомы пункт контролю, без неабяжнасці здогадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Пасля першай партіі неабяжна перагледзець прыкладны раён. Засобы типу Cypher дазволяюць выявіць змены ў атрыбутах і ўтрату характерыстыкаў дышэўна, чым тэсты чату ад пачатку да канца.
async def test_supplier_requires_approval():
repository = FakeSupplierRepository()
policies = FakePolicyService(
requires_approval=True
)
events = FakeEventPublisher()
use_case = CreateSupplierUseCase(
repository=repository,
policy_service=policies,
event_publisher=events,
)
supplier = await use_case.execute(
CreateSupplierCommand(
name="ACME",
tax_id="123",
country="BR",
)
)
assert supplier.requires_approval is True
Зміна модэлю должна быць нудной
Каб пры змяне модэлю все было нудна, прай змяне коду неабходнае вазначыць інпуты, адпаведальнага за крок і крэтыры завершэння. Аперацыяныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце гэтаму этапу як кантракту межа інпутамі та перакананымы выходнымі даннымі. Дайце назвы артыфактам, вазначыце критэрыі успеху та адмовіцеся ад бяспрэчнага частковага завершэння. Працавайце з прыкладамі пасля першага пакета. Зонды Cypher выяўляюць зміны атрыбутаў та ўтрату характерыстыкаў дарожлейва, чым тэсты на весь працэс чату. Каб пры змяне модэлю все было нудна, прай змяне коду неабходнае вазначыць інпуты, адпаведальнага за крок і крэтыры завершэння. Аперацыяныя працавнікі должны магчымае перайсці на гэты крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Храніце настройкі праза код аплікацыі. Файлы сяродавішча, хранальнікі секрэтных дадзеных та флагі функций должны знаходзіцца ў аднам месцы, якое працавнікі можуць пераглядаць без неабходнасці чытання.
Усю графіку.
LLMProvider
▲
│
┌─────────┴─────────┐
│ │
BedrockProvider AnotherProvider
FastAPI
Application
Domain
Business Rules
Чыстая архітектура — гэта не структура папак
У разе, калі чыстая архітектура — гэта не структура папак, перад змянайом код неабходна ўзначыць вхідныя даны, абавесцявальніка крока і критэрыя завершэння. Аперацыі должны магчымае перадзягнуць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабходна аддзекаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкія контралі і обработка некоректных паведамленняў ёсць частью продукту, а не пасляднім дапрацоўкам. Моделюйце вузлы і зв’язкі для тых пытанняў, якія вы будете ставіць, а не для кожнага іменніка ў дасведчэнні. Разрозненыя, типаваныя ребры кращыя за ўжоўтучныя, загадковыя графікі.
src/
├── api/
├── application/
├── domain/
├── agents/
├── ports/
└── infrastructure/
Штучны інтэлект робіць гэтыя межы ўсё бол важлівымі
Колькі хутчэй штучны інтелект робіць гэтыя межы важлівейшымі, трэба практычна перад зменайом коду адзначыць вхідныя данні, адпаведальную сторону і критэрыя завершэння. Аперацыіям павінна быць можлівасць перзапускаць крок з вядомага пункта контролю, не спрабоўваючы здагадвацца пра схованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшоў, прычына нехацкага рэзультата павінна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцужок задач. Ствараюце вузлы і зв’язкі для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакументе. Рэдкія, типаваныя зв’язкі кращыя за ўжо заплутаныя графы.
Архітектура ў адной фразе
Для «Архітектуры ў адной фразе» неабходна прадзефінаваць вхідныя даны, адпаведальную за кожны крок особу і крэтарыі для завершэння працы перад змянайом коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрыяйце цэму этапу як даговору межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, прадзефінаваць крэтыяры успеху і адмовіцеся ад беззвучнага частковага завершэння. Стварайце моделі вузлаў і ўзаінтэресаванняў для тых пытанняў, якія вы хочаце задаць, а не для кожнага іменніка ў дакумэнце. Разрозненыя, типаваныя рэшткі кращыя за ўжоўтучаныя, загадковыя графы. Для «Архітектуры ў адной фразе» неабходна прадзефінаваць вхідныя даны, адпаведальную за кожны крок особу і крэтарыі для завершэння працы перад змянайом коду. Аператары должны магчымаць перзапуск крока з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Зберагачыце настройкі параду коду прыкладнення. Файлы сераў, хранільнікі секрэтных дадзеных і флагі функций должны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабходнасці чытання.
цэлага графіка.Заключныя заўважэнні
У частцы «Заключныя заўважэнні» неабходна праказаць вхідныя даны, абавесця крока і критэрыі завершэння пры перадзеяванні коду. Аператары должны магчымае перадзеяваць крок з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Неабходна задокументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкіе перакрыцця і обработка некоректных паведамленняў є часткай продукту, а не чымсь, што дадаецца пазней. Ўжывайце обмежэнні і індэксы пры масовай абрабоце. Унікальнасць па бізнес-клучох прыводзіць да таго, што пазнейшыя з’еднанні стаюць прыведамымі апдэйтамі, а не до ситуацый з дуплікатамі.
Prompt
↓
LLM
↓
Tool
↓
Database