Skip to main content

LICOS Agent Runtime

build_agent_graph(model, tools, system_prompt=...) 提供统一的输入 → 模型 → 工具循环,模型与工具由项目注册。inputmessagesevent 可以组合使用;模型调用保留完整工具消息对,多模态输入保持原始内容。

python -m licos_agent_runtime -m verify --cases tests/agent_cases.json --base-url http://127.0.0.1:5000 --report .tmp/agent-verification.json

验收连接已有预览,核对 HTTP、SSE、模型/业务工具调用与运行记录。业务场景在用例中指定 required_toolsmodel_contains;报告引用实际 run_id,错误导致非零退出码。

本体事件执行

业务项目运行时可通过 config/event_subscriptions.json 管理后台订阅。默认空数组,不建立订阅。浏览器断开不影响已启动的服务;预览进程或项目实例休眠后订阅会停止,持续监听需要部署为常驻业务服务。该功能不保证唤醒已休眠的开发实例。

先对项目运行 python -m licos_agent_runtime -m fingerprint 取得当前源码版本,再配置绑定:

[
  {
    "id": "process-observation",
    "workspace_id": "当前工作空间 ID",
    "project_id": "当前业务 AGENT 项目 ID",
    "project_version": "fingerprint 命令返回的 SHA256",
    "element_ids": ["已从本体目录解析的元素 ID"],
    "attribute_ids": ["已授权的属性 ID"],
    "enabled": true,
    "max_pending": 100
  }
]

max_pending 由业务配置,没有写死容量。每个绑定按接收顺序串行执行,绑定之间可并行。源码版本与运行时热更新使用同一份源文件集合;绑定配置本身不参与指纹,避免自引用。源码或模型配置变化后需要重新验收、更新版本绑定并重启服务。身份与当前项目不匹配、版本不匹配、参数或权限错误都会明确失败。

  • GET /agent/subscriptions 查看绑定、连接状态、最近执行及错误。
  • POST /agent/subscriptions/{id}/stop 停止当前订阅和执行。
  • POST /agent/subscriptions/{id}/start 启动已加载的绑定。配置文件新增或修改绑定后重启服务使其加载。

事件通过 SDK 接收后写入 /workspace/.licos/event-subscriptions/deliveries.sqlite3,直接调用本项目的业务图,不调用编程助手 /messages。已有日程任务针对会话,因此这里持久化业务运行时自己的投递队列,并复用工作区持久卷和运行记录。文件锁阻止共享同一工作区的多个运行时重复监听。实际执行前经过与 /run 相同的余额检查。

每次投递保留原始事件、绑定、源码/运行时版本以及 run_id,模型和工具证据可在 /run_records/{run_id} 查阅。待执行事件随服务重启恢复;运行中断标记为 interrupted,失败标记为 failed,均不自动重放。积压达到配置上限时记录该事件失败并停止订阅,错误可查询。

当前上游协议未承诺稳定事件身份或断线回放:相同时间和值的事件全部保留,运行时生成的投递 ID 仅用于本地追踪,不代表上游事件 ID。已接收且落盘的待执行事件可恢复,连接中断期间的上游事件无法保证补齐。人工/历史回放使用普通事件输入并保留真实来源,不能当作 WS 新事件验收。

用量

SSE 完成事件和运行记录共用模型用量汇总;token_usage.complete=false 表示至少一次模型调用没有用量记录。已统计数值仅是已知部分,不能把未上报当成零消耗。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

licos_agent_runtime-0.2.36.tar.gz (89.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

licos_agent_runtime-0.2.36-py3-none-any.whl (77.9 kB view details)

Uploaded Python 3

File details

Details for the file licos_agent_runtime-0.2.36.tar.gz.

File metadata

  • Download URL: licos_agent_runtime-0.2.36.tar.gz
  • Upload date:
  • Size: 89.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.10.7

File hashes

Hashes for licos_agent_runtime-0.2.36.tar.gz
Algorithm Hash digest
SHA256 ae3e3344121f2ec522c92937bf12a833fcd1a84564b0e85b837cdf8546096a88
MD5 f4600c115ab550f959293e4a17335156
BLAKE2b-256 5eb6065a40cafd99dfa5cabba51fb49c19e49803e6e8c311efff54bc207677dd

See more details on using hashes here.

File details

Details for the file licos_agent_runtime-0.2.36-py3-none-any.whl.

File metadata

File hashes

Hashes for licos_agent_runtime-0.2.36-py3-none-any.whl
Algorithm Hash digest
SHA256 9a5e39a1d2eb557533ef653d652fbbb0d75e7ab41b37137d2b58b56e8b51f96c
MD5 0cd2049a109bc2a323ce66cd16fe7a2a
BLAKE2b-256 af287df3751495797b163d24519f44de13ea2dd2c90237381d0bce5bd416ac97

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.43

2 files

0.2.42

2 files

0.2.40

2 files

0.2.38

2 files

0.2.37

2 files

This release

0.2.36 This release

2 files

0.2.35

2 files

0.2.34

2 files

0.2.33

2 files

0.2.32

2 files

0.2.31

2 files

0.2.30

2 files

0.2.29

2 files

0.2.28

2 files

0.2.27

2 files

0.2.26

2 files

0.2.25

2 files

0.2.24

2 files

0.2.23

2 files

0.2.22

2 files

0.2.21

2 files

0.2.20

2 files

0.2.19

2 files

0.2.18

2 files

0.2.17

2 files

0.2.16

2 files

0.2.15

2 files

0.2.14

2 files

0.2.13

2 files

0.2.12

2 files

0.2.11

2 files

0.2.10

2 files

0.2.9

2 files

0.2.8

2 files

0.2.7

2 files

0.2.6

2 files

0.2.3

2 files

0.2.2

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page