【愚公系列】《扣子开发 AI Agent 智能体应用》009-扣子插件和卡片（卡片制作实战案例：最新头条新闻）

优质文章学习记录

— 10 min read
【愚公系列】《扣子开发 AI Agent 智能体应用》009-扣子插件和卡片（卡片制作实战案例：最新头条新闻）

💎【行业认证·权威头衔】
✔ 华为云天团核心成员：特约编辑/云享专家/开发者专家/产品云测专家
✔ 开发者社区全满贯：ZEEKLOG博客&商业化双料专家/阿里云签约作者/腾讯云内容共创官/掘金&亚马逊&51CTO顶级博主
✔ 技术生态共建先锋：横跨鸿蒙、云计算、AI等前沿领域的技术布道者

🏆【荣誉殿堂】
🎖 连续三年蝉联"华为云十佳博主"（2022-2024）
🎖 双冠加冕ZEEKLOG"年度博客之星TOP2"（2022&2023）
🎖 十余个技术社区年度杰出贡献奖得主

📚【知识宝库】
覆盖全栈技术矩阵：
◾ 编程语言：.NET/Java/Python/Go/Node…
◾ 移动生态：HarmonyOS/iOS/Android/小程序
◾ 前沿领域：物联网/网络安全/大数据/AI/元宇宙
◾ 游戏开发：Unity3D引擎深度解析

文章目录

🚀前言

扣子的插件是一个工具集，包括资讯阅读、旅游出行、效率办公、图片理解等 API及多模态模型，使用这些插件可以极大地拓展智能体的能力边界。扣子还支持智能体以消息卡片的形式发送消息，卡片可以让输出的格式更加美观。本章将介绍扣子的插件和卡片的用法。

🚀一、卡片：丰富智能体交互形式

🔎1.什么是卡片

在扣子平台中，卡片（Card） 是一种用于优化信息展示格式的富媒体消息模板。它旨在将智能体返回的原始文本数据（如标题、摘要、链接、图片地址等），按照预设的、美观的视觉布局呈现给用户，从而显著提升交互体验。

例如，智能体通过插件获取到一篇新闻数据。如果直接以纯文本输出，可能只是平淡的文字列表。而如果预先设计好一个新闻卡片模板，将标题、摘要、图片和链接等元素精心排版，最终就能呈现出一个图文并茂、结构清晰的新闻卡片（如图所示的新闻列表或列表卡片），使信息更易读、更吸引人。

在这里插入图片描述


在这里插入图片描述

🦋核心概念与规则

  • 权限：卡片暂不支持多人协作编辑。只有卡片的创建者本人可以编辑或删除自己创建的卡片，团队内其他成员（包括所有者和管理员）均无此权限。
  • 构成：卡片由组件（Component） 搭建而成，组件分为两类：
  • 生效范围：目前，消息卡片仅在豆包客户端和飞书客户端内能够正确渲染显示。
  • 支持场景：仅当通过工作流或插件返回数据时，才能调用并渲染消息卡片。

基础组件：用于承载和展示具体内容，如图片、文本、按钮等（如图）。一个完整的卡片通常由布局组件搭好骨架，再由基础组件填充内容（如图所示的图片+文本卡片）。

在这里插入图片描述


在这里插入图片描述

布局组件：用于划分卡片的整体结构区域（如图），例如分栏、网格等。可对每个布局区域单独进行参数设置，实现灵活多样的版面设计。

在这里插入图片描述

🔎2.卡片制作实战案例：最新头条新闻

本节将通过一个完整案例，学习如何制作一个用于展示头条新闻列表的消息卡片。目标是调用“头条新闻”插件获取数据，并利用卡片以列表形式优雅地展示出来。

案例目标：制作一个如图所示的新闻列表卡片，每条新闻包含左侧图片和右侧的文字标题与摘要，并能循环展示多条新闻。

在这里插入图片描述

🦋第1步：创建卡片并设计布局

  1. 进入扣子平台“资源库”，点击“+资源”，选择“卡片”。
  2. 在卡片编辑界面，从“组件”面板拖拽布局组件。本例需要左右两列（1:1），因此选择“多列布局”，并将其调整为两列。

