CreateBot¶

创建一个具有名称、稳定句柄和可选资料的机器人。省略 teamId 可创建由当前用户拥有的机器人；提供 teamId 可创建归属于团队的机器人，这需要团队管理员或所有者权限。当机器人需要立即向某个频道发布消息时，传入 channelId：当前用户必须是该频道的成员。响应随后将包含该频道的 webhook URL 和一份凭据提案。用户可从聊天卡片或机器人设置中铸造 bearer token；该机密绝不会在此工具结果中返回。省略 channelId 则仅创建机器人，之后可使用 ManageBotChannelAccess 和 IssueBotCredential 进行后续设置。

参数¶

参数	类型	必填	说明
`teamId`	string	否	应拥有该机器人的团队 ID。省略此参数可创建由当前用户拥有的机器人。
`name`	string	是	人类可读的机器人显示名称。
`handle`	string	是	稳定的提及句柄，仅使用小写 ASCII 字母、数字、连字符和下划线；最多 64 个字符。
`description`	string	否	机器人功能的可选简短描述。
`avatarUrl`	string	否	机器人头像的可选 URL。传入已上传到 Macro 静态文件的图片 URL，或其他可访问的图片 URL。
`channelId`	string	否	要授予新机器人访问权限的频道 ID。需要当前用户为该频道成员。设置后，工具还会返回频道 webhook URL 和一份用户可从聊天卡片铸造的凭据提案。
`credentialLabel`	string	否	当设置 channelId 时，用户将铸造的凭据的可选标签，例如 `github-webhook`。需要 channelId。
`credentialExpiresAt`	string	否	当设置 channelId 时，用户将铸造的凭据的可选 RFC 3339 过期时间。需要 channelId。
`hasAgent`	boolean	否	如果提及此机器人应打开一个沙箱化的编码智能体会话，则设置为 true。默认为 false。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 macro3/macro