Agent Manifest - Agent Communication Protocol

The Agent Manifest describes essential properties of an agent, including its identity, capabilities, metadata, and runtime status. It also plays an important role in discoverability and how the ACP server advertises agents to clients.

During implementation, if the agent name and description are not provided, the agent’s function name and docstring will be used as defaults (as they are required).

Example SDK Implementation

The @server.agent decorator is used to configure an agent’s metadata when registering it with an ACP server:

agent.py

@server.agent(
    name="data-analyzer",
    description="Analyzes datasets and generates insights")
async def DataAnalyzerAgent():
    """String that is used as default description if not explicitly provided in the @server.agent """
    # Agent implementation here
    yield str(response.object)

Parameters

Content Types

The input_content_types and output_content_types fields specify the MIME types that an agent can handle. Wildcards are supported.

Common Content Types

*/*: Any content
image/*: Any image
text/plain: Plain text content
application/json: JSON structured data
image/png: PNG image files
image/jpeg: JPEG image files
application/pdf: PDF documents

Example Usage

@server.agent(
    name="image-analyzer",
    description="Analyzes images and provides text descriptions",
    input_content_types=["image/png", "image/jpeg"],
    output_content_types=["text/plain", "application/json"]
)
async def ImageAnalyzerAgent(input: list[Message], context: Context):
    # Process image inputs and return text/json outputs
    pass

Default Values

If input_content_types and output_content_types are not specified in the decorator, they default to ["*/*"]:

@server.agent()  # Uses default ["*/*"] for both input and output
async def SimpleTextAgent(input: list[Message], context: Context):
    # Agent implementation
    pass

name

string

required

A unique identifier for the agent following the RFC 1123 DNS label naming convention.

Required string length: 1 - 63

Pattern: ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Example:

"chat"

description

string

required

Human-readable description of the agent.

Example:

"Conversational agent with memory, supporting real-time search, Wikipedia lookups, and weather updates through integrated tools"

input_content_types

string[]

required

List of supported MIME content types for input Messages. Defines what formats of content the agent can consume.

Minimum array length: 1

output_content_types

string[]

required

List of supported MIME content types for output Messages. Defines what formats of content the agent can produce.

Minimum array length: 1

metadata

object

Static details about the agent, for discovery, classification, and cataloging.

Show child attributes

status

object

Real-time dynamic metrics and state provided by the system managing the agent.

Show child attributes

Agent DiscoveryDiscover available agents and their capabilities

⌘I

{
  "name": "chat",
  "description": "Conversational agent with memory, supporting real-time search, Wikipedia lookups, and weather updates through integrated tools",
  "input_content_types": [
    "<string>"
  ],
  "output_content_types": [
    "<string>"
  ],
  "metadata": {
    "annotations": {},
    "documentation": "The agent is a conversational system designed to process user messages, maintain context, and generate...",
    "license": "Apache-2.0",
    "programming_language": "Python",
    "natural_languages": [
      "en"
    ],
    "framework": "BeeAI",
    "capabilities": [
      {
        "name": "Conversational AI",
        "description": "Handles multi-turn conversations with memory."
      },
      {
        "name": "Vacation Request",
        "description": "Handles submission and tracking of vacation requests."
      }
    ],
    "domains": [
      "finance",
      "healthcare",
      "supply-chain"
    ],
    "tags": [
      "Chat"
    ],
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "contributors": [
      {
        "name": "John Smith",
        "email": "jsmith@example.com",
        "url": "https://example.com"
      }
    ],
    "links": [
      {
        "type": "source-code",
        "url": "https://github.com/i-am-bee/beeai-platform.git"
      },
      {
        "type": "homepage",
        "url": "https://agentcommunicationprotocol.dev"
      }
    ],
    "dependencies": [
      {
        "type": "tool",
        "name": "weather"
      }
    ],
    "recommended_models": [
      "llama3.3:70b-instruct-fp16",
      "llama3.3"
    ]
  },
  "status": {
    "avg_run_tokens": 1,
    "avg_run_time_seconds": 1,
    "success_rate": 50
  }
}

Documentation Index

​Example SDK Implementation

​Parameters

​Content Types

​Common Content Types

​Example Usage

​Default Values

Example SDK Implementation

Parameters

Content Types

Common Content Types

Example Usage

Default Values