stringTemplateAgent

Package

@graphai/vanilla

Source

https://github.com/receptron/graphai/blob/main/agents/vanilla_agents/src/string_agents/string_template_agent.ts

Description

Template agent

Schema

inputs

{
  "type": "object",
  "description": "Key-value pairs where each key corresponds to a variable used in the template (e.g., ${key}).",
  "additionalProperties": {
    "type": [
      "string",
      "number",
      "boolean",
      "object",
      "array",
      "null"
    ],
    "description": "Any value to be substituted into the template. Objects and arrays are injected directly if the entire field is a placeholder."
  }
}

output

{
  "description": "The result after placeholder substitution, matching the structure and type of the original template.",
  "anyOf": [
    {
      "type": "string"
    },
    {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "object",
            "additionalProperties": true
          }
        ]
      }
    },
    {
      "type": "object",
      "additionalProperties": true
    }
  ]
}

Input example of the next node

[
  ":agentId"
]

[
  ":agentId",
  ":agentId.$0",
  ":agentId.$1"
]

[
  ":agentId",
  ":agentId.apple",
  ":agentId.lemon"
]

[
  ":agentId",
  ":agentId.$0",
  ":agentId.$0.apple",
  ":agentId.$0.lemon"
]

[
  ":agentId",
  ":agentId.apple",
  ":agentId.lemon",
  ":agentId.lemon.$0"
]

[
  ":agentId",
  ":agentId.nodes",
  ":agentId.nodes.ai",
  ":agentId.nodes.ai.agent",
  ":agentId.nodes.ai.inputs",
  ":agentId.nodes.ai.inputs.prompt",
  ":agentId.nodes.ai.isResult",
  ":agentId.nodes.ai.params",
  ":agentId.nodes.ai.params.text",
  ":agentId.version"
]

Samples

Sample0

inputs

{
  "message1": "hello",
  "message2": "test"
}

params

{"template":"${message1}: ${message2}"}

result

"hello: test"

Sample1

inputs

{
  "message1": "hello",
  "message2": "test"
}

params

{"template":["${message1}: ${message2}","${message2}: ${message1}"]}

result

[
  "hello: test",
  "test: hello"
]

Sample2

inputs

{
  "message1": "hello",
  "message2": "test"
}

params

{"template":{"apple":"${message1}","lemon":"${message2}"}}

result

{
  "apple": "hello",
  "lemon": "test"
}

Sample3

inputs

{
  "message1": "hello",
  "message2": "test"
}

params

{"template":[{"apple":"${message1}","lemon":"${message2}"}]}

result

[
  {
    "apple": "hello",
    "lemon": "test"
  }
]

Sample4

inputs

{
  "message1": "hello",
  "message2": "test"
}

params

{"template":{"apple":"${message1}","lemon":["${message2}"]}}

result

{
  "apple": "hello",
  "lemon": [
    "test"
  ]
}

Sample5

inputs

{
  "agent": "openAiAgent",
  "row": "hello world",
  "params": {
    "text": "message"
  }
}

params

{"template":{"version":0.5,"nodes":{"ai":{"agent":"${agent}","isResult":true,"params":"${params}","inputs":{"prompt":"${row}"}}}}}

result

{
  "nodes": {
    "ai": {
      "agent": "openAiAgent",
      "inputs": {
        "prompt": "hello world"
      },
      "isResult": true,
      "params": {
        "text": "message"
      }
    }
  },
  "version": 0.5
}

Author

Satoshi Nakajima

Repository

https://github.com/receptron/graphai

License

MIT