Практычныя прытамулкі: ZQ Intelligence: Агенты-оркестраторы та спецялісты для фінансавых задач

Існавайце гэта як перапрацоўаны варыянт ідэй з кніги “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: не кладзіце ключы прадаўцаў у репазітарый, задаце ліміт токена на кожную сесію і зберагачыце транскрыпты празаўседы ў фіксы для ацэнкі, каб пазнейшыя замены моделяў заставаліся пораўнанымі.