开始使用

公司即代码。面向智能体的后端框架和服务器。

工作区由一个 git 仓库支撑。其中每个智能体都是自定义的 pi 智能体:pi 是一个极简的开源运行框架,你可以用 pi 扩展来扩展它。kortix.yaml 声明智能体、连接器、触发器和规则。OpenChatly 将它们部署到云端,并在独立的计算机上运行每个会话。使用 @kortix/sdk 和 @kortix/ui 构建自己的体验。

免费开始阅读 kortix.yaml 参考

每个智能体对应一个代码块。它只能获取该代码块中列出的工具、连接器和技能,无法访问任何额外资源。

arcadia / kortix.yaml
  1. 56 # Engineering
  2. 57 eng-triage:
  3. 58 description: Triages every new GitHub issue.
  4. 59 prompt_file: agents/engineering/triage.md
  5. 60 tools: [read, grep, glob, web_search]
  6. 61 connectors: [github, kortix_slack]
  7. 62 skills: [triage-issue]
  8. 63 extensions: [triage-policy]
自定义 · 智能体

eng-triage

对每个新的 GitHub issue 进行分诊。

Tools
  • read
  • grep
  • glob
  • web_search
Connectors
  • github
  • kortix_slack
Skills
  • triage-issue
Extensions
  • 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 都不会再次显示已存储的密钥明文值。

真正拥有你自己的 AI即刻在云端开启体验

免费开始

OpenChatly 是全场景 AI 工作台。一人指挥,智能体执行,从目标到成品一站完成。

©2026 OpenChatly AI.沪ICP备2025124785号-5

资源指引

  • 产品介绍
  • 技能市场

服务条款

  • 用户协议
  • 隐私协议

联系我们