为了适配正方形图片并给文字更多空间，可以调整列宽比例。例如，将图片所在列的宽度比例设为1，文字所在列设为5，通过中间虚线框预览调整效果。

在这里插入图片描述

🦋第2步：添加并配置基础组件

在布局好的两列中，分别添加基础组件：

  1. 左侧列：添加一个“图片”组件。

右侧列：添加两个“文本”组件，分别用于显示新闻标题和摘要。
（可选）为提升美观度，可在图片和文字列之间插入一个空列作为间隔。

在这里插入图片描述


此时，卡片的静态结构已搭建完成。点击“结构”标签（如图），可以清晰看到由两列（Column）组成的树形结构，每列下包含对应的组件。

在这里插入图片描述

🦋第3步：创建模拟数据并绑定循环

为了预览效果，需要先创建模拟数据并实现列表循环渲染。

  1. 创建数组变量：
    • 切换到“变量”选项卡，点击“新建变量”。
    • 设置变量名，如 newsList。
    • 变量类型选择 Array（数组）。

在“默认值”中，粘贴一个包含3条模拟新闻数据的JSON数组。每条数据应包含 title（标题）、summary（摘要）、image（图片URL）、url（链接）等字段。

[{"title":"新闻标题1","summary":"新闻摘要的作用很重要。","image":"https://www.cloudssss.com/images/common/footer-logo.png","url":"https://www.cloudssss.com"},{"title":"新闻标题2","summary":"新闻摘要的作用很重要。","image":"https://www.cloudssss.com/images/common/footer-logo.png","url":"https://www.cloudssss.com"},{"title":"新闻标题3","summary":"新闻摘要的作用很重要。","image":"https://www.cloudssss.com/images/common/footer-logo.png","url":"www.cloudssss.com"}]
在这里插入图片描述
  1. 启用循环渲染：
    • 在画布或“结构”视图中，选中卡片的最外层布局组件。
    • 在右侧“高级配置”中，打开“循环渲染”开关。
  2. 为组件绑定数据：
    • 点击图片组件，在资源配置中，选择数据源为：循环项 -> image（即 item.image）。
    • 点击标题文本组件，在内容配置中，绑定数据源：循环项 -> title（即 item.title）。
    • 点击摘要文本组件，在内容配置中，绑定数据源：循环项 -> summary（即 item.summary）。

在“循环数据”中，选择刚刚创建的数组变量 newsList。此时画布会按数组长度（3条）循环生成对应的卡片项。

在这里插入图片描述

完成绑定后，画布将根据模拟数据动态显示3条新闻卡片预览。

在这里插入图片描述

🦋第4步：保存模板并发布卡片

点击右上角“发布”按钮。填写版本信息，可选择生成封面，最后确认发布。只有发布后的卡片才能被插件或工作流调用。

在这里插入图片描述

点击顶部“保存为模板”，为卡片模板命名（如“头条热榜卡片”），方便后续复用。

在这里插入图片描述

🦋第5步：在智能体中集成卡片

  1. 创建智能体：新建一个智能体，命名为“头条新闻-卡片演示”。
  2. 绑定卡片：
    • 在弹出窗口中，选择“我的卡片”，找到并选中已发布的“头条热榜卡片”。
  3. 测试效果：
    • 在右侧“预览与调试”区域，输入“查询头条新闻”。
    • 智能体将调用插件获取真实新闻数据，并自动套用卡片模板进行渲染。

最终，用户将收到一个以美观的卡片列表形式呈现的最新新闻，效果如图3-54所示，体验远胜于纯文本回复。

在这里插入图片描述

关键步骤：将卡片中各个组件的数据源，与插件返回的实际API字段进行映射绑定。例如，将卡片的 item.image 绑定到插件返回数据中的 image_url 字段，将 item.title 绑定到 title 字段等。

在这里插入图片描述

在该插件的配置区域，找到并点击“绑定卡片数据”按钮。

在这里插入图片描述

添加插件：在智能体编排页面的“技能”区域，添加“头条新闻”官方插件，并选择 getToutiaoNews 这个工具。

在这里插入图片描述

