{"id":2502,"date":"2025-09-18T16:20:46","date_gmt":"2025-09-18T16:20:46","guid":{"rendered":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2025\/09\/18\/build-and-distribute-ai-agents-and-workflows-with-cagent\/"},"modified":"2025-09-18T16:20:46","modified_gmt":"2025-09-18T16:20:46","slug":"build-and-distribute-ai-agents-and-workflows-with-cagent","status":"publish","type":"post","link":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2025\/09\/18\/build-and-distribute-ai-agents-and-workflows-with-cagent\/","title":{"rendered":"Build and Distribute AI Agents and Workflows with cagent"},"content":{"rendered":"

cagent<\/a> is a new open-source project from Docker that makes it simple to build, run, and share AI agents, without writing a single line of code. Instead of writing code and wrangling Python versions and dependencies when creating AI agents, you define your agent\u2019s behavior, tools, and persona in a single YAML file, making it incredibly straightforward to create and share personalized AI assistants.<\/p>\n

<\/div>\n

Figure 1: cagent is a powerful, easy to use, customizable multi-agent runtime that orchestrates AI agents with specialized capabilities and tools, and the interactions between agents.<\/p>\n\n

cagent can use OCI registries to share and pull agents created by the community, so not only can you elegantly solve the agent creation problem, but also the agent distribution problem.\u00a0<\/p>\n\n

Let\u2019s dive into what makes cagent special and explore some real-world use cases.<\/p>\n\n

What is cagent?<\/h2>\n

At its core, cagent<\/a> is a command-line utility that runs AI agents defined in cagent.yaml files. The philosophy is simple: declare what you want your agent to do<\/strong>, and cagent handles the rest.\u00a0<\/p>\n\n

There are a few features that you\u2019ll probably like for authoring your agents.\u00a0<\/p>\n

Declarative and Simple: Define models, instructions, and agent behavior in one YAML file. This \u201csingle artifact\u201d approach makes agents portable, easy to version, and easy to share.<\/p>\n

Flexible Model Support: You\u2019re not tied to a specific provider. You can run remote models or even local ones using Docker Model Runner, ideal for privacy reasons.\u00a0<\/p>\n

Powerful Tool Integration: cagent includes built-in tools for common tasks (like shell commands or filesystem access) and supports external tools via MCP, enabling agents to connect to virtually any API.\u00a0<\/p>\n

Multi-Agent Systems: You\u2019re also not limited to a single agent. Cagent allows you to define a team of agents that can collaborate and delegate tasks to one another, with each agent having its own specialized skills and tools.\u00a0<\/p>\n

Practical use cases for agent<\/h2>\n

I\u2019ve lived with and used cagent for a few weeks now, and in this article, I want to share two of my practically useful agents that I actually use.\u00a0<\/p>\n\n

A GitHub Task Tracker<\/strong><\/h3>\n

Let\u2019s start with a practical, developer-centric example. While tracking GitHub issues with AI might not be revolutionary, it\u2019s surprisingly useful and demonstrates cagent\u2019s capabilities in a real-world workflow.\u00a0<\/p>\n\n

There\u2019s no shortage of task tracking solutions to integrate with, but one of the most useful for developers is GitHub. We\u2019ll use a repository in GitHub and issues on it as our to-do list. Does it have the best UX? It doesn\u2019t actually matter; we\u2019ll consume and create issues with AI, so the actual underlying UX is irrelevant.\u00a0<\/p>\n\n

I have a GitHub repo: github.com\/shelajev\/todo<\/a>, which has issues enabled, and we\u2019d like an agent that can, among other things, create issues, list issues, and close issues.\u00a0<\/p>\n\n

<\/div>\n

Figure 2<\/p>\n\n

Here\u2019s the YAML for a GitHub-based to-do list agent. The instructions for the agent were generated with the agent new command, and then I refined the instructions it generated by manually asking Gemini to make them shorter.\u00a0<\/p>\n

YAML<\/p>\n

\nversion: “2”\n

models:
\n gpt:
\n provider: openai
\n model: gpt-5
\n max_tokens: 64000<\/p>\n

agents:
\n root:
\n model: gpt
\n description: “GitHub Issue Manager – An agent that connects to GitHub to use a repo as a todo-list”
\n instruction: |
\n You are a to-do list agent, and your purpose is to help users manage their tasks in their “todo” GitHub repository.<\/p>\n

# Primary Responsibilities
\n – Connect to the user’s “todo” GitHub repository and fetch their to-do items, which are GitHub issues.
\n – Identify and present the to-do items for the current day.
\n – Provide clear summaries of each to-do item, including its priority and any labels.
\n – Help the user organize and prioritize their tasks.
\n – Assist with managing to-do items, for example, by adding comments or marking them as complete.<\/p>\n

# Key Behaviors
\n – Always start by stating the current date to provide context for the day’s tasks.
\n – Focus on open to-do items.
\n – Use labels such as “urgent,” “high priority,” etc., to highlight important tasks.
\n – Summarize to-do items with their title, number, and any relevant labels.
\n – Proactively suggest which tasks to tackle first based on their labels and context.
\n – Offer to help with actions like adding notes to or closing tasks.<\/p>\n

# User Interaction Flow
\n When the user asks about their to-do list:
\n 1. List the open items from the “todo” repository.
\n 2. Highlight any urgent or high-priority tasks.
\n 3. Offer to provide more details on a specific task or to help manage the list.<\/p>\n

add_date: true
\n toolsets:
\n – type: mcp
\n command: docker
\n args: [mcp, gateway, run]
\n tools:
\n [
\n “get_me”,
\n “add_issue_comment”,
\n “create_issue”,
\n “get_issue”,
\n “list_issues”,
\n “search_issues”,
\n “update_issue”,
\n ]<\/p>\n<\/div>\n

It\u2019s a good example of a well-crafted prompt that defines the agent\u2019s persona, responsibilities, and behavior, ensuring it acts predictably and helpfully. The best part is editing and running it is fast and frictionless, just save the YAML and run:\u00a0<\/p>\n

\ncagent run github-todo.yaml\n<\/div>\n

This development loop works without any IDE setup. I\u2019ve done several iterations in Vim, all from the same terminal window where I was running the agent.\u00a0<\/p>\n

This agent also uses a streamlined tools configuration. A lot of examples show adding MCP servers from the Docker MCP toolkit like this:\u00a0<\/p>\n\n

\n toolsets:
\n – type: mcp
\n ref: docker:github-official\n<\/div>\n\n

This would run the GitHub MCP server from the MCP catalog, but as a separate \u201ctoolkit\u201d from your Docker Desktop\u2019s MCP toolkit setup.<\/p>\n\n

Using the manual command to connect to the MCP toolkit makes it easy to use OAuth login support in Docker Desktop.\u00a0<\/p>\n\n

<\/div>\n

Figure 3<\/p>\n\n

Also, the official GitHub MCP server is awfully verbose. Powerful, but verbose. So, for the issue-related agents, it makes a lot of sense to limit the list of tools exposed to the agent:\u00a0<\/p>\n

\n tools:
\n [
\n “get_me”,
\n “add_issue_comment”,
\n “create_issue”,
\n “get_issue”,
\n “list_issues”,
\n “search_issues”,
\n “update_issue”,
\n ]\n<\/div>\n\n

That list I made with running:\u00a0<\/p>\n

\ndocker mcp tools list | grep “issue”\n<\/div>\n

And asking AI to format it as an array.\u00a0<\/p>\n\n

This todo-agent is available on Docker Hub, so it\u2019s a simple agent pull command away:\u00a0<\/p>\n\n

\ncagent run docker.io\/olegselajev241\/github-todo:latest\n<\/div>\n

Just enable the GitHub MCP server in the MCP toolkit first, and well, make sure the repo exists.<\/p>\n

The Advocu Captains Agent<\/strong><\/h3>\n

At Docker, we use Advocu<\/strong> to track our Docker Captains, ambassadors who create content, speak at conferences, and engage with the community. We use Advocu to track their information details and contributions, such as blog posts, videos, and conference talks about Docker\u2019s technologies.<\/p>\n\n

Manually searching through Advocu is time-consuming. For a long time, I wondered: what if we could build an AI assistant to do it for us?\u00a0<\/p>\n\n

My first attempt was to build a custom MCP server for our Advocu instance: https:\/\/github.com\/shelajev\/mcp-advocu<\/a><\/p>\n\n

It\u2019s largely \u201cvibe-coded\u201d, but in a nutshell, running<\/p>\n

\ndocker run -i -rm -e ADVOCU_CLIENT_SECRET=your-secret-here olegselajev241\/mcp-advocu:stdio\n<\/div>\n

will run the MCP server with tools that expose information about Docker Captains, allowing MCP clients to search through their submitted activities.\u00a0<\/p>\n

<\/div>\n

Figure 4<\/p>\n\n

However, sharing the actual agent, and especially the configuration required to run it, was a bit awkward.\u00a0<\/p>\n\n

cagent solved this for me in a much neater way. Here is the complete cagent.yaml for my Advocu agent:<\/p>\n\n

YAML<\/p>\n

\n#!\/usr\/bin\/env cagent run
\nversion: “2”\n

agents:
\n root:
\n model: anthropic\/claude-sonnet-4-0
\n description: Agent to help with finding information on Docker Captains and their recent contributions to Docker
\n toolsets:
\n – type: mcp
\n command: docker
\n args:
\n – run
\n – -i
\n – –rm
\n – –env-file
\n – .\/.env
\n – olegselajev241\/mcp-advocu:stdio
\n instruction: You have access to Advocu – a platform where Docker Captains log their contributions. You can use tools to query and process that information about captains themselves, and their activities like articles, videos, and conference sessions. You help the user to find relevant information and to connect to the captains by topic expertise, countries, and so on. And to have a hand on the pulse of their contributions, so you can summarize them or answer questions about activities and their content<\/p>\n<\/div>\n

With this file, we have a powerful, personalized assistant that can query Captain info, summarize their contributions, and find experts by topic. It\u2019s a perfect example of how cagent can automate a specific internal workflow.<\/p>\n\n

Users simply need to create a .env file with the appropriate secret. Even for less technical team members, I can give a shell one-liner to get them set up quickly.\u00a0<\/p>\n\n

Now, everyone at Docker can ask questions about Docker captains without pinging the person running the program (hi, Eva!) or digging through giant spreadsheets.\u00a0<\/p>\n\n

<\/div>\n

Figure 5<\/p>\n\n

I\u2019m also excited about the upcoming cagent 1Password integration<\/a>, which will simplify the setup even more.\u00a0\u00a0<\/p>\n\n

All in all, agents are really just a combination of:<\/p>\n

A system prompt<\/p>\n

An integration with a model (ideally, the most efficient one that gets the job done)<\/p>\n

And the right tools via MCP<\/p>\n

With cagent, it\u2019s incredibly easy to manage all three in a clean, Docker \u2013 native way.\u00a0<\/p>\n\n

Get Started Today!<\/strong><\/h3>\n

cagent empowers you to build your own fleet of AI assistants, tailored to your exact needs. <\/p>\n\n

It\u2019s a tool designed for developers who want to leverage the power of AI without getting bogged down in complexity.<\/p>\n

You can get started right now by heading over to the cagent GitHub repository<\/a>. Download the latest release and start building your first agent in minutes.\u00a0<\/p>\n\n

Give the repository a star, try it out, and let us know what amazing agents you build!<\/p>","protected":false},"excerpt":{"rendered":"

cagent is a new open-source project from Docker that makes it simple to build, run, and share AI agents, without […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[4],"tags":[],"class_list":["post-2502","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/2502","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/comments?post=2502"}],"version-history":[{"count":0,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/2502\/revisions"}],"wp:attachment":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media?parent=2502"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/categories?post=2502"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/tags?post=2502"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}