# 确认与发布工作流方案

对接工作流编辑器的应用在用户审阅通过后，可确认采用服务端保存的候选方案，并将其发布为可运行的工作流。

(sdk-ai-studio-workflow-proposal-flow)=
## 任务流程

确认调用使用同一方案的任务 ID、产物 ID 与提案 ID 生成已接受记录；发布调用将该接受记录部署为工作流并返回工作流 ID。

```text
任务 ID + 候选产物 ID + 确认提案 ID + 幂等键
                      │
                      ▼
               确认采用候选方案
                      │
                      ▼
                已接受方案记录
                      │
                      ▼
          发布工作流并取得工作流 ID
```

(sdk-ai-studio-workflow-proposal-prepare)=
## 准备

1. 已完成 [使用 SDK](../../../quickstart/ai-studio/sdk.md) 中的服务地址、个人访问令牌与工作区配置。
2. **待确认方案引用**（`TASK_ID`、`ARTIFACT_ID`、`PROPOSAL_ID`）：从同一工作流生成任务或历史恢复结果中保存该方案的任务 ID、候选产物 ID 和确认提案 ID（前置流程见 [测试与提交工作流项目](测试并提交工作流项目.md#sdk-ai-studio-workflow-project-submit) 或 [查看与恢复工作流历史](查看和恢复工作流历史.md#sdk-ai-studio-workflow-history-list)），确认前先核对该方案的编译与测试结果。
3. **确认幂等键**（`ACCEPT_KEY`）：为本次确认操作生成并保存唯一幂等标识；网络结果未明时继续复用原幂等键重试。

(sdk-ai-studio-workflow-proposal-publish)=
## 确认并发布方案

使用服务端保存的方案引用与确认信息接受候选并提交发布。发布前先核对原生成任务绑定的目标工作流：若方案已绑定已有工作流，即使发布调用中的工作流 ID 参数留空，服务端仍会更新该绑定工作流；若显式传入工作流 ID，其值必须与绑定目标一致。未绑定已有工作流的方案在工作流 ID 留空时执行首次发布（或重放同一次发布）。

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

```python
import os
import moi_product_sdk as sdk

client = sdk.new_with_personal_access_token(
    os.environ["PRODUCT_API_BASE_URL"], os.environ["PRODUCT_API_KEY"]
)
workspace = client.workspace(os.environ["WORKSPACE_ID"])
accepted = workspace.accept_workflow_candidate(
    sdk.WorkflowCandidateRef(
        task_id=os.environ["TASK_ID"], artifact_id=os.environ["ARTIFACT_ID"]
    ),
    sdk.WorkflowCandidateConfirmation(
        proposal_id=os.environ["PROPOSAL_ID"], idempotency_key=os.environ["ACCEPT_KEY"]
    ),
)
workflow, deployment = workspace.deploy_workflow_candidate(
    "Document processing", accepted, "",
    sdk.with_workflow_execution_mode("one_shot"),
)
print("Workflow:", workflow.id)
print("Warnings:", deployment.warnings)
```

::::

::::{tab-item} Go
:sync: go

```go
package main

import (
	"context"
	"fmt"
	"os"

	sdk "github.com/matrixorigin/matrixflow/sdk/go-sdk"
)

func main() {
	ctx := context.Background()
	client, err := sdk.NewWithPersonalAccessToken(
		os.Getenv("PRODUCT_API_BASE_URL"),
		os.Getenv("PRODUCT_API_KEY"),
	)
	if err != nil {
		panic(err)
	}
	workspace, err := client.Workspace(os.Getenv("WORKSPACE_ID"))
	if err != nil {
		panic(err)
	}
	ref := sdk.WorkflowCandidateRef{
		TaskID:     os.Getenv("TASK_ID"),
		ArtifactID: os.Getenv("ARTIFACT_ID"),
	}
	confirmation := &sdk.WorkflowCandidateConfirmation{
		ProposalId:     os.Getenv("PROPOSAL_ID"),
		IdempotencyKey: os.Getenv("ACCEPT_KEY"),
	}
	accepted, err := workspace.AcceptWorkflowCandidate(ctx, ref, confirmation)
	if err != nil {
		panic(err)
	}
	workflow, deployment, err := workspace.DeployWorkflowCandidate(
		ctx,
		"Document processing",
		accepted,
		"",
		sdk.WithWorkflowExecutionMode("one_shot"),
	)
	if err != nil {
		panic(err)
	}
	fmt.Println("Workflow:", workflow.ID())
	fmt.Println("Warnings:", deployment.GetWarnings())
}
```

::::

:::::

完整保留服务端返回的接受记录并原样传入发布调用；服务端在发布时会重新解析其中的方案引用及绑定目标。若发布阶段失败，保留已取得的接受记录，修正发布配置后重新调用发布接口，随后保存返回的工作流 ID。

(sdk-ai-studio-workflow-proposal-next)=
## 下一步

- [运行并跟踪工作流](运行并跟踪工作流.md#sdk-ai-studio-workflow-run-start)
- [查看与恢复工作流历史](查看和恢复工作流历史.md#sdk-ai-studio-workflow-history-list)
