> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bitbucket

> Bitbucket 可帮助你通过已连接的账户在仓库、分支、拉取请求和问题中托管代码、查看变更并跟踪工作。

# Bitbucket

当你的工作流程需要仓库、分支、拉取请求或问题数据时，请使用 Bitbucket。它可以读取并更新你已连接工作区中的代码审查和跟踪工作。

## 配置

| 选项 | 是否必需 | 描述 |
| - | - | - |
| Name | 否 | 工作流画布中该步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Bitbucket 账户。 |
| Action | 是 | 要执行的 Bitbucket 操作（例如 Get repository、List repositories、Create repository、List branches）。 |
| Arguments | 是 | 由操作的 schema 生成的逐操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，可用于注入 `{{placeholder}}` 值。高级用法还可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请通过登录流程在你的工作区的 **Integrations** 中连接 Bitbucket。如果没有可用的活动连接，该步骤会显示一条警告，并提供指向 **Integrations** 的链接，而不是账户选择器。

## Arguments form

当你选择一个操作时，**Arguments** 部分会根据该操作的输入 schema 显示一个表单。引用现有记录的字段包含下拉选择器。

如果你更愿意手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## Common actions

| Action | 描述 |
| - | - |
| **Get repository** | 检索工作区中某个仓库的详情。 |
| **List repositories** | 列出工作区中可用的仓库。 |
| **Create repository** | 在工作区中创建一个新仓库。 |
| **List branches** | 列出仓库中的分支。 |
| **Get branch** | 检索某个特定分支的详情。 |
| **Create branch** | 从目标提交创建一个新分支。 |
| **List commits** | 列出仓库中的提交。 |
| **Get commit** | 检索某个特定提交的详情。 |
| **Get commit diff** | 检索某个提交或修订范围的差异。 |
| **List pull requests** | 列出仓库中的拉取请求。 |
| **Get pull request** | 检索某个特定拉取请求的详情。 |
| **Create pull request** | 从源分支创建一个拉取请求。 |
| **Approve pull request** | 以当前用户身份批准一个拉取请求。 |
| **Update pull request** | 更新拉取请求的标题、描述或审阅者。 |
| **List issues** | 列出仓库中的问题。 |

诸如删除记录之类的破坏性操作在工作流操作选择器中不可用。

## 输出

此步骤会将 Bitbucket 响应存储为步骤输出。响应的结构取决于该操作。

在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做，请先连接 Bitbucket。
2. 将一个 **Bitbucket** 步骤添加到你的工作流中。
3. 在 **Authentication** 中选择一个已连接账户。
4. 在 **Action** 中选择 **Get repository**。
5. 填写必填字段。对任何字段值，使用 **Insert Variable** 引用前面某一步的输出。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的载荷。

## 使用场景

### 从分支发起评审

1. 列出分支
2. 获取分支
3. 创建拉取请求
4. 批准拉取请求

### 跟踪一个新缺陷

1. 列出问题
2. 创建问题
3. 更新问题

### 检查一次代码变更

1. 列出提交
2. 获取提交
3. 获取提交差异
4. 获取拉取请求

## 备注

* 此步骤依赖于你工作区中已连接的 Bitbucket 集成。
* 工作流操作选择器会显示一组经过筛选的操作。拥有 Bitbucket 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌信息。

## 将 Bitbucket 用作代理工具

你也可以在 **Agent Editor** 中将 Bitbucket 添加为工具。打开该代理，点击 **Add tool**，然后选择 **Bitbucket**。在工具设置面板中，选择代理应使用的已连接账户。代理会在相关于对话时调用 Bitbucket 操作。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.