Skip to main content

Tags

Tags

In Parlant, tags are used as markers to establish contextual relationships between different types of entities. In this section we'll explore the tag relationships between each pair of entities.

Supported Tag Relationships

The table below shows what relationships are currently available and well-defined in Parlant. The rest of the page will describe how each of the supported relationships works.

AgentsCustomersSessionsGuidelinesGuideline RelationshipsToolsGlossary TermsContext VariablesUtterances
Agents---View--ViewView-
Customers-------View-
Sessions---------
GuidelinesView---View---View
Guideline Relationships---View-----
Tools---------
Glossary TermsView--------
Context VariablesViewView-------
Utterances---View-----

Agents / Guidelines

  1. Only guidelines that are associated with an agent may participate in that agent's response process.
  2. Even if guidelines are related to other guidelines through relationships, these related guidelines will only be included if they themselves are associated with the agent.
  3. The set of associated guidelines for any given agent is comprised of:
    • Any guideline which is tagged with at least 1 tag the agent is also tagged with. For example, if the agent's tags are ["a", "b"], any guideline tagged with either "a" or "b" could be included.
    • Any guideline tagged with the agent's specific ID using the tag form "agent:<ID>".

Agents / Glossary Terms

  1. Only glossary terms that are associated with an agent may participate in that agent's response process.
  2. The set of associated glossary terms for any given agent is comprised of:
    • Any glossary term which is tagged with at least 1 tag the agent is also tagged with. For example, if the agent's tags are ["a", "b"], any glossary term tagged with either "a" or "b" could be included.
    • Any glossary term tagged with the agent's specific ID using the tag form "agent:<ID>".

Agents / Context Variables

  1. All context variables that are associated with an agent will always participate in that agent's response process.
  2. The set of associated context variables for any given agent is comprised of:
    • Any context variable which is tagged with at least 1 tag the agent is also tagged with. For example, if the agent's tags are ["a", "b"], any context variable tagged with either "a" or "b" could be included.
    • Any context variable term tagged with the agent's specific ID using the tag form "agent:<ID>".

Customers / Context Variables

  1. In a session between some agent and a customer C having ID CID, where C is tagged with some tag T having ID TID, and a context variable has a value set for the tag T using a key of the form "tag:<TID>", and, moreover, the context variable does not have the key "<CID>" set, then the context variable would get the value associated with "tag:<TID>".

Guideline Relationships / Guidelines

  1. Guideline relationships can associate guidelines using tags, such that:
    • If a source guideline GID is related with relationship R(source, target) to a target tag T, then all guidelines Gtagged tagged with T would inherit this relationship, such that the result would be that for every guideline Gtagged[i] in Gtagged, the relationship R(GID, Gtagged[i]) would hold.
    • If a source tag T is related with relationship R(source, target) to a target guideline GID, then all guidelines Gtagged tagged with T would inherit this relationship, such that the result would be that for every guideline Gtagged[i] in Gtagged, the relationship R(Gtagged[i], GID) would hold.
    • If a source tag Tsource is related with relationship R(source, target) to a target tag Ttarget, the result would be that for every guideline Gsource[i] tagged with Tsource and every guideline Gtarget[i] tagged with Ttarget, the relationship R(Gsource[i], Gtarget[i]) would hold.

Guidelines / Utterances

This feature is scheduled to be added in Parlant 2.1. Check back soon!