Added version and role to Agent Semantic Convention

[gyliu513]

Fixes #1878

Changes

Please provide a brief description of the changes here.

Note: if the PR is touching an area that is not listed in the existing areas, or the area does not have sufficient domain experts coverage, the PR might be tagged as experts needed and move slowly until experts are identified.

Merge requirement checklist

• CONTRIBUTING.md guidelines followed.
• Change log entry added, according to the guidelines in When to add a changelog entry.
  • If your PR does not need a change log, start the PR title with [chore]
• schema-next.yaml updated with changes to existing conventions.

[lmolkova]

are there some existing agent frameworks or services that support it? How would it be different from the name and/or description?

[gyliu513]

CrewAI have this concept https://github.com/crewAIInc/crewAI/blob/77c7b7dfa1c2765a231a2e8f292ebb9dff8879f0/src/crewai/agents/agent_builder/base_agent.py#L36

• For role, I want we have two roles first including worker and coordinator, we can add more roles as needed. For multiple agent framework, we may need to clarify what is the role of the agent, like there will be some coordinator agent, and some worker agent etc.
• For name, it will be more flexible for customers, they can use any name that is meaningful for them
• For description, it will be mainly used to clarify what will this agent do, it will probably be a sentence description for the agent.

[lmolkova]

Is it used by other frameworks? We can add have crewai-specific conventions, but I'm not sure if it's used by anyone else, so it might not be the right candidate for the general attribute.

Also, would you classify it as something essential for agent observability? I mean humans can figure out the role from name and description and not sure what visualization/tools would do with role information. So is there some specific scenario where it'd be important to have the role formalized?

[gyliu513]

MetaGPT also have roles concept https://github.com/geekan/MetaGPT/tree/main/metagpt/roles , like architect, assistant, engineer, researcher etc. But seems MetaGPT is using some other way to describe roles, let me do more research for this, thanks @lmolkova

[lmolkova]

are there some existing frameworks out there that have a concept of agent version?

[gyliu513]

Not yet, for now, I can see sometimes we can add version info to agent name, like ResearchAssistant_v1, ResearchAssistant_v2 etc., but having a dedicate version field maybe better especially for some comparison of agents with different versions.

[lmolkova]

let's not add version now then - we can always add attributes when we need them. Also, it's a good question whether they should be supplied in instrumentation scope (when creating tracer/meter) vs in span attributes.