feat: CoffeeAGNTCY initial docs #176

therealaditigupta · 2025-08-08T17:15:51Z

Initial documentation for CoffeeAGNTCY including a:

Getting started guide
Identity in CoffeeAGNTCY
SLIM in CoffeeAGNTCY

Signed-off-by: Aditi Gupta <[email protected]>

docs/coffee-agntcy/get-started.md

Signed-off-by: Aditi Gupta <[email protected]>

keraron

Hi, I've left a few editorial notes and comments.

keraron · 2025-08-15T12:10:37Z

docs/.index

@@ -9,5 +9,6 @@ nav:
  - Messaging SDK: messaging
  - Agent Workflow Server: agws
  - CSIT: csit
+  - CoffeeAGNTCY: coffee-agntcy


The ToC was reorganised in #140, I think in that structure CoffeeAGNTCY should have a more prominent space, right after CSIT maybe.

keraron · 2025-08-15T12:11:15Z

docs/coffee-agntcy/get-started.md

+# Get Started with CoffeeAGNTCY
+
+
+CoffeeAgntcy is a reference implementation built around a fictitious coffee company to demonstrate how components in the AGNTCY Internet of Agents ecosystem work together.


Suggested change

CoffeeAgntcy is a reference implementation built around a fictitious coffee company to demonstrate how components in the AGNTCY Internet of Agents ecosystem work together.

CoffeeAGNTCY is a reference implementation built around a fictitious coffee company to demonstrate how components in the AGNTCY Internet of Agents ecosystem work together.

keraron · 2025-08-15T12:11:43Z

docs/coffee-agntcy/get-started.md

+This project is meant to exemplify how AGNTCY and open-source agentic standards interoperate through clean, reproducible example code. It is purposefully designed for developers across experience levels, from those taking their first steps in building agentic systems to those with more experience curious about AGNTCY's offerings.
+
+With CoffeeAgntcy, you can:
+* How to leverage the AGNTCY App SDK Factory to write transport and agentic protocol-agnostic clients and server code


Suggested change

* How to leverage the AGNTCY App SDK Factory to write transport and agentic protocol-agnostic clients and server code

* Learn how to leverage the AGNTCY App SDK Factory to write transport and agentic protocol-agnostic clients and server code.

keraron · 2025-08-15T12:11:53Z

docs/coffee-agntcy/get-started.md

+
+* Enable observability with the AGNTCY Observe SDK.
+
+* Learn how to write simple A2A client and server agents


Suggested change

* Learn how to write simple A2A client and server agents

* Learn how to write simple A2A client and server agents.

keraron · 2025-08-15T12:12:01Z

docs/coffee-agntcy/get-started.md

+
+* Learn how to write simple A2A client and server agents
+
+* Orchestrate agents using LangGraph via the supervisor-worker agent architecture


Suggested change

* Orchestrate agents using LangGraph via the supervisor-worker agent architecture

* Orchestrate agents using LangGraph via the supervisor-worker agent architecture.

keraron · 2025-08-15T12:20:15Z

docs/coffee-agntcy/get-started.md

+
+### Lungo
+
+Lungo is our evolving demo application. As AGNTCY expands, Lungo grows alongside it, adding new features and capabilities, and demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.


Suggested change

Lungo is our evolving demo application. As AGNTCY expands, Lungo grows alongside it, adding new features and capabilities, and demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.

Lungo is our ever-evolving demo application. As AGNTCY expands, Lungo grows alongside it. It adds new features and capabilities, demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.

keraron · 2025-08-15T12:24:03Z

docs/coffee-agntcy/identity-coffee-agntcy.md

