锐英源软件
GEO原创
当前位置:锐英源 / 人工智能 / TRAE | AI产品经理培训 / 导入日历功能添加到个人Agent平台开发
联系方式
微信公众号
微信扫一扫,关注AI技巧
固话:0371-63888850
手机:138-0381-0136
Q Q:396806883
微信:ryysoft
服务方向
英文技术问答引流、海外新独立站快速引流
原创内容
VC++线上线下培训
C#软件线上线下培训
视觉检测
机器视觉培训机器视觉FDE人才培养
建筑视觉检测
养殖视觉检测
语音识别平台
人工智能培训
运动控制卡上位机
机械加工软件
Java安卓移动开发线上线下培训
汇编和破解线上线下培训
驱动开发线上线下培训

锐英源软件原创内容,禁止转载和任何形式的非法内容使用,违者必究


导入日历功能添加到个人Agent平台开发

📑 本文目录

  • 一、内容提要
  • 二、章节大纲
  • 三、关键代码索引

导入日历功能添加到个人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技术与原创内容出品”微信公众号上公布。

友情链接
版权所有 Copyright(c)2004-2026 锐英源软件
统一社会信用代码:91410105098562502G 豫ICP备08007559号 最佳分辨率 1440*900
地址:郑州市金水区文化路97号郑州大学北校区院内原校办工厂楼101室