Галоўная / Артыкулы

Практычныя нататкі: ZQ Intelligence — аркестратар і агенты-спецыялісты для фінансаў

Практычны разбор тэмы «ZQ Intelligence: аркестратар і агенты-спецыялісты для фінансавага аналізу»: кантракты, праверкі і гатовыя фрагменты кода для каманд, якія ўкараняюць гэты падыход.

Выдавец: REACTAPP.TOP7 хв чытання1664 слоў

Крыніцы: ZQ Intelligence: Orchestrator-Specialist Agents for Financial Analysis in Snowflake

Існавайце гэта як перапрацоўаны варыянт ідэй з кнігі “ZQ Intelligence: Orchestrator-Specialist Agents for Financial Analysis in Snowflake”, адпрацаваны для аператараў: чыстыя этапы, аранжаваныя блакі коду і прыметкі з восстанавлення, якія застаюцца пасля перадачы заданняў. Этап “Агульныя відзнакі” найэфектывней працюе, калі яго розглядаць як мерыябельную паверхню. Запісаце адна ідэальная транскрыпцыю, адзін прыклад неудачы і прыметкі з вярнення да пачатковага стану прычаму расшырэння масштаба. Храніце настройкі праза код аплікацыі. Файлы сераўнавання, хранальнікі секрэтных дадзеных і флагі функцыйяў должны знаходзіцца ў аднам месцы, куда аператары можуць адбавіць аўдыт без неабходнасці чытання всей структуры.

ZQ Model as a Service: Як гэта задае рух інтэлігенцыі Snowflake

Для модэлю ZQ як этапы неабяжна прадзефінавань вхідных дадзеных, адпраўніка крока і крэтарыяў завершэння перад зменым коду. Аперацыяныя працавнікі павінны магчымае перзапускаць крок з вядомай точкі контролю, не прабуючы спадарожваць схованы стан. Неабяжна задокументаваць як шлях успеху, так і шлях вярнення да нормальнага стану. Перапрыбуткі, людзкія перакрыцці і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не чымсь, што дадаецца пазней. Калі наступны крок — гэта код або вызов інструмента, лепш выкарыстоўваць структураваныя выходныя даныя з перакананням схемы, чым вольныя тэкстовыя апісанні.

Чаму спецыялісты-агенты: логіка віробнай лініі

Для этапы «Сборка спецыялістаў з аналізу прычын» неабходна пазначыць вхідныя даны, адпаведальнага за крок і крэтыяры завершэння пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не прабуючы выявіць схованы стан. Валідзіце маленькія, тэставаныя елементы замест большых скрыптаў. Калі крок не выканаецца, прычына неудачы должна вказываць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Заставіце людзкую апраўдку на тых этапах, дзе відбываецца выдатак грошэй або зміняюцыся даны для працы сістэмы. Компіляцыйныя налашчэнні не ўзначаюць повнасці бізнес-процэса.

Архітэктура ў кароткаму відгледзе

У стадыі «Архітэктура за мгновеннае» неабяжна ўзначыць вхідныя даны, адпаведальнага за этап і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі павінны магчымае перазапускаць этап з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Спрацавляйце з гэтай стадыяй як з кантрактом межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Даўце назвы артыфактам, узначыць пераказы успеху і адмовіцеся ад тыхнай частковай рэалізацыі, якая не фіксуецца. Забезпечыце людскую апраўду для тых крокаў, якія выкалічваюць грошы або змянююць даны ў працэсе. Компіляцыйныя налашчанні не ўзначаюць павнае выпалення бізнес-функцый. У стадыі «Архітэктура за мгновеннае» неабяжна ўзначыць вхідныя даны, адпаведальнага за этап і крэтыры завершэння пры змяне коду. Аперацыйныя працавнікі павінны магчымае перазапускаць этап з вядомай точкі контролю, не спрабоўваючы здагадвацца пра схованы стан. Зберагачыце налашчанні параду ад коду прыкладнага програмнага забезпечэння. Файлы сераўіса, хранільнікі секрэтных даных і флагі функцыйяў павінны знаходзіцца ў аднам месцы, якое працавнікі можуць аўдытаваць, не чытаючы весь код.

