# Hands on Examples

Use these examples after [Quick Start](https://gdplabs.gitbook.io/gl-aip/getting-started/quick-start-guide) to explore real scenarios with runnable code and CLI commands.

{% hint style="success" %}
**When to use this page:** You are ready for richer workflows and want copy-and-run snippets instead of building from scratch.
{% endhint %}

{% hint style="info" %}
**Audience:** Engineers prototyping orchestration, PMs preparing demos, and data developers running evaluations without coding.
{% endhint %}

{% hint style="info" %}
**TUI Development**: Many examples below demonstrate Textual-based TUI patterns. For comprehensive TUI guidance, refer to the TUI foundation spec in the repository.
{% endhint %}

{% hint style="info" %}
**Note:** Validated example projects are now centralized in the [GL SDK Cookbook](https://github.com/GDP-ADMIN/gl-sdk-cookbook). This ensures all blueprints remain self-contained, runnable, and maintained with the latest SDK best practices.
{% endhint %}

Each row links to a runnable project. Follow the README for quick start instructions, then inspect code to understand the pattern.

### Validated Example Projects

These projects demonstrate foundational patterns and are maintained in the [GL SDK Cookbook](https://github.com/GDP-ADMIN/gl-sdk-cookbook). Each project is self-contained and ready to run.

| Pattern                       | Description                                                                                                                                           | Project Link                                                                                                               |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
| **Basic Agent (Hello World)** | A minimal starter demonstrating how to create and run an agent using config-based instantiation.                                                      | [hello-world](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/hello-world)                           |
| **Modular Tool Integration**  | Learn how to organize complex tools with separate helper files and modular structure.                                                                 | [modular-tool-integration](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/modular-tool-integration) |
| **Multi-Agent Coordinator**   | Coordinator with specialized sub-agents (e.g., formal and casual greeting team).                                                                      | [multi-agent](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/multi-agent)                           |
| **Multi-Agent Patterns**      | Runnable blueprints for Sequential, Parallel, Router, Hierarchical, and Aggregator flows.                                                             | [multi-agent-patterns](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/multi-agent-system-patterns)  |
| **Runtime Configuration**     | How to pass per-request overrides for agents, tools, and MCPs at runtime (e.g., database URLs or planning).                                           | [runtime-config](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/runtime-config)                     |
| **Agent Export & Import**     | Demonstrates how to serialize and deserialize agent configurations for portability.                                                                   | [export-import](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/agent-export-import)                 |
| **Local Execution**           | Run agents locally without deployment (see [Local vs Remote](https://gdplabs.gitbook.io/gl-aip/getting-started/local-vs-remote) for feature mapping). | [hello-world-local](https://github.com/GDP-ADMIN/gl-sdk-cookbook/tree/main/glaip/examples/hello-world-local)               |

***

### Cookbook Examples

| Goal                                                                       | Guide                                                                                                               |
| -------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| Attach native or custom tools to an agent                                  | [Tools guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/tools-guide)                                          |
| Attach files, manage artifacts, and reuse chunks                           | [File processing guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/file-processing-guide)                      |
| Coordinate sequential, parallel, router, hierarchical, or aggregator flows | [Multi-Agent System Patterns overview](https://gdplabs.gitbook.io/gl-aip/how-to-guides/multi-agent-system-patterns) |
| Configure Model Context Protocol connectors                                | [MCPs guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/mcps-guide)                                            |
| Tune `language_model_id` values and routing strategies                     | [Language models guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/language-models-guide)                      |
| Orchestrate runs from scripts or CI pipelines                              | [Automation & scripting](https://gdplabs.gitbook.io/gl-aip/how-to-guides/automation-and-scripting)                  |
| Export/import configurations or sync LangFlow flows                        | [Configuration management guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/configuration-management-guide)    |
| Apply PII masking, memory, and tool-output policies                        | [Security & privacy](https://gdplabs.gitbook.io/gl-aip/how-to-guides/security-and-privacy)                          |
| Prepare for multi-account setups and future RBAC                           | [Multi-account management guide](https://gdplabs.gitbook.io/gl-aip/how-to-guides/multi-account-management-guide)    |