コンセプト

用語集

主要な技術用語と、理解を助けるための役割名を、1語1行で説明します。仕様上の正確な意味は仕様に従います。両者が食い違うときは仕様が正です。

用語意味
作者(Author)プログラムを書く人、またはエージェント。
CapabilityConnectorがそのシステムについて提供できること。対応する読み取りと書き込み、そのシステム自身が計算できること。プッシュダウンの根拠になる。許可ではない。
Carrier演算が扱う、型付きのコレクションの種類。Relation、Graph、Vectors、Eventsの4つ。テーブル以外のデータを参照。
Checkpoint保護された処理が判断を待つための、永続的な停止地点。何を判断するかと、Runをどう続けるかが固定される。Runが始まる前の準備段階でも起こりうる。
CID正規化した内容から計算する識別子。プログラムの意味、Plan、観測、プレビューをそれぞれ区別する。
ConnectorActQLを1つの外部システムにつなぐ部品。読み取り元、Capability、Effectを宣言する。
CoreActQLのうち、プログラムの意味を担当する部分。検査、計画、計算を行い、Runの状態遷移を持つ。
判断の委譲先(Decider)delegateされたポリシーの判断に答えるもの。人、自動のルール、承認用のアプリ、またはその組み合わせ。
Effect外部システムの状態を変える、宣言された操作。更新、追加、削除、型付きのコマンド、保存など。適用にはHostの許可が必要。
Effectの結果(Effect outcome)Effectのために送った操作1つがどうなったか。applied、accepted、failed、unknown のどれか。送らなかった項目は unattempted、失敗後に取り消した項目は rolled_back。複数の項目を持つEffectは項目ごとに結果を記録し、一部だけ適用された状態で終わることもある。
ガード(Guard)システムやHostが決める上限に加えて、作者がプログラムに足す上限。
Hostあなたの環境でActQLを動かし、ポリシー、認証情報、Storeを管理する部分。アプリへの組み込み、CLIの裏、サーバーなどの形があり、ActQL CloudはマネージドなHost。
INFER各レコードの、model taskで指定した入力をLLMに渡し、レコードごとに型の付いた答えを返す句。
Invocation1つの計算単位への、意味上の入力。束縛した値、依存する定義、取り込んだ観測を固定したもの。複数のStageを持つプログラムでは、Stageごとに1つ。
上限(Limit)件数、バイト数、呼び出し回数、Effectなど、量に対する上限。対象の処理を始める前に確定し、超えた処理はエラーで失敗する。
model taskLLMに何を頼むかを定めた、バージョン付きの定義。指示、入力の型、出力の型を持つ。プログラムは INFER で名前で参照する。
運用者(Operator)Hostを動かし、接続、認証情報、ポリシーを設定する人。
Plan(計画)検査済みのプログラムからCoreが組み立てる実行契約。演算、型、外部とやり取りする境界、上限。各部分を物理的にどこでどう実行するかは、その意味を保つ範囲で選ばれる。
ポリシー(Policy)ユーザー、接続、リソース、操作ごとに、読み取り、LLMの呼び出し、Effectを allow、deny、delegate のどれにするかを答えるHostの設定。
プレビュー(Preview)Effectが適用しようとする対象と変更内容を、記録された結果から固定したもの。書き込む前に作られる。いまの値まで見えるかはConnectorの能力による。
プログラム(Program)ActQLで書くひとまとまりの処理。読み取り、計算、LLMの呼び出し、Result、Effectを含む。
プッシュダウン(Pushdown)処理の一部を、データを持つ外部システム側で実行させること。結果、失敗時の振る舞い、権限、観測するデータの範囲がすべて変わらない場合に限る。
突き合わせ(Reconciliation)RunやEffectの不明な結果を、元の操作の証拠から確定させること。解決できないこともある。証拠なしに再送することはない。
Resultプログラムが公開する、名前付きの出力。保持され、必要な権限を持つ呼び出し元や後続の処理から読める。
Runプログラムの1回の実行と、その永続的な記録。何を読み、どんな応答を受け取り、何を送り、何を判断したか。
読み取り元(Source)プログラムがデータを読む先。ConnectorのSourceView、またはローカルでプログラムに渡した型付きのデータ。
SourceViewConnectorが1つのリソースについて公開する、バージョン付きの契約。型、読み取り方、制約を定める。
Stageプログラムを構成する、有限の処理単位。後続のStageは、先行するStageのResultや受領記録を使える。
Store実行と復旧に必要なものをHostが保持する場所。Runの状態、観測、Result、Checkpoint、Effectの台帳。

Source: actql/actql/docs/concepts/glossary.md at d904416674e4 · Edit on GitHub