Сцэна выкарыстання 1: Агент ZQ Macro

Калі працуеце над стадзіяй ZQ сцэны выкарыстання 1, спачатку запісайце умовы працы: неабяжлівыя даныя, сігнал успеху і тое, што выканаецца у разы ўзельнага нявыпалення. Такі чэк-ліст дапамагае заставаць пазнейшыя змены коду чыстымі. Документавайце як шлях успеху, так і шлях вярнення да нормы. Перапрыбуткі, людзкія контралі і обработка некорэктных паведамленняў ёсць часткай продукту, а не пазнейшым дапрацоўкам. Зробіце контрольную пазнаку пасля дорогіх крокаў. Сістэма вярнення не павінна знову ставіць плату за той самы вызов LLM, калі аператар перапрыбуе пазнейшы вузел.

- Retrieve evidence for a query
CALL TESTING.ZQ_CB_AGENT.ZQ_AGENT_RETRIEVE_EVIDENCE(
 OBJECT_CONSTRUCT('QUERY', 'inflation outlook', 'CENTRAL_BANK', 'federal_reserve_system', 'K', 25)
);
 - Run full analysis (retrieval + stance + uncertainty + forward-looking)
CALL TESTING.ZQ_CB_AGENT.ZQ_AGENT_RUN_FULL_ANALYSIS(
 OBJECT_CONSTRUCT('QUERY', 'unemployment', 'CENTRAL_BANK', 'federal_reserve_system', 'K', 25)
);

Сцэна выкарыстання 2: Агент ZQ Equity

Калі працюеце над стадзіяй Use Case 2 ZQ, спачатку запісайце умовы працы: неабяжлівыя даны, сігнал успеху і тое, што выходзіць пад частковыя неудачы. Такі спіс контролю дапамагае заліцвачыць пазнейшыя змены коду. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, неудача должна вказваць на адну адпаведную адпаведальнасць, а не на заплутаны ланцюг задач. Зробіце перапактаванне пасля дорогіх крокаў. Програма не должна зноў ставіць плату за той самы вызов LLM, калі аператар прабуе зноў выконаць пазнейшы элемент.

Аналіз на адной падставе доказаў: як ZQ гэта рэалізуе

Калі працуеце над стадзіяй «Аналіз на адказах доказаў, як ZQ», спачатку запісайце «контракт»: неабходныя вхідныя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс пераконтроўкаў дапамагае заліцвачыць пазнейшыя змены ў кодзе. Спрыймайце гэтую стадзію як контракт межа вхіднымі данымі і перакананымі выходнымі рэзультатамі. Дайце назвы артыфактам, задаце правіла пераканання успеху і не падтрымайце тых частковых выпанняў, якія залішаюцца непазначанымі. Зробіце пераконтроўку пасля дорогіх крокаў. Програма для продакцыі не павінна знову сцягваць плата за той самы вызов LLM, калі аператар прабуе зноў выконаць пазнейшы вузел. Калі працуеце над стадзіяй «Аналіз на адказах доказаў, як ZQ», спачатку запісайце «контракт»: неабходныя вхідныя даны, сігнал успеху і тое, што выходзіць у разе частковага невыпання. Такі спіс пераконтроўкаў дапамагае заліцвачыць пазнейшыя змены ў кодзе. Зберагачыце настройкі параду ўнутры коду прыемлівача. Файлы сераў, хранільнікі секрэтных дадзеных і флагі функцый павінны знаходзіцца ў аднам месцы, куды аператары можаць адбавіць аўдыт, не чытаючы весь граф.

Код: Канфігурацыя інструмента агента

