読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第4節 アクション

4.2 関数として定義する

練習の practice/agent_data/actions.py では、支払保留の解除を2段階の関数にしています。

def request_release_payment_block(conn, user, document_number, reason) -> ActionRequest:
    """支払保留の解除の依頼を作る。表はまだ書き換えない。"""
    row = conn.execute(
        "SELECT status, payment_block FROM invoice WHERE document_number = ?", (document_number,)
    ).fetchone()
    if row is None:
        raise ActionRejected(f"請求書 {document_number} はありません")
    if row["status"] != "blocked":
        raise ActionRejected(f"請求書 {document_number} に支払保留は付いていません")
    ...
    return ActionRequest("release_payment_block", document_number, user.name, reason, checks=checks)


def approve(conn, request, approver) -> ActionRequest:
    """承認者が承認したときだけ、保留を外す。"""
    if APPROVERS.get(approver.name) != request.approver_role:
        raise PermissionError(f"{approver.name} さんは、この依頼を承認できません")
    ...

エージェントが呼べるのは、request_release_payment_block だけです。この関数は、前提を検査して依頼を作り、表は書き換えません。依頼には、承認者が確かめる点(保留の種類、規程の条文、検収の連絡)を checks として付けます。表を書き換える approve は、承認者の画面から呼びます。

PostgreSQL では、同じ決まりを関数(CREATE FUNCTION)と権限で表すこともできます。どちらで書いても、エージェントの道具からは書き込みを直接実行できない形にします。

解答例

依頼を作る前の検査:仕入先が存在すること、銀行情報がまだないこと、取引先から書面で届いた口座の情報が添えられていること。承認者(登録した人とは別の担当者)が確かめる点:書面と登録内容が一致すること。確かめた後の支払日から、支払の対象に含めること。

15 / 20