autogen/docs/design/04 - Agent and Topic ID Specs.md
Jack Gerrits 1f07e5bea5
Add type prefix subscription (#4383)
* Add type prefix subscription

* update example

---------

Co-authored-by: Ryan Sweet <rysweet@microsoft.com>
2024-11-26 15:58:26 -05:00

1.6 KiB

Agent and Topic ID Specs

This document describes the structure, constraints, and behavior of Agent IDs and Topic IDs.

Agent ID

Required Attributes

type

  • Type: string
  • Description: The agent type is not an agent class. It associates an agent with a specific factory function, which produces instances of agents of the same agent type. For example, different factory functions can produce the same agent class but with different constructor perameters.
  • Constraints: UTF8 and only contain alphanumeric letters (a-z) and (0-9), or underscores (_). A valid identifier cannot start with a number, or contain any spaces.
  • Examples:
    • code_reviewer
    • WebSurfer
    • UserProxy

key

  • Type: string
  • Description: The agent key is an instance identifier for the given agent type
  • Constraints: UTF8 and only contain characters between (inclusive) ascii 32 (space) and 126 (~).
  • Examples:
    • default
    • A memory address
    • a UUID string

Topic ID

Required Attributes

type

  • Type: string
  • Description: Topic type is usually defined by application code to mark the type of messages the topic is for.
  • Constraints: UTF8 and only contain alphanumeric letters (a-z) and (0-9), ':', '=', or underscores (_). A valid identifier cannot start with a number, or contain any spaces.
  • Examples:
    • GitHub_Issues

source

  • Type: string
  • Description: Topic source is the unique identifier for a topic within a topic type. It is typically defined by application data.
  • Constraints: UTF8 and only contain characters between (inclusive) ascii 32 (space) and 126 (~).
  • Examples:
    • github.com/{repo_name}/issues/{issue_number}