{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"redocly_category":"Products","product_name":"AI Agent Foundry","type":"markdown"},"seo":{"title":"Creating an Interface","description":"Treasure Data Product Documentation · Collect and Unify · Segment and Activate · Experiment and Analyze · Decisioning Automate with AI Scale and Trust.","siteUrl":"https://docs.treasuredata.com","lang":"en-US","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"creating-an-interface","__idx":0},"children":["Creating an Interface"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An interface object is the configuration or the screen for agent that will be shown in the Workspace. Once this object is created, underlying agent will be appeared in the Workspace with defined interface. Currently, Interface definition supports only a Form-type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-an-interface","__idx":1},"children":["Create an Interface"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open Treasure Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Navigate to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI Agent Foundry"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Project"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Interfaces"]}," and then select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create interface"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-16-45-36s.31853372a6a9c505a3e64ea4da27ff7ae0b9166fb1b359206377b35a0faa5857.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":5},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Populate a form"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-17-07-39.c42a80d203216f151b20229f8ef85d2f50707cfd9d931fe3f873d51aaa9ec339.91c26685.png","alt":""},"children":[]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Interface Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of this interface, which will be shown in the Workspace"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Agent name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Underlying Agent name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prompt template"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The input text that will be given to the agent when the user clicks a Generate button in the Workspace. The text should refer to the populated data in the form. The variable name given to the form item can be referred to using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{}}"]},". For example, if a form item has Field ID company_name, the value can be referenced with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{company_name}}"]}," in this field."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accordion Fields:"]}," When using an Accordion layout element, fields inside the accordion must be referenced using nested notation: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{accordion_id.field_id}}"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example, if an accordion has Field ID ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_details"]}," and contains a field with Field ID ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_name"]},", reference it as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{customer_details.customer_name}}"]},"."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":6},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click a ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Next"]}," Button and move to the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Form"]}," definition"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Place necessary form items in the form designer and populate the necessary configuration in the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Properties"]}," panel on the right side"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-17-18-34.29d1780f9e02f1f0f0729e4adc42ff5eb4fd2ab14ab9cfc010c0f2c8602a8e6d.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the  ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Apply"]}," button to apply a change"," ",{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-17-20-28.62bea52774228f14ebf54f116ee33790bc22812995bbfac7be70c226a3b30710.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the  ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Create"]}," button to complete"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"toolkit","__idx":2},"children":["Toolkit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Toolkit"]}," button on the top left side to open the list of form items."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-17-25-10.0c2c0cf97f55ee8c9ae90b2e97f6f005e1bea4e3bcf303ae80bd8333feded53d.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-accordion-toolkit.584f84d6c0ead86bde9de29802b638062ba6e8f8cbde5088d30d7a1a8fbbd6ae.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Form item has its own configuration. Not all configurations need to be set up, except for the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Field ID"]}," , which is a variable name for this form item and must be referred to by the  ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Prompt template"]},". Also the form item has configuration both for English and Japanese. Japanese configuration is used when the Japanese language is selected on the Treasure Console."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Belew is the example configuration of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Basic text"]},"."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Field ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Variable name referenced in the prompt template."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Text Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Basic text"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Text area"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Label"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Title shown above the input."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional helper text describing the field."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Placeholder"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Placeholder text displayed inside the input."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hint"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tooltip text shown when hovering the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["?"]}," icon."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disabled"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the field as disabled."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shows the value without allowing edits."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Marks the field as required."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Default value"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Initial value populated in the input."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"accordion","__idx":3},"children":["Accordion"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accordion is a layout element that allows you to group multiple form items together in a collapsible section. This is useful for organizing related fields and improving form readability."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-accordion-example.2646c8490a3d46216e622a9cb489a6419f314b4f1a4313f004597d2db7a9d1cc.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When referencing fields inside an accordion in the prompt template, you must use nested notation: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{accordion_id.field_id}}"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accordion Field ID: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_details"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Field inside accordion: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_name"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reference in prompt template: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{{customer_details.customer_name}}"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-form","__idx":4},"children":["Example form"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Below is the example prompt template and form definition for an agent that generates an AIDA marketing funnel. The agent is assumed to generate text output based on the information of Company Name, Industry, Product, and Marketing Detail."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To render the generated content in the form based interface, agent must have output function with output type: Artifact. About Artifact, please refer to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/customer-data-platform/ai-agent-foundry/ai-agent/creating-an-agent#add-outputs"},"children":["Add Outputs"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"prompt-template","__idx":5},"children":["Prompt template"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create AIDA story from the following information"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Company Name: {{company_name}}"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Industry: {{industry_info}}"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Product: {{product_info}}"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Marketing Detail: {{marketing_detail}}"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"form","__idx":6},"children":["Form"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/creating-an-interface-2025-08-05-17-44-16.a3981d54c5b6a827ce8ffbf6cd19e7aee730a690ea185e8e250efee62061115e.91c26685.png","alt":""},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Form item (label)"},"children":["Form item (label)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Form ID"},"children":["Form ID"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Company Name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["company_name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Industry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["industry_info"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Product"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["product_info"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Marketing Detail"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["marketing_detail"]}]}]}]}]}]},"headings":[{"value":"Creating an Interface","id":"creating-an-interface","depth":1},{"value":"Create an Interface","id":"create-an-interface","depth":2},{"value":"Toolkit","id":"toolkit","depth":3},{"value":"Accordion","id":"accordion","depth":4},{"value":"Example form","id":"example-form","depth":3},{"value":"Prompt template","id":"prompt-template","depth":4},{"value":"Form","id":"form","depth":4}],"frontmatter":{"seo":{"title":"Creating an Interface"}},"lastModified":"2026-06-01T09:09:59.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/customer-data-platform/ai-agent-foundry/interface/creating-an-interface","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}