Skip to main content
A agentic workflow is a collection of nodes and edges that define the logic of your workflow. To build a agentic workflow, follow these steps:
1

Import your agents and tools

Ensure that the agents and tools you want to connect in a agentic workflow are already imported.
2

Define a Python function with the @flow decorator

Use the @flow decorator to define your agentic workflow. In the decorator, specify the agentic workflow’s name, display_name, description, input_schema, output_schema, initiators, schedulable, llm_model, and agent_conversation_memory_turns_limit.
  • The function must take a single parameter of type Flow and return a Flow object.
  • Construct the agentic workflow using a combination of tool(), agent(), and edge-building functions like sequence() or edge().
  • For Branch and Loop nodes, use a Python expression in the evaluator to define the branching or looping condition. For more information, see Agentic workflow expressions.
The following tabs show some code snippet examples of agentic workflow:
  • Example 1
  • Example 2
  • Example 3
  • Example 4
Example 1: Sequencing two tools
Python
@flow(
    name = "hello_message_flow",
    input_schema=Name,
    output_schema=str
)
def build_hello_message_flow(aflow: Flow = None) -> Flow:
    """ Based on the first and last name of a person, combine into a single name and create a simple hello world message. """

    combine_names_node = aflow.tool(combine_names)
    get_hello_message_node = aflow.tool(get_hello_message)

    aflow.edge(START, combine_names_node).edge(combine_names_node, get_hello_message_node).edge(get_hello_message_node, END)

    return aflow
For the full example and complete code, see hello_message_flow.
3

Import the agentic workflow

Import the agentic workflow as a tool using the orchestrate tools import command in the CLI.
BASH
orchestrate tools import -k flow -f <path-to-python-file>
4

Test the agentic workflow locally in the ADK

Test the agentic workflow you created using a Python script before adding it to an agent. For more information, see Testing flows.
5

Add the agentic workflow to one agent

After successfully testing the agentic workflow, add it to an agent’s specification and update the agent.