Этап канфігурацыі інструмента агента працюе найэфектывней, калі яго розглядаць як мерыемую структуру. Зберагчы адна ідэальная транскрыпцыя, адзін прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Дакументавайце як успішны, так і вярнучыся шляхі. Перапрыбуткі, людзкія контрольны пункты і обработка некорэктных паведамленняў ёсць часткай продукту, а не элементамі пазнейшага доўнеравання. Адкрывайце інструменты з вузкімі схемамі і чысткімі пазначэннямі побачных эфектаў. Хостам неабходна знаты, якія вызовы мутуюць стан, перш чым яны автаматычна схваляюць ўпрацоўкі.

# ZQ Macro Agent: tool definitions (agent_spec.py)
tools:
 - tool_spec:
 type: "generic"
 name: "retrieve_evidence"
 description: "Retrieves central bank sentences via Cortex Search and persists for NLP classification. Returns REQUEST_ID for classifier tools."
 input_schema:
 type: "object"
 properties:
 QUERY: { type: "string", description: "Search query for central bank communications" }
 CENTRAL_BANK: { type: "string", description: "Filter by central bank. NULL for all." }
 K: { type: "number", description: "Number of evidence sentences (default 25, max 200)." }
 required: [QUERY]
 - tool_spec:
 type: "generic"
 name: "classify_stance"
 description: "Classifies retrieved evidence by monetary policy stance (Hawkish/Dovish/Neutral). Requires REQUEST_ID from retrieve_evidence."
 input_schema:
 type: "object"
 properties:
 REQUEST_ID: { type: "string", description: "REQUEST_ID from retrieve_evidence" }
 required: [REQUEST_ID]

Код: Пошук у Cortex і зберагчыце падтверджэння

Пошук і адміністрування ў Code Cortex работаюць наяўна, калі іх спрыяваць як мерыемую паверхню. Зафіксавайце адны ідэальны прыклад працы, адну справу з бягам і прыміткі па адварцы раней, чым расшырваце сферу дзеяння. Валіце маленькія, тэставаныя елементы замест большых скрыптов. Калі якісь крок не выйшае, прычына бягу должна вказваць на адну конкрэтную адпаведальнасць, а не на заплутаны ланцюг задач. Рэзультаты графа трэба зберагаць у простай форме з чыстым тыпам дадзеных. Вкладаныя структуры дадзеных маскуюць інфармацыю пра тое, які вузел запісаў канкрэтны поле, і спакоююць працу пасля перэрываў.

- Cortex Search service over CB sentences
CREATE OR REPLACE CORTEX SEARCH SERVICE TESTING.CB_AI.SENTENCE_SEARCH_SVC
 ON TEXT
 ATTRIBUTES CENTRAL_BANK, YEAR, DOCUMENT_TYPE
 WAREHOUSE = CB_AGENT_WAREHOUSE
AS
SELECT ID, TEXT, CENTRAL_BANK, YEAR, DOCUMENT_TYPE, RELEASE_DATE, …
FROM TESTING.CB_AI.SENTENCE_SEARCH_VW;
 - Evidence and labels tables for traceability
CREATE TABLE TESTING.CB_AI.EVIDENCE_HITS (
 request_id STRING, hit_id STRING, rank INT,
 document_id STRING, sentence_id STRING, text STRING, …
);
CREATE TABLE TESTING.CB_AI.MODEL_LABELS (
 request_id STRING, model_id STRING, hit_id STRING,
 prediction STRING, confidence DOUBLE, …
);

Ланцюг задач: Адзысканне → Класыфікацыя → Агрэгацыя

Этап адміністрацыі, класыфікацыі і выявлення даных у паіплайне працюе наявнасцю калэндара, які можна вымерыць. Зберагачыце адны ідэальны прыклад транскрыпцыі, адны прыклад неудачы і запіс пра вярнэнне да пачатковага стану, перш чым расшырваць сферу дзеяння. Спрыятлівае ставленне да гэтаго этапу — як да кантракту межа вхіднымі дадзеннямі і перакананымі выходнымі рэзультатамі. Называйце всі элементы, задаюце крытэрыя успеху і не падзеляйцеся на частковыя рэшэння без паведамлення. Раздзеляйце правілы часткавага абрабатавання дадзеных і правілы ўзяць іх збоку. Змена адных не павінна вымагаць перапісву іншых, калі зменяюцыся паказчыкі якасці.

