{"article_id":"2735","schema_version":2,"source_content_hash":"90f72d30150eb4883803c9efe4d4c3a2c8e16ad471e774e334e42c950387464d","computed_at":"2026-07-12T12:25:44Z","payload":{"topic":{"subtopic":"Использование Mermaid-диаграмм для контроля решений ИИ","canonical":"Проблема додумывания в ИИ-агентах и визуализация с помощью Mermaid","confidence":0.9,"related_topics":["доверие ИИ","додумывание","Mermaid диаграммы","проверка кода","агенты ИИ"]},"entities":[{"role":"primary","type":"technology","canonical_name":"ИИ-агенты"},{"role":"primary","type":"technology","canonical_name":"Mermaid"},{"role":"secondary","type":"organization","canonical_name":"Visa Research"},{"role":"secondary","type":"technology","canonical_name":"LLM Coding Agents"},{"role":"secondary","type":"technology","canonical_name":"AgentVision"}],"passages":[{"kind":"definition","text":"ИИ-агенты — это модели, которые берут неполное описание и выдают наиболее вероятное завершение, додумывая невысказанные требования."},{"kind":"definition","text":"Mermaid — текстовый язык диаграмм, поддерживаемый GitHub, Claude, VS Code, Notion."},{"kind":"comparison","text":"Проблема не в прямых ошибках ИИ, а в невысказанных компонентах, которые агент добавляет как 'наиболее вероятное'."},{"kind":"troubleshooting","text":"Если поленился нарисовать диаграмму — готовься к ночи исправлений."},{"kind":"how_to","text":"Работа с агентом: дал задачу — попросил визуализировать — проверил за 30 секунд — скорректировал — пошёл дальше."},{"kind":"answer","text":"Sequence diagram — это рентгеновский снимок логики, который показывает, кто кому и что отправляет."},{"kind":"comparison","text":"Из 26 типов диаграмм Mermaid агенты сами применяют лишь 2-3: flowchart и sequenceDiagram."},{"kind":"how_to","text":"Обязательный набор: flowchart, sequence, class, ER, state, mindmap."},{"kind":"troubleshooting","text":"Бесполезный балласт: Pie chart, Quadrant chart, Timeline, Kanban, Packet diagram."},{"kind":"answer","text":"Исследование Visa Research 'Illuminating LLM Coding Agents' показало, что ML-инженеры тратят много времени на понимание действий агента без визуализации."}],"faq_items":[{"answer":"Sequence diagram, так как она показывает сценарий взаимодействия и ловит самые опасные додумывания.","question":"Какую диаграмму Mermaid нужно просить у агента первой?","confidence":0.9},{"answer":"ИИ генерирует с чудовищной скоростью; читать самому — всё равно что искать иголку в стоге сена, который растёт на глазах.","question":"Почему бесполезно читать сгенерированные ИИ спеки?","confidence":0.8},{"answer":"Flowchart, sequence, class, ER, state, mindmap.","question":"Какие диаграммы Mermaid обязательны для проверки?","confidence":0.9}],"seo_title":"ИИ додумывает за вас: почему это опасно и как Mermaid-диаграммы спасают проект","ai_summary":"ИИ-агенты додумывают невысказанные требования, что может привести к ошибкам в коде. Статья предлагает использовать визуализацию с помощью Mermaid-диаграмм (sequence, flowchart, class, ER, state, mindmap) для быстрой проверки решений. Исследование Visa Research подтверждает, что без визуализации инженеры тратят много времени на понимание действий агента.","meaning_text":"Для безопасной работы с ИИ-агентами необходимо внедрить визуальную проверку каждого шага с помощью диаграмм, чтобы выявить неверные предположения агента до того, как они приведут к критическим ошибкам.","subject_text":"Статья о проблеме додумывания ИИ-агентов при генерации кода и решений, а также о методе её решения с помощью визуализации в виде Mermaid-диаграмм для быстрой верификации.","key_takeaways":["ИИ-агенты склонны додумывать невысказанные требования, что ведет к скрытым ошибкам.","Визуализация с помощью Mermaid-диаграмм позволяет за 5 секунд проверить логику агента.","Sequence diagram — первая диаграмма для выявления лишних шагов и сервисов.","Из 26 типов диаграмм Mermaid реально нужны 5-6: flowchart, sequence, class, ER, state, mindmap.","Работа с агентом должна включать короткий цикл: дал задачу -\u003e визуализация -\u003e проверка -\u003e корректировка.","Современные инструменты (AgentVision) добавляют агентам способность визуально проверять результат."],"author_profile":{"bio":"Эксперт в области автомобилестроения и ИИ","content_centroid":[-0.028773833,-0.015069968,-0.061371043,0.04005821,-0.011197266,0.02336634,-0.029763887,-0.010981481,0.010849467,0.01808585,0.0016126008,0.006055433,-0.019634148,-0.02263461,-0.018187145,-0.055488743,-0.0005771737,-0.0019370823,-0.0037805315,-0.025527142,0.021776695,0.017129162,-0.027584536,-0.009551729,0.01689916,-0.030765397,-0.012934589,-0.0153173115,0.035684176,0.018796857,0.015641492,0.0070234425,0.015571488,-0.037370443,-0.024060866,0.023078846,-0.032876235,-0.042221293,0.002177828,0.007429269,-0.00232598,0.029097563,0.0010350164,-0.06483389,-0.044625495,-0.050443925,0.0039461628,-0.021772603,-0.031628743,-0.0027478214,0.0014299917,0.047555547,-0.021963721,-0.019929407,0.0006129435,0.0012624839,-0.018627966,-0.010717293,-0.02819069,0.015639681,-0.042460263,0.0029645853,-0.051478356,0.048864596,0.037323043,0.06527113,-0.034281973,-0.023084946,0.00084575266,-0.033348724,-0.002656834,-0.06651563,-0.01901419,-0.009135774,0.026289396,0.036688115,0.016413137,0.007553175,0.03713587,-0.03398341,0.0067479024,0.020917086,-0.041113663,-0.05671825,-0.049859583,0.02726909,-0.039771505,-0.015512924,-0.029076802,-0.014923627,-0.010972338,0.021308385,0.0131760845,-0.0027826005,0.004201355,0.020319765,0.007946409,0.011331435,-0.031252883,0.016662175,0.012761181,0.029162914,-0.028401513,0.03756858,0.016315198,-0.020164171,-0.00824378,0.0040093223,-0.020858096,0.007515558,-0.0060104127,-0.067034565,-0.033831067,-0.008227139,0.059820507,-0.018922048,0.0131345205,-0.0062024267,0.009131318,-0.009241289,-0.00549656,-0.022315955,0.021423316,0.018182117,-0.056050282,-0.04865783,-0.020291343,0.033817276,-0.045360476,0.006833282,0.0049404684,0.029089933,-0.019062258,-0.028929863,-0.047575057,0.012858109,0.052687846,0.027383517,-0.0066038882,0.08895803,0.010070385,-0.0344759,-0.034972146,0.077542774,0.02161342,0.030733647,0.020241298,0.005523055,-0.04941256,-0.011229013,-0.0008281992,0.0027445443,-0.05585616,-0.014448974,0.03854705,-0.012049405,0.0015576868,-0.010071698,0.0037774192,0.029462464,-0.006583452,0.009901391,-0.044222623,-0.037238047,-0.0023431194,-0.0061239786,0.06305798,0.026182968,-0.07020267,-0.005946118,-0.020379765,-0.017692674,0.0012497157,0.016556736,-0.01469067,-0.023076497,-0.009640426,0.046109047,0.07274747,-0.020961922,-0.033308096,0.03165856,-0.025714232,-0.044772062,0.01103202,0.074611634,0.044218227,-0.02135891,-0.016396195,0.03614765,0.014805545,0.023728529,-0.07140347,-0.013769099,-0.009965788,0.008257718,-0.022069419,-0.053337812,0.006263373,-0.007750103,-0.0500588,0.013782343,0.0113885915,0.004757395,-0.0025847405,-0.009918763,0.05522751,0.010161183,0.008773444,-0.011435451,-0.0025943127,-0.013157274,-0.03450642,-0.026799649,0.027966058,-0.051517103,-0.01929574,-0.0704409,0.036876883,-0.018054705,-0.038081866,0.016442457,-0.0365582,-0.0047231726,-0.036273,-0.021550015,-0.04985947,-0.035884682,0.013695932,-0.015435381,-0.014854164,-0.018961178,0.0030398583,-0.0052870153,-0.026975915,0.02167347,-0.009253269,0.010662378,-0.026883654,-0.0022293688,0.07055359,-0.023648646,-0.03030357,0.031086262,0.05518496,-0.020179037,0.017213896,-0.00075758446,-0.019699108,-0.060425192,0.0065594222,-0.009709592,0.012036306,0.014961668,-0.005107703,0.01292428,0.003396316,0.00202203,-0.0022529662,-0.015243711,-0.043132637,-0.039735664,0.02971857,0.039706066,0.018501867,0.03666501,-0.018761322,-0.02804381,0.0029851506,0.031036483,0.01751317,-0.010045894,-0.043446913,0.009356802,0.0429209,0.030838747,-0.049176604,-0.0050777504,0.0065589845,0.014200113,0.026393672,0.0350969,0.044032343,0.025351249,0.006084548,0.028907811,-0.010585488,-0.029957842,0.030012477,0.00029355934,-0.027067605,-0.018561868,-0.002894677,-0.0077840565,0.005568364,-0.032496605,-0.056438968,0.038561344,0.030969173,0.048777815,-0.013361434,-0.039377782,0.019859968,-0.02997542,0.022279777,0.026305288,-0.033337172,0.031807534,-0.0029923618,0.03326669,0.045538444,0.02703496,0.035055615,-0.022017103,0.029546468,-0.037164968,0.007392362,0.008079357,0.034422323,-0.056726195,0.010504751,-0.04153325,0.015606273,0.025355274,-0.041401654,0.03785502,-0.048515275,-0.051078834,0.022656543,0.015424592,-0.037911706,0.0072173555,0.007715556,-0.016909283,0.008487504,-0.0304001,0.01884862,0.018527301,-0.015512052,0.0010882408,-0.005108704,0.081691585,0.01714371,-0.02438767,0.055033997,0.004183073,-0.013520893,0.029029952,-0.019243486,-0.057530526,-0.00044345084,-0.005834416,-0.06220452,-0.066574834,0.032429334,-0.040102035,0.002842183,-0.021485437,-0.020702556,0.016673869,-0.034385238,0.0387665,-0.015002073,-0.084427595,-0.03069573,0.020692809,-0.03404229,0.006274638,0.065460324,-0.010423334,0.0050618383,0.042778283,-0.03982924,0.014771861,-0.025759403,-0.030074848,-0.00167284,-0.010170149,0.028550154,0.032485876,-0.01934192,0.0022801505,-0.005971321,-0.052922975,-0.05641684,-0.019056534,-0.036378745,-0.035647444,-0.016131353,-0.002853985,-0.018996486,-0.06845535,0.025752835,0.030636322,0.0070047583,0.0034323856,0.010509958,0.031397954,0.006072561,-0.009364396,0.024858674,-0.032941718,-0.034946162,0.020541152,0.04493319,0.010175215,0.027385417,-0.044524312,0.015592992,-0.022812398,-0.0044551464,-0.028534135,-0.033158883,0.0049089156,0.013822302,0.02328179,-0.017997552,0.00006266807,0.00060923456,-0.0105159655,-0.08320445,-0.010824665,0.03367186,0.03641781,-0.009244804,-0.056905806,-0.06567249,-0.0032540453,0.050822776,-0.0026718844,-0.013573883,-0.00082782866,0.010869408,0.012666071,-0.009394763,-0.012848221,0.02534288,-0.016166732,0.0137789715,0.014010503,0.07371018,0.010993226,-0.014396525,-0.038899507,-0.0375873,0.011608882,-0.035839345,-0.04505431,0.060300015,0.06837858,-0.028225455,0.06469254,0.02511285,0.06026797,0.035793733,-0.008644494,0.013210321,-0.04569859,-0.038174182,-0.040950034,-0.05689715,0.016215801,-0.00043705443,0.04242798,0.07478806,-0.009493605,-0.016423827,-0.013039218,0.04351246,-0.02885467,0.018614022,-0.012232559,0.027298111,0.021186344,-0.012669672,0.006772427,0.03675769,0.023032123,-0.02310816,-0.014019452,0.0021986417,-0.015982032,-0.038059384,-0.07315473,-0.024284778,0.04324497,-0.0020511989,0.057593625,-0.023657985,-0.009107638,-0.035467256,0.018817144,0.01953885,-0.03437464,0.04688905,0.0013076839,-0.0031652069,-0.016878247,-0.005947409,0.031184971,0.028577596,-0.034087926,0.00279874,0.007151565,-0.009860916,-0.04519108,0.011043026,0.004431966,0.018223748,0.019793626,-0.024603156,-0.0077898237,0.0043607163,-0.023454659,-0.0137245245,-0.028390983,0.020693457,-0.027223147,0.024284046,-0.013827814,-0.027626885,-0.0032659918,-0.061687026,-0.07763516,0.039409455,-0.0011125213,0.03648418,0.042299982,-0.026583787,-0.051336024,-0.009906596,-0.00026245255,-0.0493749,-0.0009757616,-0.016789861,0.046872243,-0.022485824,0.00934118,0.0458375,0.03985227,0.0023540051,-0.008018938,0.036592983,0.015139307,0.013203107,-0.029556012,-0.00010769319,0.056576125,0.023534443,-0.02906296,-0.014874269,-0.023452332,-0.016272156,-0.021689424,0.022401646,0.0031534708,0.032018643,0.027645342,-0.0037968736,0.0053887907,0.00496613,-0.019085642,0.003433439,-0.027002383,0.035753753,-0.047776785,0.042853042,0.030316792,0.009847025,-0.0126988245,-0.026717423,-0.046821408,-0.025717922,0.025242485,-0.010252362,-0.05733266,0.01971068,0.038031053,-0.027732087,-0.03780204,0.004084452,-0.011319117,0.0029982722,-0.0009911075,-0.017708315,-0.021815762,-0.009323881,-0.060826946,0.018634042,-0.020540668,-0.029828567,0.020425975,-0.00072582415,0.026298372,-0.00047049974,0.05421775,-0.041296814,0.011127421,0.0107965395,-0.012540586,-0.0289067,0.011313825,-0.025570828,0.02364275,0.027092503,0.0064775324,0.05724281,-0.021517958,-0.059654396,0.0065757222,-0.009429998,0.044711217,0.013971419,0.015456773,0.03775574,0.010876027,-0.051947605,0.0033748578,-0.033133466,-0.022273624,-0.025885522,-0.043974925,-0.0026540016,-0.022326164,-0.08796002,-0.05693185,0.0024073184,0.012017033,0.010590108,0.04718245,0.0067116544,-0.008845487,-0.029673258,-0.014626547,-0.025624983,-0.067787655,-0.027897213,0.03344702,0.03247543,0.03532666,0.0042979214,0.03871866,-0.028365772,-0.0031443182,0.031697974,-0.028492283,-0.08195028,-0.038520277,-0.007353161,-0.011465983,0.025948478,-0.024526928,-0.028079325,-0.026734242,0.040583093,0.017275846,0.023348454,-0.02584964,-0.055352278,0.018045431,0.044681396,0.010986238,0.031509437,-0.07671373,-0.02999261,-0.05893412,0.033252105,-0.049378898,0.026524585,0.014464111,0.009847067,-0.010966078,-0.027202496,0.0027164456,-0.06777688,-0.036950078,0.025160456,0.046688233,-0.034962732,-0.014956938,-0.04040237,0.046715457,-0.022246249,-0.022246601,0.035917383,0.0011714381,0.01527757,0.05928285,0.029285239,0.021588802,-0.008810963,0.01943494,-0.052332114,-0.038676523,-0.0472365,-0.048413888,0.049173567,-0.05081005,-0.032253284,0.036383152,-0.021527672,-0.0048266053,0.0051438813,0.01817016,0.00716626,-0.023633873,-0.003563934,-0.0019764777,-0.005003578,0.010125292,-0.043736033,-0.03601277,0.030733712,0.007150704,-0.016522551,0.033518046,-0.004719347,-0.012363849,-0.03951805,0.041322727,-0.03966425,0.033857044,-0.010471818,0.004334255,0.015888182,0.019984918,-0.0039279135,-0.021818023,-0.0015441572,-0.035577778,-0.00011173144,0.033027582,0.031677514,0.016712315,0.010120977,0.033422597,-0.03811187,-0.043880526,0.042800963,0.036615796,-0.016351921,-0.010713773,0.035618477,0.02874182,-0.030548552,-0.019694949,-0.019467566,0.025770012,0.01489142,0.051330917,0.04115273,-0.010359131,0.017215902,-0.0020915698,-0.03558021,0.060661554,-0.031705175,0.0023495443,-0.06110721,0.025842022,0.02179733,-0.0069634533,-0.0086259125,0.06867922,-0.017770065,-0.03121144,0.02885305,-0.047224287,-0.013236848,-0.039748516,-0.013363388,0.042849712,0.029897517,0.009764662,-0.011594399,0.027068034,-0.025689231,0.031754453,0.042312916,0.025016032,0.008392167,0.030794227,0.071018614,-0.022753488,0.020559646,-0.0038852678,-0.054613277,0.08289225,0.026020871,0.0010298368,0.04498723,-0.06795853,-0.021549406,-0.027417654,0.02724028,-0.07583997,-0.0073118415,0.03887601,0.0067920405,0.034807395,0.00012291453,-0.018681282,-0.020176064,0.02340992,-0.03628501,0.025180751,-0.023495859,-0.03146605,-0.014428496,0.047597654,-0.0025517158,-0.039820127,-0.03654561,-0.012824826,-0.057822526,0.05218785,-0.05045224,0.021139279,-0.013326853,-0.01627527,-0.029791199,-0.03194334,-0.01603406,0.05045271,-0.0028980633,-0.004827853,0.05709679,-0.054501165,0.009284708,0.023362428,0.012417706,0.0038497373,0.013444196,0.042684115,0.026787592,0.06219634,0.071235605,0.0056974175,-0.0243232,-0.010170336,-0.04410327,-0.042347692,0.05817896,-0.0029762518,-0.004302723,0.023033889,-0.032158725,0.003977667,0.034429412,-0.036819115,-0.026659733,-0.0160818,-0.032215312,0.015132204,-0.015035889,0.0034689307,-0.034284677,-0.059934054,0.04386266,-0.003548097,0.05347207,-0.010018366,-0.023441043,0.019013984,-0.07130953,0.021570688,0.037428346,-0.041501854,0.035483908,0.00340898,0.0512874,0.020307422,0.012577466,0.009853655,0.015916843,0.047310635,0.041630957,0.028810894,0.030312065,-0.08225124,0.0086765075,0.06294426,0.05393191,0.006019205,-0.05251831,0.039574377,0.023054805,-0.038574684,-0.045641612,-0.019139836,-0.03944972,-0.01375872,0.025751373,-0.065670036,-0.023003569,0.015508195,-0.021328637,-0.0030078492,-0.00030106612,-0.017895166,0.022466313,0.01747781,-0.03830303,-0.04750371,0.023964085,-0.0072894697,0.0076606493,-0.041536562,-0.043282796,0.023207523,0.023155095,-0.0186802,-0.0029702575,0.012090423,0.021065386,-0.023577673,0.015310268,0.03719873,0.015231077,-0.021420388,0.008433896,0.03627709,0.008631309,0.040668264,0.01864998,-0.021578925,0.019063562,0.009108465,0.03984077,-0.026313592,-0.010818604,0.01055251,0.043960605,-0.034632154,-0.010947339,0.01880596,0.011089981,0.033204038,-0.00032875445,-0.009634663,0.04373945,0.016246414,-0.026215047,0.038104646,-0.041129734,0.027587524,0.014459265,-0.040216606,0.053648815,-0.015334325,-0.020421129,0.028157223,0.020220518,-0.034874335,0.015694607,-0.012098268,-0.0036850318,-0.010589582,-0.010404916,-0.00043231685,0.014201933,0.018960679,-0.01694645,0.022222416,0.0050266176,-0.025698667,0.020074585,-0.023022728,0.021247812,0.04397893,-0.034857873,0.024016865,0.0784359,-0.0045737643,-0.034484763,-0.014647127,-0.006100076,0.021613583,-0.0351142,-0.026092967,0.012663653,0.008908993,-0.0061348774,0.016428268,0.028539348,-0.032177385,-0.019502062,-0.02415766,0.034104496,-0.013414941,-0.016455596,0.038598437,0.015943805,0.02873427,-0.010490224,0.0028870627,-0.0140174925,-0.0042084046,0.034742072,-0.027770258,-0.086817496,0.0073601366,0.059304975,-0.001452504,0.009053364,0.016652348,-0.021039182,0.03160903,0.06106045,0.018131215,0.010832764,0.0288394,-0.0092794085,0.02993505,0.00080135994,-0.022147818,-0.041588414,0.044725448,0.027168758,0.012854976,0.037772223,-0.044169612,-0.027898416,0.0077040032],"sampled_articles":25},"link_candidates":[{"phrase":"Illuminating LLM Coding Agents","relation":"research_paper"},{"phrase":"Mermaid","relation":"technology"},{"phrase":"AgentVision","relation":"tool"}],"seo_description":"ИИ-агенты додумывают невысказанные требования, что ведет к критическим ошибкам. Статья объясняет, как использовать Mermaid-диаграммы (sequence, flowchart, class, ER, state) для быстрой визуальной проверки решений, чтобы избежать багов и лишних компонентов. Приведены исследования Visa Research и личный опыт автора.","experience_labels":["explanation","practical_advice","new_perspective","opinion","investigation"],"overall_confidence":0.85}}