Skip to content

Feature 1979 conversational experiences #1983

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: master
Choose a base branch
from
63 changes: 63 additions & 0 deletions components/datatypes/agentic/agentic.example.1.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
{
"xdm:agentic": {
"xdm:name": "Customer Support Experience",
"xdm:version": "1.0.0",
"xdm:agents": [
{
"xdm:name": "Chatbot Assistant",
"xdm:version": "2.1.3",
"xdm:score": 0.92,
"xdm:skills": [
{
"xdm:name": "Intent Recognition",
"xdm:version": "1.0.0",
"xdm:score": 0.95,
"xdm:parameters": [
{
"key": "language",
"value": "un-US"
},
{
"key": "confidenceThreshold",
"value": "0.8"
}
]
},
{
"xdm:name": "FAQ Retrieval",
"xdm:version": "1.2.0",
"xdm:score": 0.89,
"xdm:parameters": [
{
"key": "maxResults",
"value": "5"
}
]
}
]
},
{
"xdm:name": "Voice Assistant",
"xdm:version": "3.0.0",
"xdm:score": 0.88,
"xdm:skills": [
{
"xdm:name": "Speech Recognition",
"xdm:version": "2.0.1",
"xdm:score": 0.91,
"xdm:parameters": [
{
"key": "languageModel",
"value": "general"
},
{
"key": "noiseSuppression",
"value": "true"
}
]
}
]
}
]
}
}
107 changes: 107 additions & 0 deletions components/datatypes/agentic/agentic.schema.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,107 @@
{
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rbuck23 , I think it would make sense to just put these fields directly in an agentic-event fieldgroup since they aren't reused.

"meta:license": [
"Copyright 2025 Adobe Systems Incorporated. All rights reserved.",
"This work is licensed under a Creative Commons Attribution 4.0 International (CC BY 4.0) license",
"you may not use this file except in compliance with the License. You may obtain a copy",
"of the License at https://creativecommons.org/licenses/by/4.0/"
],
"$id": "https://ns.adobe.com/xdm/datatypes/agentic",
"$schema": "http://json-schema.org/draft-06/schema#",
"title": "Agentic Information",
"type": "object",
"meta:extensible": true,
"description": "Construct to represent agents, agent skills, etc.",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@rbuck23 it would be good to add which fields are required, the examples help, but it is not clear which fields are mandatory.

"definitions": {
"name": {
"properties": {
"xdm:name": {
"title": "Name",
"type": "string",
"description": "Name of the agent component"
}
}
},
"version": {
"properties": {
"xdm:version": {
"title": "Version",
"type": "string",
"description": "Version of the agent component"
}
}
},
"score": {
"properties": {
"xdm:score": {
"title": "Score",
"type": "number",
"description": "Score of the agent component"
}
}
},
"parameters": {
"properties": {
"xdm:parameters": {
"type": "array",
"title": "Parameters",
"description": "Parameters passed in to the skill of the agent",
"items": {
"$ref": "https://ns.adobe.com/xdm/datatypes/keyvalue"
}
}
}
},
"skills": {
"properties": {
"xdm:skills": {
"type": "array",
"title": "Agent Skills",
"description": "Skills associated with a particular agent",
"items": {
"type": "object",
"allOf": [
{ "$ref": "#/definitions/name" },
{ "$ref": "#/definitions/version" },

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does a score for a skill mean?

{ "$ref": "#/definitions/score" },
{ "$ref": "#/definitions/parameters" }
]
}
}
}
},
"agents": {
"properties": {
"xdm:agents": {
"type": "array",
"title": "Agents",
"description": "Agents used in this experience",
"items": {
"type": "object",
"allOf": [
{ "$ref": "#/definitions/name" },

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What does a score for an agent mean?

{ "$ref": "#/definitions/version" },
{ "$ref": "#/definitions/score" },
{ "$ref": "#/definitions/skills" }
]
}
}
}
},
"agentic": {
"properties": {
"xdm:agentic": {
"type": "object",
"title": "Agentic Experience",
"description": "Agentic Experience",
"allOf": [
{ "$ref": "#/definitions/name" },
{ "$ref": "#/definitions/version" },
{ "$ref": "#/definitions/agents" }
]
}
}
}
},
"allOf": [{ "$ref": "#/definitions/agentic" }],
"meta:status": "experimental"
}
68 changes: 68 additions & 0 deletions components/datatypes/agentic/conversation.example.1.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
{
"xdm:conversation": {
"xdm:conversationId": "conv-001",
"xdm:interactionId": "int-001",
"xdm:prompt": {
"xdm:count": 1,
"xdm:source": "end-user",
"xdm:raw": "What is the capital of France?",
"xdm:signals": {
"xdm:subjects": [
{
"xdm:phrase": "capital",
"xdm:qualifiers": ["France"]
}
],
"xdm:attributes": {
"xdm:intent": ["questioning"],
"xdm:sentiment": ["positive"],
"xdm:tone": ["inquisitive"]
}
}
},
"xdm:response": {
"xdm:count": 1,
"xdm:source": "concierge",
"xdm:raw": "The capital of France is Paris.",
"xdm:operations": {
"xdm:cached": false
},
"xdm:signals": {
"xdm:subjects": [
{
"xdm:phrase": "capital",
"xdm:qualifiers": ["Paris", "France"]
}
],
"xdm:attributes": {
"xdm:intent": ["inform"],
"xdm:sentiment": ["positive"],
"xdm:tone": ["educational"]
}
}
},
"xdm:feedback": {
Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It's very likely that feedback will come asynchronous to the prompt+response. See the conversation-event examples.
https://github.com/adobe/xdm/pull/1983/files#diff-4ce50d36345c5de493a4373ac7350f5bc09d321bf74b5b68e83a0121f655defcR1

"xdm:count": 1,
"xdm:source": "end-user",
"xdm:raw": "Thanks, that was helpful!",
"xdm:rating": {
"xdm:score": 1,
"xdm:classification": "Thumbs Up",
"xdm:reasons": ["Accurate", "Quick response"]
},
"xdm:signals": {
"xdm:subjects": [
{
"xdm:phrase": "helpful",
"xdm:qualifiers": []
}
],
"xdm:attributes": {
"xdm:intent": ["thanksgiving"],
"xdm:sentiment": ["positive"],
"xdm:tone": ["thankful"]
}
}
}
}
}
Loading