总结 · Cloudflare Realtime docs

RealtimeKit 根据转录数据生成 AI 驱动的会议总结。

开启总结

在创建会议时设置 summarize_on_end: true。对于会后总结，还需要设置 transcribe_on_end: true，以便 RealtimeKit 在转录文本可用后自动生成总结：

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/meetings" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Product Review",
    "transcribe_on_end": true,
    "summarize_on_end": true,
    "ai_config": {
      "transcription": {
        "language": "en-US"
      },
      "summarization": {
        "word_limit": 500,
        "text_format": "markdown",
        "summary_type": "team_meeting"
      }
    }
  }'

配置

选项	类型	默认值	描述
`word_limit`	number	500	总结长度（150-1000 个单词）
`text_format`	string	`markdown`	输出格式：`plain_text` 或 `markdown`
`summary_type`	string	`general`	用于定制总结的会议上下文

总结类型

选择与您的会议相匹配的类型以获得更好的效果：

类型	最适合
`general`	任何会议（默认）
`team_meeting`	定期团队同步
`daily_standup`	敏捷站会
`one_on_one_meeting`	1:1 会议
`sales_call`	客户销售对话
`client_check_in`	客户状态更新
`interview`	工作面试
`lecture`	教育内容
`code_review`	技术代码审查

获取总结

Webhook

在 RealtimeKit Webhook 中配置 meeting.summary 事件，以便在总结准备就绪时接收总结下载 URL：

{
	"event": "meeting.summary",
	"meeting": {
		"id": "bbb8940e-1b97-402a-97d6-2708b7feca41",
		"sessionId": "05e57591-d89e-45c9-ae44-08dc1eaad0e0",
		"organizedBy": {
			"id": "c94c437b-592a-4a39-b9e2-47ef1451e43b",
			"name": "Example organization"
		}
	},
	"summaryDownloadUrl": "https://example.com/summary.txt",
	"summaryDownloadUrlExpiry": "2026-06-10T10:30:00.000Z"
}

REST API

获取总结

请参阅获取会话的转录总结。

curl -X GET "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/sessions/$SESSION_ID/summary" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

手动触发

如果未设置 summarize_on_end 并且您想在转录文本可用后手动生成总结，请使用生成会话的转录总结 API。

curl -X POST "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/sessions/$SESSION_ID/summary" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

示例输出

使用 text_format: "markdown" 和 summary_type: "team_meeting"：

## Meeting Summary

### Key Discussion Points

- Reviewed Q4 roadmap priorities
- Discussed deployment timeline for v2.0
- Identified blockers for the auth migration

### Action Items

- @alice: Update design specs by Friday
- @bob: Schedule security review
- @charlie: Create migration runbook

### Decisions Made

- Approved moving forward with Kubernetes migration
- Delayed analytics dashboard to next sprint

保留期限

总结在会议结束后保留 7 天。