agent-foundation README

项目的 README,来自 github.com/converge-ai-labs/agent-foundation。合并为一个 markdown 文件:README.md。

Agent Foundation (a13n)

CI Documentation Python License Slack

Build, run, and manage AI agents at scale on your own infrastructure.

a13n Service is an open-source runtime for managing and running agents. Use Console, its web interface, to configure an agent, try it in a conversation, and debug its tool calls. Your application can then call that same agent through the HTTP API or a Python, TypeScript, Go, or Rust SDK. Service handles execution and recovery for those requests.

Choose your providers for models, sandboxes, web search, and memory. Bring your own keys.

Console and application clients connect to the Service API. Workers lease runs from PostgreSQL, execute them with Harness, and save checkpoints to object storage. After lease expiry, another attempt can resume from a saved checkpoint. Harness UI and Python apps can embed Harness directly.

Run Service

Console showing six managed agents, their model providers, and status

Console with fictional demo data. See run details from a scripted demo and workspace usage.

Quickstart with Docker Compose

Install Docker and Docker Compose, then run:

mkdir a13n-service && cd a13n-service
curl -fL https://raw.githubusercontent.com/converge-ai-labs/agent-foundation/main/deploy/docker/compose/a13n-service.yaml -o a13n-service.yaml
docker compose -f a13n-service.yaml up -d --wait --pull always

Open http://127.0.0.1:8080:

  1. Create your administrator account.
  2. In Models, select Add model and configure a model using an API key or an eligible ChatGPT subscription.
  3. Create an agent with that model and select Try agent to send it a message.
  4. Open Connect to app on the same agent to get its ID, Service URL, and an API key.

Call the agent from your application through the HTTP API or a Python, TypeScript, Go, or Rust SDK.

The stack runs Service, Console, PostgreSQL, and Redis. Agent environments use your host Docker Engine. See the Compose guide for configuration.

Production on Kubernetes

Deploy to Kubernetes with our Helm chart. Configure API and worker replicas and shared storage for high availability.

Providers and integrations

Bring your own stack. Self-host a13n with your choice of models, environments, web data providers, and app connections.

Models · Sandboxes · Web search · Memory · App connections

Use Harness directly

Service is built on Harness, which handles tool use, Skills, memory, and subagents. You can also use it without deploying Service:

Benchmarks: Harness scored 58.06% on 62 Terminal-Bench 4.0 tasks, compared with 58.77% in published Codex results using the same model and reasoning effort. See the methodology and FrontierHarness evaluation.

Documentation

These guides track main. For an installed release, use its release notes and package metadata.

Ask questions on Slack or open an issue for bugs and feature requests. Read CONTRIBUTING.md before submitting changes.

You can self-host a13n under the Apache 2.0 license. See SECURITY.md to report a vulnerability.

agent-foundation (converge-ai-labs/agent-foundation)

正在搜索数据库…

这是什么?a13n 是一个开源运行时,用于在你自己的基础设施上构建、运行和管理 AI 智能体。你的应用可以通过 HTTP 或 Python、TypeScript、Go、Rust 的 SDK 调用智能体,服务会负责执行和故障恢复。
它是我需要编写代码去调用的框架,还是现成的服务?它是一个自托管服务,带有用于配置智能体的网页版 Console。它基于 Harness 构建,你也可以在自己的 Python 代码中嵌入 Harness,无需部署该服务。
怎么把它跑起来?安装 Docker 和 Docker Compose,然后按照 Quickstart 操作:创建管理员账户,添加模型(使用 API 密钥,或符合条件的 ChatGPT 订阅),创建智能体,并在 Console 中试用。Helm chart 支持 Kubernetes 部署。
我首先需要准备什么?快速开始需要 Docker 和 Docker Compose,外加模型提供商的 API 密钥或符合条件的 ChatGPT 订阅。整套环境运行 Service、Console、PostgreSQL 和 Redis,智能体的运行环境则使用你主机上的 Docker Engine。
智能体是由我托管,还是由厂商托管?由你托管。它运行在你自己的基础设施上,模型、沙箱、网页搜索和记忆所用的密钥也都由你自己提供。
我可以免费自托管吗?可以。它是基于 Apache 2.0 许可证的开源软件,因此你可以自行部署。你的成本只包括自有基础设施和模型提供商的费用。
工作进程在运行中途崩溃会怎样?工作进程故障后,中断的运行会从已保存的检查点继续;即使客户端断开连接,智能体也会继续工作。
Harness 与 Codex 相比如何?在 62 项 Terminal-Bench 4.0 任务中,Harness 的得分为 58.06%,而在相同模型和推理强度下,Codex 公布的结果为 58.77%,两者大致相当。
如何为整个团队部署?Helm chart 可以在 Kubernetes 上部署,支持配置 API 和工作进程的副本数,并提供共享存储以实现高可用。
大小
73.9 MB
星标
1.4K
时长
3个月
提交 · 90 天