Agent 执行结构¶

计划、任务、步骤摘要与结构化数据。

任务计划¶

展示 Agent 的计划与当前步骤。

任务计划


API	`Plan(title, description, steps)`
AI Elements	`Plan`
依赖模块	`ai-elements-ui`
API 文档	Plan

进度由调用方维护，状态为 COMPLETE、ACTIVE、PENDING。展示计划不等于安排或执行任务。

import androidx.compose.runtime.Composable
import dev.ai.elements.ui.chat.Plan
import dev.ai.elements.ui.chat.StepStatus
import dev.ai.elements.ui.chat.WorkflowStep

@Composable
fun PlanExample() {
    Plan("Release", description = "Review before publishing", steps = listOf(WorkflowStep("Review", status = StepStatus.COMPLETE), WorkflowStep("Publish", status = StepStatus.PENDING)))
}

任务条目¶

展示任务步骤及涉及的文件。

任务条目


API	`Task(title, steps)`
AI Elements	`Task`
依赖模块	`ai-elements-ui`
API 文档	Task

items 描述任务进展和文件标记；该组件不会修改文件。

import androidx.compose.runtime.Composable
import dev.ai.elements.ui.chat.Task
import dev.ai.elements.ui.chat.WorkflowStep

@Composable
fun TaskExample() {
    Task("Update docs", listOf(WorkflowStep("Write examples", badges = listOf("README.md"))))
}

推理步骤¶

展示步骤摘要及其来源。

推理步骤


API	`ChainOfThought(steps)`
AI Elements	`ChainOfThought`
依赖模块	`ai-elements-ui`
API 文档	ChainOfThought

只展示实际提供的步骤与来源。组件本身不会请求或提取模型未返回的推理过程。

import androidx.compose.runtime.Composable
import dev.ai.elements.ui.chat.ChainOfThought
import dev.ai.elements.ui.chat.StepStatus
import dev.ai.elements.ui.chat.WorkflowStep

@Composable
fun ChainOfThoughtExample() {
    ChainOfThought(listOf(WorkflowStep("Read the documentation", status = StepStatus.COMPLETE)))
}

结构化数据片段¶

把已知计划、任务或自定义数据渲染到对话中。

结构化数据片段


API	`DataPartView(part)`
依赖模块	`ai-elements-ui`
API 文档	DataPartView

已知 plan/task 结构会使用对应组件。自定义名称可注册到 AiElementsRenderers.data；未知结构仍会以数据视图显示。

import androidx.compose.runtime.Composable
import dev.ai.elements.core.model.DataPart
import dev.ai.elements.ui.chat.DataPartView

@Composable
fun DataPartsExample(part: DataPart) {
    DataPartView(part)
}

Read this page in English