Toolkit,由 Pushpak Chhajed 在 Ship Fast Labs 旗下开发,是一个可重用工具的社区目录。 Laravel AI SDK 这些工具位于同一个 monorepo 中,但作为单独的 Composer 包发布,因此您只需安装代理所需的那些工具即可。
每个工具一个包装,不提供服务提供商
每个工具都是一个实现类的类
Laravel\Ai\Contracts\Tool
— a
description()
, A
handle()
,和一个
schema()
没有共享核心,无需注册服务提供者,也没有已发布的配置。您需要引入所需的软件包,实例化工具,然后将其传递给代理。
tools()
:
作曲家
要求
shipfastlabs/toolkit-calculator作曲家
要求
shipfastlabs/toolkit-database
使用
Shipfastlabs\Toolkit\Calculator\CalculatorTool
;使用
Shipfastlabs\Toolkit\Database\DatabaseQueryTool
;工具
=
[
新的
计算器工具
,
新的
数据库查询工具
,];
每种工具都通过以下方式宣传其用途:
description()
及其输入
schema()
模型会决定何时调用它。结果(包括错误)以字符串形式返回,因此模型可以读取失败信息并进行恢复,而不是直接抛出请求。
不使用 eval() 的计算器
计算器工具接受
expression
字符串并使用递归下降解析器而不是 PHP 的解析器进行评估
eval()
它支持
+
,
-
,
*
,
/
,
%
,
^
支持右结合指数、括号、一元符号和小数。无效输入、除以零或取模零以及非有限结果将以纯字符串形式返回给模型,而不是抛出异常。这是一个“纯粹”的工具:无需配置,也无需服务提供程序。
只读数据库查询
数据库工具运行单个 SQL 语句
SELECT
并以美观的 JSON 格式返回匹配的行。它的限制条件正是关键所在:
- 仅包含一条以……开头的语句
SELECT(或WITH … SELECT允许进行 CTE 治疗。 INSERT,UPDATE,DELETE,DROP,ALTER类似的关键词会被拒绝,即使在其他情况下也是如此。SELECT陈述。- 包含以下信息的查询
;分隔符被拒绝。 - A
LIMIT会附加到任何缺少参数的查询中。
可配置工具从……读取
ai.toolkit.*
您添加到 Laravel AI SDK 现有密钥中的
config/ai.php
— 没有单独的配置文件需要发布:
// config/ai.php工具包
=>
[
'数据库'
=>
[
'联系'
=>
环境
(
'TOOLKIT_DATABASE_CONNECTION'
),
'max_rows'
=>
(
整数
)
环境
(
'TOOLKIT_DATABASE_MAX_ROWS'
,
100
),],],
指向
connection
只读副本增加了一层额外的安全保障,
max_rows
限制返回的行数。
网络搜索和研究提供商
三个软件包封装了搜索和研究 API,每个软件包都有一个辅助函数,可以一次性注册所有 API,也可以从中选择单个工具类:
- 埃克萨
(
toolkit-exa):ExaSearch,ExaFindSimilar,ExaGetContents, 和ExaAnswer用于基于嵌入的网络搜索、相似性查找、内容提取和带引用的来源答案。 - 困惑
(
toolkit-perplexity):PerplexitySearch对于排名来源和PerplexityAsk对于声纳模型中引用的答案,web,academic, 和sec搜索模式。 - 融化
(
toolkit-tavily):TavilySearch,TavilyExtract,TavilyCrawl, 和TavilyMap用于搜索、内容提取、网站爬取和网站地图绘制。
使用
Shipfastlabs\Toolkit\Exa\Exa
;工具
=
埃克萨
::
全部
();
// Collection
每个提供商都从 Laravel 读取其 API 密钥。
services
配置及其可选默认值
ai.toolkit.*
数值参数被限制在有效范围内,枚举参数回退到安全默认值,API 错误被捕获并以字符串形式返回,而不是抛出。
JigsawStack 的端点库
JigsawStack 包(
toolkit-jigsawstack
每个端点都提供一套工具,这些工具分为通用、翻译、网页、视觉、音频和验证等类别。其功能涵盖情感分析、摘要、嵌入、文本转 SQL、时间序列预测、文本和图像翻译、网页搜索、AI 数据抓取、HTML 转图像/PDF、语音识别、目标检测、语音转文本以及 NSFW/脏话/拼写/垃圾邮件检查。
每个工具都对应一个端点,并返回原始 JSON 响应(已格式化),以便模型可以读取每个字段。请求会在 60 秒后超时,如果缺少 API 密钥,则会返回明确的“未配置”消息。
安装
选择您需要的工具,并逐一申请——例如:
作曲家
要求
shipfastlabs/toolkit-calculator作曲家
要求
shipfastlabs/toolkit-tavily
远程 API 工具需要它们的提供商密钥。
config/services.php
(以及匹配的)
.env
条目);每个工具的文档页面列出了确切的配置键和默认值。






