# 查看工作流节点定义

列出工作区当前可用的工作流节点目录，取得目标节点 ID 与推荐版本，再读取该节点的完整输入输出配置定义。

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

1. 查询工作区节点目录，获取各节点的节点 ID、显示名称和推荐版本。
2. 根据要编排的数据处理动作选定目标节点 ID。
3. 按节点 ID 读取单节点配置定义，核对节点输入参数、输出字段与版本信息。

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

1. 已完成 [使用 SDK](../../../quickstart/ai-studio/sdk.md) 中的服务地址、个人访问令牌与工作区配置。

(sdk-ai-studio-workflow-nodes-s1)=
## 列出节点并读取定义

以下示例列出目录中的全部可用节点，输出节点 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"])
catalog = workspace.workflows().workitem_catalog()
for node in catalog.items:
    print(node.node_id, node.display_name, node.preferred_version)
if not catalog.items:
    raise SystemExit("No workflow nodes available")
node_id = catalog.items[0].node_id
detail = workspace.workflows().workitem_catalog_item(node_id)
print("Node definition:", detail.item)
```

::::

::::{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)
	}
	catalog, err := workspace.Workflows().WorkitemCatalog(ctx)
	if err != nil {
		panic(err)
	}
	for _, node := range catalog.GetItems() {
		fmt.Println(node.GetNodeId(), node.GetDisplayName(), node.GetPreferredVersion())
	}
	if len(catalog.GetItems()) == 0 {
		fmt.Println("No workflow nodes available")
		return
	}
	detail, err := workspace.Workflows().WorkitemCatalogItem(ctx, catalog.GetItems()[0].GetNodeId())
	if err != nil {
		panic(err)
	}
	fmt.Println("Node definition:", detail.GetItem())
}
```

::::

:::::

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

- [创建与发布工作流](创建工作流.md#sdk-ai-studio-workflow-deploy-submit)
- [管理自定义算子与模板](自定义算子和工作流模板.md#sdk-ai-studio-workflow-design-create-operator)