总结：本案例完整展示了消息卡片从设计、制作、数据绑定到最终集成的全流程。掌握卡片功能，能极大提升你所开发的智能体或AI应用的专业度和用户体验。

Read more

Neo4j 知识讲解与在线工具使用教程

图数据库领域的核心工具 ——Neo4j，同时详细拆解其在线预览控制台（https://console-preview.neo4j.io/）的使用方法，以及查询工具（https://console-preview.neo4j.io/tools/query）的模块功能。 一、Neo4j 核心知识铺垫 在使用工具前，我们需要先理解 Neo4j 的本质和核心概念，这是后续操作的基础。 1. 什么是 Neo4j？ Neo4j 是世界上最流行的原生图数据库（Native Graph Database），专门用于存储、查询和分析 “实体之间的关联关系”。它与我们熟悉的 MySQL 等关系型数据库的核心差异的是： * 关系型数据库（MySQL）：用 “表 + 行 + 外键” 间接表示关联，查询多表关联时需频繁 JOIN，效率低； * 图数据库（Neo4j）
从0到1打造RISC-V智能家居中控：硬件+固件+通信全链路实战

从0到1打造RISC-V智能家居中控：硬件+固件+通信全链路实战

👋 大家好，欢迎来到我的技术博客！ 📚 在这里，我会分享学习笔记、实战经验与技术思考，力求用简单的方式讲清楚复杂的问题。 🌱 无论你是刚入门的新手，还是正在进阶的开发者，希望你都能有所收获！ 文章目录 * 从0到1打造RISC-V智能家居中控：硬件+固件+通信全链路实战 🏠💡 * 为什么选择RISC-V？🤔 * 系统整体架构概览 🧩 * 第一步：硬件选型与电路搭建 🔌 * 主控芯片选择 * 外设连接 * 第二步：开发环境搭建 🛠️ * 安装步骤（以Ubuntu为例） * 第三步：裸机驱动开发（Bare Metal）⚡ * 示例1：DHT11温湿度读取（Bit-banging） * 示例2：BH1750光照传感器（I2C） * 第四步：引入FreeRTOS实现多任务调度 🔄 * 第五步：Wi-Fi连接与MQTT通信 ☁️📡 * 连接Wi-Fi * MQTT客户端（使用esp-mqtt库） * 第六步：BLE本地控制（无需Wi-Fi）📱
宇树机器人SDK2开发指南：从环境搭建到Demo测试

宇树机器人SDK2开发指南：从环境搭建到Demo测试

本文以宇树 G1 人形机器人为主线，系统介绍 unitree_sdk2（C++）与 unitree_sdk2_python（Python）的完整开发流程，涵盖通信架构原理、环境搭建、依赖安装、Demo 编译运行、网络配置以及常见问题处理，适合具身智能领域的初中级开发者快速上手。 目录 1. SDK2 概述与架构原理 2. 开发环境要求 3. 获取官方 SDK 包 4. 安装依赖与编译 5. 机器人与开发机网络配置 6. 调试并运行 Demo 7. Python SDK Demo 测试 8. 常见问题与解决方案 9. 总结 1. SDK2 概述与架构原理 1.

5步升级小米智能家居Home Assistant集成：从入门到精通完全指南

5步升级小米智能家居Home Assistant集成：从入门到精通完全指南 【免费下载链接】ha_xiaomi_homeXiaomi Home Integration for Home Assistant 项目地址: https://gitcode.com/GitHub_Trending/ha/ha_xiaomi_home 本文是一份全面的小米智能家居接入Home Assistant升级指南，将帮助你解决设备不响应、数据不同步等常见问题，掌握从v0.1到v0.4.2版本的核心变化与部署技巧，实现智能家居系统的高效稳定运行。 一、版本升级核心价值与准备工作 为什么需要升级？ 升级小米智能家居Home Assistant集成组件不仅能获得100+设备兼容性修复，还能体验20+新增核心功能。特别是v0.4.0版本引入的本地控制架构，将设备响应延迟从300-500ms降至50-150ms，极大提升用户体验。 升级前检查清单 在开始升级前，请确认以下事项： * 已备份custom_components/xiaomi_