Agent Skills
返回列表
💻

Laravel AI SDK

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/asyrafhussin-agent-skills-laravel-ai-sdk。

技能介绍

你在 Laravel 里做 AI 时常见卡点

业务方要对话 Agent、图片生成或知识库问答,文档往往分散在多个包说明里。laravel/ai 把 Agent、Provider 工具、嵌入与媒体生成放在同一套 API 下,但 middleware 管道、RemembersConversations、结构化输出 schema 和测试用的 Fake 对象,很容易按错误顺序接或漏测 prompt。

这份技能如何组织知识

技能按优先级拆成 7 类、共 17 条规则,每条对应独立说明文件:坏例子 / 好例子,并标注 Laravel 13 与 PHP 8.3 语境。

  • Agents:artisan 创建与 PHP Attribute 配置、agent-streaming-async(流式、广播、队列)、匿名 Agent 快速交互
  • Tools:自定义工具的 schema 与 handle,以及 WebSearch、WebFetch、FileSearch、SimilaritySearch 等 Provider 工具
  • Embeddings & Search:生成与缓存向量、embed-rerank 重排文档与集合
  • Media:图片生成排队存储、TTS 与 STT
  • Files & Storage:RAG 用的文件与 vector stores
  • Infrastructure:infra-failover 多 Provider 自动切换
  • Testing:Fake agents、断言 prompt、Fake 嵌入与媒体数据

完整展开版在资料中的 AGENTS.md;日常开发按场景查对应 agent- / tool- / embed- 等前缀规则即可。

适用边界

规则面向 Laravel AI SDK(laravel/ai) 官方能力,不是通用 Prompt 写作教程。若栈不是 Laravel 13 或暂不接队列/广播,流式与异步相关条目需自行裁剪。RAG 部分假设你会接 vector store 与文件检索,不包含向量数据库选型对比。

使用场景

  • 在现有 Laravel 13 项目里用 artisan 创建 Agent,并要求对话输出符合 JSON Schema 的结构化字段
  • 为需要多轮上下文的客服接口配置 RemembersConversations,同时用队列或广播推送流式 Agent 回复
  • 实现内部知识库问答:生成并缓存文档嵌入,接 FileSearch / SimilaritySearch 再做 rerank
  • 上线前用 Fake agents 与 prompt 断言覆盖图片生成、转录和嵌入相关代码路径,避免测试打到真实 API

适合人员

  • 维护 Laravel 队列与事件广播的 PHP 后端,要把对话 Agent 接到现有 Job 与 Channel 里
  • 负责企业知识库检索的产品工程师,需要在同一套 Laravel 应用内完成嵌入、向量库与 SimilaritySearch
  • 全栈负责内容生产流水线,要用 SDK 排队生成图片并落盘,同时处理 TTS/STT 转写
  • 写 Laravel 特性测试的工程师,希望用 Fake 与 assert prompts 约束 AI 调用、防止测试环境误发真实 prompt