

锐英源软件原创内容,禁止转载和任何形式的非法内容使用,违者必究
📑 本文目录
导入日历功能添加到个人Agent平台开发,编写成组件被个人Agent平台调用,安卓系统,虚拟机里测试,比较麻烦。

小满的`calendar_insert` 工具让模型能把展会、会议、提醒直接写入手机系统日历。本文从实现角度拆解两个 Kotlin 文件:接口层`core-api/CalendarWriter.kt` 定义了什么契约、为什么要做成接口;实现层`app/AndroidCalendarWriter.kt` 如何用 Android`CalendarContract` API 完成写入。我们还会讲到:工具定义在`AgentTools.kt` 的 schema 约束、`ChatTools.kt` 如何解析模型传来的 JSON 参数、以及日历写入的权限声明。最后展示一个真实的工具调用轨迹 — 豆包模型返回`{"title":"2026全球人工智能开发者大会","begin":"2026-11-20","location":"深圳"}` → ChatLoop 解析 →`calendarInsert()` 写入 → 返回成功摘要。
- 为什么是接口 —`CalendarWriter` 在`core-api` 里只是一个接口(`suspend fun insertEvent(...)` ),不依赖 Android。这样`ios-runner` 可以有 iOS 实现,Web 版本可以 mock。
- `AgentTools.kt` 的工具 schema
- `CALENDAR_INSERT = "calendar_insert"`
- 必填参数:`title` 、`begin`
- 可选参数:`end` 、`location` 、`description`
- schema 用 JSON Schema 格式(ToolSpec 内部构建)
`AndroidCalendarWriter.kt` 实现
- 用`ContentResolver.insert()` 写`CalendarContract.Events.CONTENT_URI`
- 需要`WRITE_CALENDAR` 权限(已在 AndroidManifest 声明 + 运行时申请)
- begin/end 解析:支持日期`"2026-11-20"` → 全天,支持 ISO`"2026-11-20T09:30"` → 具体时间
- 失败时返回错误信息(Calendar 返回 null URI、权限拒绝、解析失败)
`ChatTools.kt` 的桥接
- `when(toolName) { CALENDAR_INSERT -> calendarInsert(args) }`
- 模型返回的 JSON args →`JsonObject` → 参数提取 →`CalendarWriter.insertEvent()`
- 返回字符串给模型(写入成功/失败摘要)
运行时调用轨迹
豆包模型(带 web_search_options)
→ 搜索 "2026年11月AI展会"
→ 搜索结果 + 调 calendar_insert 工具
→ args = {title, begin, location, description}
→ AndroidCalendarWriter.insertEvent()
→ ContentResolver.insert(Events.CONTENT_URI, values)
→ 返回 "已写入:2026全球AI开发者大会"
→ 模型总结给用户
坑和修复
- minSdk 30 才能用的 CalendarContract 新字段(`ALL_DAY` 行为变化)
- 时区问题:begin 解析时假设为设备本地时区
- 权限:Android 13+ 需要 POST_NOTIFICATIONS(提醒用),Android 10 之前需要 WRITE_CALENDAR
// CalendarWriter.kt(接口)
interface CalendarWriter {
suspend fun insertEvent(
title: String,
begin: String,
end: String? = null,
location: String? = null,
description: String? = null,
): String
}
// AgentTools.kt(定义)
CALENDAR_INSERT,
"把一条日程写入手机系统日历(飞书开启本地日历导入后可见)",
schema(listOf("title", "begin"), ...)
// AndroidCalendarWriter.kt(实现)
override suspend fun insertEvent(...): String {
val cr = context.contentResolver
val values = ContentValues().apply {
put(Events.TITLE, title)
put(Events.EVENT_TIMEZONE, TimeZone.getDefault().id)
// ... begin/end 解析
}
val uri = cr.insert(Events.CONTENT_URI, values)
return if (uri != null) "已写入..." else "写入失败..."
}
本文是系列文章的第三章,全部文章在锐英源软件网站和“AI技术与原创内容出品”微信公众号上公布。