公司即代码。面向智能体的后端框架和服务器。
工作区由一个 git 仓库支撑。其中每个智能体都是自定义的 pi 智能体:pi 是一个极简的开源运行框架,你可以用 pi 扩展来扩展它。kortix.yaml 声明智能体、连接器、触发器和规则。OpenChatly 将它们部署到云端,并在独立的计算机上运行每个会话。使用 @kortix/sdk 和 @kortix/ui 构建自己的体验。
每个智能体对应一个代码块。它只能获取该代码块中列出的工具、连接器和技能,无法访问任何额外资源。
- # Engineering
- eng-triage:
- description: Triages every new GitHub issue.
- prompt_file: agents/engineering/triage.md
- tools: [read, grep, glob, web_search]
- connectors: [github, kortix_slack]
- skills: [triage-issue]
- extensions: [triage-policy]
eng-triage
对每个新的 GitHub issue 进行分诊。
- read
- grep
- glob
- web_search
- github
- kortix_slack
- triage-issue
- triage-policy
/workspace 中的仓库,位于其独立分支
一个仓库中的一个文件。 OpenChatly 仅运行其声明的内容。
四个想法。 整个框架,分为四大部分。
项目即 Git 仓库你的公司,可版本化管理。
- 由 OpenChatly 托管,或关联 GitHub
- 智能体、技能与记忆皆为文件
- 每次改动即一次提交
由 kortix.yaml 进行声明单一配置文件,运行前必须经过检查。
- 智能体、连接器、触发器、规则
- 访问权限默认拒绝
- kortix validate 在 ship 和合并时运行
自定义 pi 智能体极简运行框架,一键部署至云端。
- pi:开源智能体运行框架
- pi 扩展(来自 npm 或代码仓库)
- 每次会话独享一台计算机与一个分支
自定义交互体验同一套后端,源自代码。
- @kortix/sdk:单一类型化客户端
- @kortix/ui:网页应用组件库
- CLI 命令行工具与 REST API
工作原理。逐一拆解各部分。
智能体
一个智能体由 kortix.yaml 中的一个代码块和一段 Markdown 提示词组成。该代码块指定了其使用的模型、工具、连接器和技能。
访问权限默认拒绝。代码块中未列出的连接器、密钥或技能,智能体一概无法获取。
kortix.yaml
# Marketing marketing: description: Drafts LinkedIn posts from shipped work. prompt_file: agents/marketing/content.md tools: [read, web_search] connectors: [linkedin, kortix_slack] skills: [write-post] commands: [draft-post] extensions: [web-access]agents/marketing/content.md
You write Arcadia LinkedIn posts from work the team shipped.Follow the write-post skill and the tone in the company memory.Every post waits for a person to approve it.架构。 统一 API。每次会话独享一台计算机。
客户端
人类与代码以相同的方式接入 OpenChatly。
- 网页应用
- 桌面端
- 移动端
- CLI
- Slack
- Microsoft Teams
- 你的应用
OpenChatly API
负责决定谁可以运行哪个智能体、启动会话,并保管连接器登录凭证与变更请求。
Workspace repository
包含 kortix.yaml、智能体、技能和记忆。可由 OpenChatly 托管,也可关联你的 GitHub 仓库。
会话计算机
每次会话一个。你的 pi 智能体及其扩展将在此处、在该会话专属的分支上运行。
LLM 网关
处理每一次模型调用。支持使用 OpenChatly 托管的模型,也可使用你的专属密钥。
OpenChatly Drive
共享文件夹与公司记忆,挂载于 /drives 路径。
框架问题。Answered from the docs.
如果还有其他问题, 可以联系团队.
我必须手写 YAML 吗?
不用。你可以在网页应用的“自定义(Customize)”模块中管理智能体、连接器和触发器;也可以在聊天中使用 Create 指令,让 AI 协助你新建智能体。所有这些修改都会同步写入同一个 kortix.yaml 文件中。
我可以将仓库托管在 GitHub 或 Gitee 上吗?
可以。如果配置了 GitHub 或 Gitee 远端,kortix ship 会关联该仓库,且常规的 git push 和 git pull 均可正常使用。若未配置,OpenChatly 会自动创建并托管该仓库。
kortix validate 命令会检查什么?
它会先根据 Schema 校验每个键值,再校验其关联的文件:例如不存在的提示词文件、缺少 SKILL.md 的技能目录,以及文件中未声明的连接器或密钥名称。若发现错误,命令将以退出码 1 终止。kortix ship 也会执行相同的检查,如果 kortix.yaml 无效,合并请求将被拒绝。
kortix.yaml 的改动何时生效?
当改动通过合并或推送落到基础分支时即刻生效。新会话会直接应用最新配置;正在运行的会话则会在下一轮对话开始时加载新配置。
会话内部运行着什么?
pi 是一个极简的开源智能体运行框架。你声明的每个智能体都是 pi 智能体,每次新会话都会在其专属的云端计算机上运行。它仅通过 OpenChatly LLM 网关来调用模型。
我可以扩展智能体运行框架吗?
可以。你可以用 TypeScript 编写 pi 扩展,或从 npm 引入指定的 pi 包,然后在 kortix.yaml 的 extensions 字段下进行注册。每个智能体只会加载其声明的扩展。扩展不仅可以添加工具(例如将你自己的策略转化为代码),还能对事件做出响应(例如在每次工具调用前执行检查)。
敏感密钥值存储在哪里?
存储在 OpenChatly 中,且经过加密处理。kortix.yaml 仅列出项目所需的密钥名称。任何页面、命令或 API 都不会再次显示已存储的密钥明文值。