内容
# 代理基础
由 Agent Foundry 团队提供的基线启动仓库。团队将此仓库 fork 到自己的环境中，并为其用例进行定制。共享基础设施（依赖注入、生命周期、中间件、重试、OpenTelemetry、工具加载）位于已发布的 `foundry-agent-*` 包中 — 此仓库是合成根，将它们连接到可运行的服务中。
## 安装 `foundry-*` 包
此仓库依赖的四个 `foundry-agent-*` 包作为资产发布在 [`boozallen/foundry-agent-packages`](https://github.com/boozallen/foundry-agent-packages) GitHub Releases 上。默认的 `pyproject.toml` 将每个包固定到其 GitHub Release 轮子 URL，因此新的克隆可以直接运行 — 对于评估、演示和概念验证非常有用。
**预期采用模式：** 将轮子镜像到您自己的内部包索引（Artifactory、AWS CodeArtifact、Sonatype Nexus、GitLab Package Registry等），并在 `pyproject.toml` 中重新定位依赖规范到该索引。直接依赖 `github.com` 发布 URL 适合进行初步测试，但生产部署应从您控制的基础设施中解析包。
## 下一步
| 如果您想… | 阅读 |
|---|---|
| 在本地使用 Python 和 `uv` 运行代理 | [快速入门（本地 Python）](docs/foundry/quickstart.md) |
| 在容器中运行代理 | [快速入门（Docker Compose）](docs/foundry/quickstart-docker.md) |
| 了解代码库（文件布局、包、扩展点） | [AGENTS.md](AGENTS.md) |
| 配置模型、系统、MCP 服务器、A2A 对等节点 | [配置指南](docs/foundry/configuration/index.md) |
| 添加工具、API 端点、防护措施或自定义服务器 | [指南](docs/foundry/guides/index.md) — 从 [您 fork 之后](docs/foundry/guides/after-you-fork.md) 开始 |
| 了解安全状况和 STIG 检查清单 | [security/README.md](security/README.md) |
| 贡献更改 | [CONTRIBUTING.md](CONTRIBUTING.md) |
MCP 市场