Заключэнне

У стадыі Заключэння неабяжна практычна вызначыць інпуты, адпавядаючага за крок адпаведальнага, а таксама крэтыяры выходу пры перадзеіснаванні коду. Аператары должны магчымаць перзапуск кроку з вядомай точкі контролю, не падозрываючы схованы стан. Неабяжна дакументаваць як шлях успеху, так і шлях вярнення. Перапрыбуткі, людзкія перакрыцці і апрацоўка некорэктных паведамленняў ёсць часткай продукту, а не пасляднім дапрацоўкам. Неабяжна прыняць людзкую згоду для тых крокаў, якія выкарыстоўваюць грошы або зменяюць даны праўай працы. Працэс кампілявання не ўзроўнаважваецца з повнасцю бізнес-функцый.

Справакі

У стадыі «Апавяранні» неабходна дэфініцыя вхідных даных, адміністратара крока і крэтэрыяў завершэння пры змены коду. Аперацыйныя працавнікі павінны магчымае перадзванаць крок з вядомай точкі контролю, не падозрываючы прыхованы стан. Лепш выбіраць маленькія, тэставаныя елементы замест большых скрыптов. Калі крок не выйшаў, прычына неудачы павінна вказваць на адзін конкрэтны аспект, а не на заплутаны працэс. Неабходна людская апраўда для тых крокаў, якія выкарыстоўваюць грошы або зміняюць даны ў працэсе. Компіляцыйныя налашчэння не ёсць падтверджэннем полнай адпаведнасці працы сістэме.

Чэк-ліст для аперацый

Працюючы над чэк-лістам для аперацый, спачатку запісайце умовы: неабходныя вхідные даны, сігнал успеху і тое, што вядзецца пры частковай неудачы. Такі чэк-ліст дапамагае заставіць пасляўсія змены коду чыстымі і працэзгоднымі.

Запісвайце часы выканання а таксу кранцоў чы розпыткаў праза функцыйнае рэзультаты. Відразлівае паказанне таксаў запобегае неспадзяваным рачункам, калі маршрут пераходзіць з дэмавай версіі ў спяльныя асяроддзя.

Зробіце контрольную точку пасля дорогіх крокаў. Продакцыйны рэжым не павінен зноў нарахоўваць тую ж самую плату за вызов LLM, калі аператар перапрыямляе працу да пазнейшага вузла.

Закрэпіце версіі залежнасцяў і запісвайце хеш адобразу, які выканаў дэмонстрацыю. Возможнасць перадарабаткі прыважней за традыцыйныя знаёмства.

Зберагачыце настройкі параду ад коду прыемлі. Файлы асяроддзя, хранільнікі секрэтных дадзенняў і флагі функцый павінны знаходзіцца ў аднам месцы, якое аператары можаць пераглядаць без неабяжнай чытанняў усіх элементаў структуры.

Зробіце контрольную точку пасля дорогіх крокаў. Продакцыйны рэжым не павінен зноў нарахоўваць тую ж самую плату за вызов LLM, калі аператар перапрыямляе працу да пазнейшага вузла.

Перш чым запускаць стак, заморозьце версіі, зафіксавце «золаты» транскрыпты для крытычнага шляху і паказвце способы абяроны. У спільных срэдах неабходны ліміты частоты запытанняў, пераконтроўкі прав на выкарыстоўванне рэсурсаў і чысткі власнік для змены секрэтных даных. Валіце простую надзейнасць працы над крэатывнымі, адзінразовымі дамах.

Прыметкі для b3ca06f8cc84: не кладзіце ключы прадаўцаў у рэпазітарый, задаце ліміт токена на кожную сесію і зберагачыце транскрыпты празаўседы ў фіксы для ацэнкі, каб пазнейшыя замены мадэляў заставаліся пораўнанымі.