Skip to content

conversation_toolset.toolsets.conversation.ConversationTools

Inspect Conversation Graph (UConversationDatabase) dialogue assets.

7 tool(s).

conversation_toolset.toolsets.conversation.ConversationTools.get_all_nodes

Returns all reachable nodes in the conversation.

    Use ObjectTools.get_class and get_properties on each node
    to inspect type and properties. Each node's GUID is
    available via its compiled_node_guid attribute.

    Args:
        conversation: The ConversationDatabase asset.
    Returns:
        A list of UConversationNode UObjects.

Input schema

{
  "properties": {
    "conversation": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationDatabase",
      "type": "object"
    }
  },
  "required": [
    "conversation"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "properties": {
          "refPath": {
            "description": "The reference stored as a soft path string.",
            "type": "string"
          }
        },
        "required": [
          "refPath"
        ],
        "title": "/Script/CommonConversationRuntime.ConversationNode",
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.get_node_by_guid

Returns a conversation node by its GUID.

    Args:
        conversation: The ConversationDatabase asset.
        guid: The GUID (from get_node_guids or entry_points).
    Returns:
        The UConversationNode.

Input schema

{
  "properties": {
    "conversation": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationDatabase",
      "type": "object"
    },
    "guid": {
      "description": "Globally unique identifier in 8-4-4-4-12 hyphenated form, e.g. \"E05FCC13-4D37-9D7A-E238-83859F29AD74\".",
      "pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
      "type": "string"
    }
  },
  "required": [
    "conversation",
    "guid"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationNode",
      "type": "object"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.get_node_connections

Returns output connection GUIDs for a conversation node.

    Args:
        node: The conversation node to query.
    Returns:
        A list of FGuid output connections.

Input schema

{
  "properties": {
    "node": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationNodeWithLinks",
      "type": "object"
    }
  },
  "required": [
    "node"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.get_node_guids

Returns GUIDs of all reachable nodes, in map iteration order.

    Use with get_node_by_guid to look up specific nodes.

    Args:
        conversation: The ConversationDatabase asset.
    Returns:
        A list of FGuid structs.

Input schema

{
  "properties": {
    "conversation": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationDatabase",
      "type": "object"
    }
  },
  "required": [
    "conversation"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
        "type": "string"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.get_sub_nodes

Returns sub-nodes (requirements, choices) attached to a task node.

    Args:
        node: The conversation task node to query.
    Returns:
        A list of UConversationSubNode UObjects.

Input schema

{
  "properties": {
    "node": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationTaskNode",
      "type": "object"
    }
  },
  "required": [
    "node"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "properties": {
          "refPath": {
            "description": "The reference stored as a soft path string.",
            "type": "string"
          }
        },
        "required": [
          "refPath"
        ],
        "title": "/Script/CommonConversationRuntime.ConversationSubNode",
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.list_entry_points

Returns entry points (FConversationEntryList structs).

    Args:
        conversation: The ConversationDatabase asset.
    Returns:
        A list of FConversationEntryList structs.

Input schema

{
  "properties": {
    "conversation": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationDatabase",
      "type": "object"
    }
  },
  "required": [
    "conversation"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "properties": {
          "destinationList": {
            "items": {
              "pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
              "type": "string"
            },
            "type": "array"
          },
          "entryIdentifier": {
            "type": "string"
          },
          "entryTag": {
            "properties": {
              "tagName": {
                "description": "This Tags Name",
                "type": "string"
              }
            },
            "required": [
              "tagName"
            ],
            "title": "GameplayTag",
            "type": "object"
          }
        },
        "required": [
          "entryTag",
          "destinationList",
          "entryIdentifier"
        ],
        "title": "ConversationEntryList",
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}

conversation_toolset.toolsets.conversation.ConversationTools.list_speakers

Returns speaker/participant information.

    Args:
        conversation: The ConversationDatabase asset.
    Returns:
        A list of FCommonDialogueBankParticipant structs.

Input schema

{
  "properties": {
    "conversation": {
      "description": "Represents a reference to a UObject or UClass.",
      "properties": {
        "refPath": {
          "description": "The reference stored as a soft path string.",
          "type": "string"
        }
      },
      "required": [
        "refPath"
      ],
      "title": "/Script/CommonConversationRuntime.ConversationDatabase",
      "type": "object"
    }
  },
  "required": [
    "conversation"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "returnValue": {
      "items": {
        "properties": {
          "fallbackName": {
            "type": "string"
          },
          "nodeTint": {
            "properties": {
              "a": {
                "minimum": 0,
                "type": "number"
              },
              "b": {
                "minimum": 0,
                "type": "number"
              },
              "g": {
                "minimum": 0,
                "type": "number"
              },
              "r": {
                "minimum": 0,
                "type": "number"
              }
            },
            "required": [
              "r",
              "g",
              "b",
              "a"
            ],
            "title": "LinearColor",
            "type": "object"
          },
          "participantName": {
            "description": "Identifier represented by the component",
            "properties": {
              "tagName": {
                "description": "This Tags Name",
                "type": "string"
              }
            },
            "required": [
              "tagName"
            ],
            "title": "GameplayTag",
            "type": "object"
          }
        },
        "required": [
          "fallbackName",
          "participantName",
          "nodeTint"
        ],
        "title": "CommonDialogueBankParticipant",
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "returnValue"
  ],
  "type": "object"
}