+    S-->>U: Unable to proceed with this prompt
+
+```
+


We could add a link here to the Identity docs. Something along the lines of:

"For more information on Identity in AGNTCY, see the Identity documentation."

keraron · 2025-08-15T12:26:03Z

docs/coffee-agntcy/slim-coffee-agntcy.md

+
+## SLIM in CoffeeAGNTCY  
+
+CoffeeAGNTCY uses **SLIM** (Secure Low-Latency Interactive Messaging) as its default transport layer for all inter-agent communication. SLIM supports both **unicast** (1-to-1) and **broadcast** (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.  


Suggested change

CoffeeAGNTCY uses **SLIM** (Secure Low-Latency Interactive Messaging) as its default transport layer for all inter-agent communication. SLIM supports both **unicast** (1-to-1) and **broadcast** (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.

CoffeeAGNTCY uses [SLIM](../messaging/slim-core.md) as its default transport layer for all inter-agent communication. SLIM supports both **unicast** (1-to-1) and **broadcast** (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.

keraron · 2025-08-15T12:28:19Z

docs/coffee-agntcy/slim-coffee-agntcy.md

@@ -0,0 +1,55 @@
+#SLIM in CoffeeAGNTCY
+
+## SLIM in CoffeeAGNTCY  


I think this header is unnecessary, without it we could move each header under it up one.

keraron · 2025-08-15T12:30:02Z

docs/coffee-agntcy/slim-coffee-agntcy.md

+
+SLIM accommodates both targeted and broadcast messaging within the same API:  
+
+#### 1-to-1 Message  


These could be made into a bullet list instead of headers.

feat: CoffeeAGNTCY initial docs

b0d42f2

Signed-off-by: Aditi Gupta <[email protected]>

therealaditigupta requested a review from a team as a code owner August 8, 2025 17:15

therealaditigupta requested review from jubarbot-cisco and removed request for a team August 8, 2025 17:15

therealaditigupta added 2 commits August 8, 2025 10:26

fix: fixed doc calls and checked all symlinks

89b6190

Signed-off-by: Aditi Gupta <[email protected]>

fix: small doc changes

2743411

Signed-off-by: Aditi Gupta <[email protected]>

jparello reviewed Aug 8, 2025

View reviewed changes

docs/coffee-agntcy/get-started.md Outdated Show resolved Hide resolved

keraron self-requested a review August 11, 2025 13:49

fix: fixed docs based on review

6f75782

Signed-off-by: Aditi Gupta <[email protected]>

therealaditigupta requested a review from jparello August 11, 2025 17:35

keraron requested changes Aug 15, 2025

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: CoffeeAGNTCY initial docs #176

feat: CoffeeAGNTCY initial docs #176

Uh oh!

therealaditigupta commented Aug 8, 2025

Uh oh!

Uh oh!

keraron left a comment

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

keraron Aug 15, 2025

Uh oh!

Uh oh!

		# Get Started with CoffeeAGNTCY


		CoffeeAgntcy is a reference implementation built around a fictitious coffee company to demonstrate how components in the AGNTCY Internet of Agents ecosystem work together.

	* How to leverage the AGNTCY App SDK Factory to write transport and agentic protocol-agnostic clients and server code
	* Learn how to leverage the AGNTCY App SDK Factory to write transport and agentic protocol-agnostic clients and server code.


		* Enable observability with the AGNTCY Observe SDK.

		* Learn how to write simple A2A client and server agents


		* Learn how to write simple A2A client and server agents

		* Orchestrate agents using LangGraph via the supervisor-worker agent architecture


		### Lungo

		Lungo is our evolving demo application. As AGNTCY expands, Lungo grows alongside it, adding new features and capabilities, and demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.

	Lungo is our evolving demo application. As AGNTCY expands, Lungo grows alongside it, adding new features and capabilities, and demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.
	Lungo is our ever-evolving demo application. As AGNTCY expands, Lungo grows alongside it. It adds new features and capabilities, demonstrating how they work together in an interoperable ecosystem. Like the Corto demo, it includes a LangGraph-orchestrated supervisor agent, but instead of connecting to a single farm, Lungo integrates with three.


		## SLIM in CoffeeAGNTCY

		CoffeeAGNTCY uses SLIM (Secure Low-Latency Interactive Messaging) as its default transport layer for all inter-agent communication. SLIM supports both unicast (1-to-1) and broadcast (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.

	CoffeeAGNTCY uses SLIM (Secure Low-Latency Interactive Messaging) as its default transport layer for all inter-agent communication. SLIM supports both unicast (1-to-1) and broadcast (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.
	CoffeeAGNTCY uses [SLIM](../messaging/slim-core.md) as its default transport layer for all inter-agent communication. SLIM supports both unicast (1-to-1) and broadcast (1-to-many) messaging patterns, making it well-suited for CoffeeAGNTCY’s dynamic multi-agent workflows.

		@@ -0,0 +1,55 @@
		#SLIM in CoffeeAGNTCY

		## SLIM in CoffeeAGNTCY


		SLIM accommodates both targeted and broadcast messaging within the same API:

		#### 1-to-1 Message

feat: CoffeeAGNTCY initial docs #176

Are you sure you want to change the base?

feat: CoffeeAGNTCY initial docs #176

Uh oh!

Conversation

therealaditigupta commented Aug 8, 2025

Uh oh!

Uh oh!

keraron left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!