code-templates

Use WorkflowBuilder to add nodes with the 4-parameter pattern, connect them with add_connection, then call build() before executing with LocalRuntime. The basic template includes imports, a main function, error handling, and result access via the 'result' key.

Build the workflow first with workflow.build(), then call create_cycle on the built workflow with mapping, max_iterations, and converge_when criteria. Use try/except in node code to handle the first iteration, and use the 'result.' prefix in mappings for PythonCodeNode outputs.

Tier 1 unit tests run under 1 second and allow mocking external services. Tier 2 integration tests run under 5 seconds against real Docker services like PostgreSQL with mocking forbidden. Tier 3 end-to-end tests validate complete business scenarios on full infrastructure.

No, mocking is forbidden in Tier 2 integration tests. You must use real Docker services such as PostgreSQL and Redis, with fixtures providing connection URLs and cleanup logic that truncates test tables before and after each test.

Subclass Node, implement get_parameters() to declare NodeParameter entries with types and defaults, and implement run() to execute logic. Optionally add Pydantic models for validation, then register the node with NodeRegistry for use in workflows.

Instantiate MCPServer with an APIKeyAuth provider defining keys, permissions, and rate limits. Register tools with the @server.tool() decorator specifying required_permission and cache settings, then run the server with asyncio.