feat: Support for Chat Flow & Agent Support for binding a single chat flow (#765)

Co-authored-by: Yu Yang <72337138+tomasyu985@users.noreply.github.com>
Co-authored-by: zengxiaohui <csu.zengxiaohui@gmail.com>
Co-authored-by: lijunwen.gigoo <lijunwen.gigoo@bytedance.com>
Co-authored-by: lvxinyu.1117 <lvxinyu.1117@bytedance.com>
Co-authored-by: liuyunchao.0510 <liuyunchao.0510@bytedance.com>
Co-authored-by: haozhenfei <37089575+haozhenfei@users.noreply.github.com>
Co-authored-by: July <jiangxujin@bytedance.com>
Co-authored-by: tecvan-fe <fanwenjie.fe@bytedance.com>

backend/domain/workflow/entity/vo/canvas.go

@@ -17,6 +17,8 @@
 package vo
 
 import (
+	"fmt"
+
 	model "github.com/coze-dev/coze-studio/backend/api/model/crossdomain/modelmgr"
 	"github.com/coze-dev/coze-studio/backend/api/model/workflow"
 	"github.com/coze-dev/coze-studio/backend/pkg/i18n"
@@ -108,7 +110,8 @@ type Data struct {
 type Inputs struct {
 	// InputParameters are the fields defined by user for this particular node.
 	InputParameters []*Param `json:"inputParameters"`
-
+	// ChatHistorySetting configures the chat history setting for this node in chatflow mode.
+	ChatHistorySetting *ChatHistorySetting `json:"chatHistorySetting,omitempty"`
 	// SettingOnError configures common error handling strategy for nodes.
 	// NOTE: enable in frontend node's form first.
 	SettingOnError *SettingOnError `json:"settingOnError,omitempty"`
@@ -432,9 +435,8 @@ type DatabaseInfo struct {
 }
 
 type IntentDetector struct {
-	ChatHistorySetting *ChatHistorySetting `json:"chatHistorySetting,omitempty"`
-	Intents            []*Intent           `json:"intents,omitempty"`
-	Mode               string              `json:"mode,omitempty"`
+	Intents []*Intent `json:"intents,omitempty"`
+	Mode    string    `json:"mode,omitempty"`
 }
 type ChatHistorySetting struct {
 	EnableChatHistory bool  `json:"enableChatHistory,omitempty"`
@@ -826,6 +828,133 @@ const defaultEnUSInitCanvasJsonSchema = `{
  }
 }`
 
+const defaultZhCNInitCanvasJsonSchemaChat = `{
+	"nodes": [{
+		"id": "100001",
+		"type": "1",
+		"meta": {
+			"position": {
+				"x": 0,
+				"y": 0
+			}
+		},
+		"data": {
+			"outputs": [{
+				"type": "string",
+				"name": "USER_INPUT",
+				"required": true
+			}, {
+				"type": "string",
+				"name": "CONVERSATION_NAME",
+				"required": false,
+				"description": "本次请求绑定的会话，会自动写入消息、会从该会话读对话历史。",
+				"defaultValue": "%s"
+			}],
+			"nodeMeta": {
+				"title": "开始",
+				"icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/dvsmryvd_avi_dvsm/ljhwZthlaukjlkulzlp/icon/icon-Start.png",
+				"description": "工作流的起始节点，用于设定启动工作流需要的信息",
+				"subTitle": ""
+			}
+		}
+	}, {
+		"id": "900001",
+		"type": "2",
+		"meta": {
+			"position": {
+				"x": 1000,
+				"y": 0
+			}
+		},
+		"data": {
+			"nodeMeta": {
+				"title": "结束",
+				"icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/dvsmryvd_avi_dvsm/ljhwZthlaukjlkulzlp/icon/icon-End.png",
+				"description": "工作流的最终节点，用于返回工作流运行后的结果信息",
+				"subTitle": ""
+			},
+			"inputs": {
+				"terminatePlan": "useAnswerContent",
+				"streamingOutput": true,
+				"inputParameters": [{
+					"name": "output",
+					"input": {
+						"type": "string",
+						"value": {
+							"type": "ref"
+						}
+					}
+				}]
+			}
+		}
+	}]
+}`
+const defaultEnUSInitCanvasJsonSchemaChat = `{
+	"nodes": [{
+		"id": "100001",
+		"type": "1",
+		"meta": {
+			"position": {
+				"x": 0,
+				"y": 0
+			}
+		},
+		"data": {
+			"outputs": [{
+				"type": "string",
+				"name": "USER_INPUT",
+				"required": true
+			}, {
+				"type": "string",
+				"name": "CONVERSATION_NAME",
+				"required": false,
+				"description": "The conversation bound to this request will automatically write messages and read conversation history from that conversation.",
+				"defaultValue": "%s"
+			}],
+			"nodeMeta": {
+				"title": "Start",
+				"icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/dvsmryvd_avi_dvsm/ljhwZthlaukjlkulzlp/icon/icon-Start.png",
+				"description": "The starting node of the workflow, used to set the information needed to initiate the workflow.",
+				"subTitle": ""
+			}
+		}
+	}, {
+		"id": "900001",
+		"type": "2",
+		"meta": {
+			"position": {
+				"x": 1000,
+				"y": 0
+			}
+		},
+		"data": {
+			"nodeMeta": {
+				"title": "End",
+				"icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/dvsmryvd_avi_dvsm/ljhwZthlaukjlkulzlp/icon/icon-End.png",
+				"description": "The final node of the workflow, used to return the result information after the workflow runs.",
+				"subTitle": ""
+			},
+			"inputs": {
+				"terminatePlan": "useAnswerContent",
+				"streamingOutput": true,
+				"inputParameters": [{
+					"name": "output",
+					"input": {
+						"type": "string",
+						"value": {
+							"type": "ref"
+						}
+					}
+				}]
+			}
+		}
+	}]
+}`
+
 func GetDefaultInitCanvasJsonSchema(locale i18n.Locale) string {
 	return ternary.IFElse(locale == i18n.LocaleEN, defaultEnUSInitCanvasJsonSchema, defaultZhCNInitCanvasJsonSchema)
 }
+
+func GetDefaultInitCanvasJsonSchemaChat(locale i18n.Locale, name string) string {
+	return ternary.IFElse(locale == i18n.LocaleEN, fmt.Sprintf(defaultEnUSInitCanvasJsonSchemaChat, name), fmt.Sprintf(defaultZhCNInitCanvasJsonSchemaChat, name))
+}

backend/domain/workflow/entity/vo/chat_flow_role.go

@@ -0,0 +1,48 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package vo
+
+type ChatFlowRoleCreate struct {
+	WorkflowID          int64
+	CreatorID           int64
+	Name                string
+	Description         string
+	AvatarUri           string
+	BackgroundImageInfo string
+	OnboardingInfo      string
+	SuggestReplyInfo    string
+	AudioConfig         string
+	UserInputConfig     string
+}
+
+type ChatFlowRoleUpdate struct {
+	WorkflowID          int64
+	Name                *string
+	Description         *string
+	AvatarUri           *string
+	BackgroundImageInfo *string
+	OnboardingInfo      *string
+	SuggestReplyInfo    *string
+	AudioConfig         *string
+	UserInputConfig     *string
+}
+
+type PublishRolePolicy struct {
+	WorkflowID int64
+	CreatorID  int64
+	Version    string
+}

backend/domain/workflow/entity/vo/chatflow.go

@@ -0,0 +1,84 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package vo
+
+import "github.com/cloudwego/eino/schema"
+
+type ChatFlowEvent string
+
+const (
+	ChatFlowCreated          ChatFlowEvent = "conversation.chat.created"
+	ChatFlowInProgress       ChatFlowEvent = "conversation.chat.in_progress"
+	ChatFlowCompleted        ChatFlowEvent = "conversation.chat.completed"
+	ChatFlowFailed           ChatFlowEvent = "conversation.chat.failed"
+	ChatFlowRequiresAction   ChatFlowEvent = "conversation.chat.requires_action"
+	ChatFlowError            ChatFlowEvent = "error"
+	ChatFlowDone             ChatFlowEvent = "done"
+	ChatFlowMessageDelta     ChatFlowEvent = "conversation.message.delta"
+	ChatFlowMessageCompleted ChatFlowEvent = "conversation.message.completed"
+)
+
+type Usage struct {
+	TokenCount   *int32 `form:"token_count" json:"token_count,omitempty"`
+	OutputTokens *int32 `form:"output_count" json:"output_count,omitempty"`
+	InputTokens  *int32 `form:"input_count" json:"input_count,omitempty"`
+}
+
+type Status string
+
+const (
+	Created        Status = "created"
+	InProgress     Status = "in_progress"
+	Completed      Status = "completed"
+	Failed         Status = "failed"
+	RequiresAction Status = "requires_action"
+	Canceled       Status = "canceled"
+)
+
+type ChatFlowDetail struct {
+	ID             string `json:"id,omitempty"`
+	ConversationID string `json:"conversation_id,omitempty"`
+	BotID          string `json:"bot_id,omitempty"`
+	Status         Status `json:"status,omitempty"`
+	Usage          *Usage `json:"usage,omitempty"`
+	ExecuteID      string `json:"execute_id,omitempty"`
+	SectionID      string `json:"section_id"`
+}
+
+type MessageDetail struct {
+	ID             string `json:"id"`
+	ChatID         string `json:"chat_id"`
+	ConversationID string `json:"conversation_id"`
+	BotID          string `json:"bot_id"`
+	Role           string `json:"role"`
+	Type           string `json:"type"`
+	Content        string `json:"content"`
+	ContentType    string `json:"content_type"`
+	SectionID      string `json:"section_id"`
+}
+
+type ErrorDetail struct {
+	Code     string `form:"code,required" json:"code,required"`
+	Msg      string `form:"msg,required" json:"msg,required"`
+	DebugUrl string `form:"debug_url" json:"debug_url,omitempty"`
+}
+
+type SuggestInfo struct {
+	UserInput    *schema.Message `json:"user_input,omitempty"`
+	AnswerInput  *schema.Message `json:"answer,omitempty"`
+	PersonaInput *string         `json:"persona_input,omitempty"`
+}

backend/domain/workflow/entity/vo/conversation.go

@@ -0,0 +1,74 @@
+/*
+ * Copyright 2025 coze-dev Authors
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package vo
+
+type Env string
+
+const (
+	Draft  Env = "draft"
+	Online Env = "online"
+)
+
+type CreateConversationTemplateMeta struct {
+	UserID  int64
+	AppID   int64
+	SpaceID int64
+	Name    string
+}
+
+type GetConversationTemplatePolicy struct {
+	AppID      *int64
+	Name       *string
+	Version    *string
+	TemplateID *int64
+}
+
+type ListConversationTemplatePolicy struct {
+	AppID    int64
+	Page     *Page
+	NameLike *string
+	Version  *string
+}
+
+type ListConversationMeta struct {
+	APPID       int64
+	UserID      int64
+	ConnectorID int64
+}
+
+type ListConversationPolicy struct {
+	ListConversationMeta
+
+	Page     *Page
+	NameLike *string
+	Version  *string
+}
+
+type CreateStaticConversation struct {
+	AppID       int64
+	UserID      int64
+	ConnectorID int64
+
+	TemplateID int64
+}
+type CreateDynamicConversation struct {
+	AppID       int64
+	UserID      int64
+	ConnectorID int64
+
+	Name string
+}

backend/domain/workflow/entity/vo/meta.go

@@ -68,6 +68,7 @@ type MetaUpdate struct {
 	IconURI                *string
 	HasPublished           *bool
 	LatestPublishedVersion *string
+	WorkflowMode           *Mode
 }
 
 type MetaQuery struct {
@@ -80,4 +81,5 @@ type MetaQuery struct {
 	LibOnly         bool
 	NeedTotalNumber bool
 	DescByUpdate    bool
+	Mode            *workflow.WorkflowMode
 }

backend/domain/workflow/entity/vo/workflow_publish.go

@@ -21,4 +21,5 @@ type ReleaseWorkflowConfig struct {
 	PluginIDs []int64
 
 	ConnectorIDs []int64
+	WorkflowIDs  []int64
 }