跳转到主要内容
Chinese, Simplified

category

正文

披露:我是 PRAXO-CORE 维护者。本文基于 2.10.0 公开范围;不是生产、安全或平台兼容性认证。

Perl 是很多人眼里的“遗留胶水”。

但在运维、电信、金融、生物信息和内部工具环境里,Perl 仍然跑着大量关键任务:cron、日志处理、数据清洗、报表、系统集成。

这些脚本握着凭证、路径、重试逻辑和异常规则。重写成 Python,不是语法清理,而是迁移。

PRAXO-CORE 的 Perl SDK 是一个工程实验:不重写胶水,而是在脚本进程里放一个受治理的 Agent 循环。

这篇文章拆三件事:包结构、coderef 工具、边界。

一、入口:run_agent

核心调用:

use Praxo::Agent ();

my $options = Praxo::Agent::AgentOptions->new($model);
my $result = Praxo::Agent::run_agent(
    $options,
    Praxo::Models::session(id => 'demo'),
    'hello',
);
print $result->{output};

这个接口看起来很简单,但背后包含:options、session、message、tool registry、policy、event sink、checkpoint、context budget、middleware。

二、包结构:用 Perl 的方式表达 Agent

包 作用
Praxo::Agent Agent 循环、options、tool registry、function tool
Praxo::Models message、request、response、usage、session、event、decision、stream kinds
Praxo::Runtime path checker、memory store、checkpoint allowlist、context budget、token estimate、event sink
Praxo::Toolcall tool-call 解析、markup 移除
Praxo::JsonSchema JSON Schema 校验
Praxo::Plugin manifest 解析
Praxo::Middleware call limit、fallback、PII 脱敏、structured output、tool selection

Perl 没有 Java 那样的接口体系,所以 model、tool、policy、event sink 用包和 coderef 组合表达。tool registry 持有 function tool;function tool 持有一个 coderef。这个设计很 Perl:不引入大型对象框架,直接用语言本身的组合能力。

三、工具:coderef 作为工具实现

注册工具:

my $registry = Praxo::Agent::ToolRegistry->new;
$registry->register(Praxo::Agent::FuncTool->new('echo', 'Echo arguments', sub {
    return $_[0];
}));

my $options = Praxo::Agent::AgentOptions->new($model);
$options->{tools} = $registry;
$options->{max_steps} = 8;

这里的关键不是“能注册函数”,而是工具调用的边界:

  • 工具参数要经过解析和校验;
  • 工具调用要经过策略;
  • 工具结果要能被事件和检查点记录;
  • 失败要传播,不能静默吞掉。

四、依赖:核心模块 only

Perl 常被吐槽依赖树太深。这个 SDK 刻意反过来:

  • JSON::PP 处理 JSON;
  • File::Spec 处理路径;
  • Cwd 处理工作目录。

没有 Python host,没有 provider SDK,核心循环不需要编译扩展。

这不等于“绝对零依赖”,但它把依赖面做小、做可审计。在一个新增 CPAN 树都算变更控制事件的环境里,这一点很重要。

五、三个 partial 面

必须明确:

  1. event sink:覆盖向量行为和常见路径,但不是每个可选 Go hook;
  2. stream part:有 stream kind 表示,但不是异步运行时;
  3. JSON Schema:覆盖向量定义行为,但不是完整 JSON Schema。

其余声明范围内通过。parity 清单会明确标出这三个 partial。

六、治理与凭证

如果 Agent 住在一个新的 Python 服务里,策略、工具授权、检查点、审计事件、人工审批都要跨进程重新建立,凭证也可能要复制或委托。

如果循环就在 Perl 进程里,凭证、路径和策略决策可以靠得更近。这减少了一种边界穿越,但不自动等于安全或合规。

七、代价与不适用场景

Perl SDK 的当前范围:

  • 11 组向量通过;
  • 原生测试;
  • 公共 API 快照;
  • 远程 perl-conformance CI;
  • 源码 tag perl/v0.7.0;
  • 三个 partial 面;
  • provider adapter 需调用方提供传输;
  • 不是 CPAN 发布;
  • 不宣称异步运行时;
  • 不是通用 PII 合规;
  • 不宣称生产可用。

如果你需要 CPAN 安装、开箱即用托管服务、向量数据库、完整编排、异步高吞吐或 provider adapter,这个 SDK 不是答案。

八、结论

Perl 不需要变成 Python,才能用 Agent。

它需要的是一个能在原进程里受治理地运行、依赖面小、边界清楚的 Agent 循环。

PRAXO-CORE 的答案是:原生包、coderef 工具、核心模块 only、明确 partial、把限制写进 parity 清单。

仓库:https://github.com/axisvela/praxo-core
Perl 源码:https://github.com/axisvela/praxo-core/tree/main/language/perl
Perl 文档:https://axisvela.github.io/praxo-core/languages/perl/
语言矩阵:https://github.com/axisvela/praxo-core/blob/main/spec/languages.md

本文地址
最后修改
星期六, 十一月 21, 2026 - 17:52
Article
↑