工具仓库

概览

Tool Repository 是 CrewAI 工具的包管理器。它允许用户发布、安装和管理与 CrewAI crews 和 flows 集成的工具。

工具可以是：

私有：仅组织内部可访问（默认）
公开：如果使用 --public 标志发布，则所有 CrewAI 用户都可以访问

该仓库不是版本控制系统。请使用 Git 跟踪代码变更并支持协作。

前提条件

在使用 Tool Repository 之前，请确保你拥有：

一个 CrewAI AMP 账号
已安装 CrewAI CLI
已安装 uv>=0.5.0。查看如何升级
已安装并配置好 Git
具备在 CrewAI AMP 组织中发布或安装工具的访问权限

安装工具

要安装一个工具：

crewai tool install <tool-name>

这会安装该工具并将其添加到 pyproject.toml。

你可以导入并将其添加到智能体中来使用该工具：

from your_tool.tool import YourTool

custom_tool = YourTool()

researcher = Agent(
    role='Market Research Analyst',
    goal='Provide up-to-date market analysis of the AI industry',
    backstory='An expert analyst with a keen eye for market trends.',
    tools=[custom_tool],
    verbose=True
)

安装工具后添加其他包

在从 CrewAI AMP Tool Repository 安装工具之后，你需要使用 crewai uv 命令向项目中添加其他包。直接使用 uv 命令会失败，因为工具仓库的认证由 CLI 处理。通过使用 crewai uv 命令，你可以在无需担心通过环境变量或其他方式管理认证的情况下，为项目添加其他包。任何 uv 命令都可以与 crewai uv 命令一起使用，这使它成为一个强大的工具，可在无需管理认证复杂性的情况下管理项目依赖。

假设你从 CrewAI AMP Tool Repository 安装了一个名为 “my-tool” 的自定义工具：

crewai tool install my-tool

现在你想向项目添加另一个包，可以使用以下命令：

crewai uv add requests

crewai uv 还可以用于其他命令，例如 uv sync 或 uv remove：

crewai uv sync

crewai uv remove requests

这会将包添加到项目中，并相应更新 pyproject.toml。

创建和发布工具

要创建新的工具项目：

crewai tool create <tool-name>

这会在本地生成一个脚手架化的工具项目。

完成修改后，初始化 Git 仓库并提交代码：

git init
git add .
git commit -m "Initial version"

要发布工具：

crewai tool publish

默认情况下，工具会作为私有工具发布。要将工具公开：

crewai tool publish --public

如需了解如何构建工具的更多细节，请参阅创建你自己的工具。

更新工具

要更新已发布的工具：

在本地修改工具
更新 pyproject.toml 中的版本号（例如从 0.1.0 改为 0.1.1）
提交更改并重新发布

git commit -m "Update version to 0.1.1"
crewai tool publish

删除工具

要删除工具：

前往 CrewAI AMP
导航到 Tools
选择该工具
点击 Delete

安全检查

每个已发布版本都会经过自动化安全检查，并且只有在通过后才可供安装。

你可以在以下位置查看工具的安全检查状态：

CrewAI AMP > Tools > Your Tool > Versions

需要帮助？

如需 API 集成或故障排查方面的帮助，请联系我们的支持团队。