temporal ai agent

Report Abuse

Basic Information

This repository is a demo and reference implementation that runs a multi-turn AI agent inside a Temporal workflow. The agent is designed to collect information and execute steps toward a defined goal by running tools and soliciting clarifications as needed. It demonstrates both native tools implemented in the codebase and integration with external services via the Model Context Protocol (MCP). The project supports a default single-agent mode and an experimental multi-agent/multi-goal mode where different agent types can be selected or switched during conversations. Goals are organized in the /goals/ directory by category and the README and docs provide architecture, setup, and customization guidance. The repo shows how to configure LLM providers through LiteLLM-compatible models and includes demo videos and documentation to illustrate how the interaction and workflows operate.

Links

App Details

Features
Temporal-based workflow implementation for durable, stateful agent loops with built-in observability and error handling. Support for native tools placed in the /tools/ directory and MCP tool calling for external services with MCP server configuration managed in shared/mcp_config.py. Goal organization by category under /goals/ with examples across domains such as finance, HR, travel, and ecommerce. Configurable LLM integration via LiteLLM allowing OpenAI, Anthropic, Google Gemini, Deepseek, Ollama and other supported providers. Agentic behaviors described include iterative LLM execution, tool invocation with approval, human input validation, conversation summarization, and prompt construction. Experimental multi-agent/multi-goal support, extensive architecture docs, and guides for adding goals and tools are provided. Comprehensive tests for workflows and activities are included.
Use Cases
This project helps developers learn how to build durable, production-friendly agent systems using Temporal for orchestration and state management. It demonstrates best practices for managing long-running conversations, handling retries and errors, and keeping workflow history under control with productionization notes about payload storage and claim-check patterns. The MCP support shows how to integrate external services like payments or databases into agent workflows. Included setup instructions, quickstart environment variables, testing commands and test coverage examples make it easier to run and validate workflows and activities. Architecture and contributing guides plus example goals provide a starting point to customize tools, add new goals, and scale from single-agent demos to multi-agent experiments.

Please fill the required fields*