{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Agents","projectTitle":"Frontline Documentation","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":"agents","__idx":0},"children":["Agents"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agent"]}," is a conversational AI assistant that lives in your account. It has a brain (model + instructions + tools), a look (theme), a set of channels it can talk on (livechat, WhatsApp, Instagram, Messenger), and one or more conversation flows that drive its behavior."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agents are the top-level entity for everything related to chat. If you're building a chatbot in Frontline, you're building an Agent."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"identity","__idx":1},"children":["Identity"]},{"$$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":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UUID. Use it as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agentId"]}," in nested routes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max 256 characters."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string?"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional free text."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["enum"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PAUSED"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ARCHIVED"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["isOffline"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," when the Agent is not serving traffic. Managed via the deployment-status endpoint."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO timestamp."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO timestamp."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"sub-resources","__idx":2},"children":["Sub-resources"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An Agent owns several sub-resources, each managed under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/agents/{agentId}/..."]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["agent-setting"]}]}," — the brain. AI model, instructions, temperature, tone, max iterations, custom tools, playbooks, connected accounts, selected tables. Fields like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["aiModelId"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customToolIds"]}," are validated against the corresponding resources before being saved."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["theme"]}]}," — the look. Title, initial message, placeholder, bubble colors, alignment, progress indicator, vertical position. Avatar and bubble image uploads are not exposed in the Public API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settings/{channel}"]}]}," — per-channel behavior. One sub-resource per channel: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["livechat"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whatsapp"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instagram"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messenger"]},". Each carries split-message rules, conversation-close policy, close instruction, etc."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flows"]}]}," — conversation flows. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/flows"},"children":["Flows"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["variables"]}]}," — agent-scoped data placeholders. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/flow-variables"},"children":["Flow Variables"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["intents"]}]}," — NLP triggers. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/intents"},"children":["Intents"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["analytics"]}]}," — credit usage, conversation counts, channel breakdown."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversations"]}]}," — read the agent's conversations and their message transcripts (read-only, basic fields). See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#reading-conversations--transcripts"},"children":["below"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reading-conversations--transcripts","__idx":3},"children":["Reading conversations & transcripts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read the conversations an agent has handled and the message-by-message transcript of each one. These are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["read-only"]}," and currently expose ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["basic"]}," fields."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/conversations"]}," — paginated, with optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_closed"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["start_date"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["end_date"]}," filters. Each conversation:"]},{"$$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":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["conversationId"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conversation label, if any."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["channel"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["E.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LIVECHAT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WHATSAPP"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OVERVIEW"]}," (playground)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_closed"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the conversation has been closed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["contact_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Linked People record, if identified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO timestamp."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updated_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO timestamp."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transcript"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/conversations/{conversationId}"]}," — the conversation above plus ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["messages: [{ id, role, type, text, created_at }]"]},", in order. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role"]}," distinguishes the contact from the agent; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["text"]}," is the message body."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"capturing-contact-info-creates-a-person-automatically","__idx":4},"children":["Capturing contact info creates a Person automatically"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a conversation captures a value into one of the standard ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["contact variables"]}," — ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]}," (also ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["role"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["website"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["language"]},") — that value is written straight to the conversation's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["People"]}," record."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Capturing any of the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["identification"]}," variables (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phone_number"]},") additionally ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["creates and identifies"]}," the Person: an anonymous conversation contact becomes an identified People record. You do ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," need a separate \"create record\" step — just capture into those variable names."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deduplication by email."]}," If the captured ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," matches an existing Person, the conversation is linked to that record instead of creating a duplicate."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["So a flow that collects a contact's name/email should capture into the agent's built-in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["first_name"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last_name"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," variables. Adding a node to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["also"]}," create the record would produce a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["duplicate"]}," People."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/concepts/flows"},"children":["Flows"]}," for capturing variables inside a flow."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"deployment-lifecycle","__idx":5},"children":["Deployment lifecycle"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"INACTIVE  →  ACTIVE  ←→  PAUSED  →  ARCHIVED\n              │\n              └── isOffline=true  =  paid for, not serving traffic\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Publishing an agent goes through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT /agents/{agentId}/deployment-status"]}," and triggers billing checks. An offline ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]}," agent is paid for but receives no traffic."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"operations","__idx":6},"children":["Operations"]},{"$$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":"Verb"},"children":["Verb"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Purpose"},"children":["Purpose"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]}," filter"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create (USER key)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Detail"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update name/description"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Soft delete (USER key)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/deployment-status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Publish / pause"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/analytics"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Usage analytics"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/conversations"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List conversations"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/public/v1/agents/{agentId}/conversations/{conversationId}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conversation transcript"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full list in the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/reference/openapi"},"children":["API Reference"]}]}," under the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Agents"]}," tag."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"cli","__idx":7},"children":["CLI"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"frontline agents list --status active --table\nfrontline agents create --name \"Support Agent\"\nfrontline agents agent-setting update --data '{\"instructions\":\"Answer concisely.\",\"aiModelId\":1}'\nfrontline agents deploy --offline false\nfrontline agents conversations --table\nfrontline agents conversations get 42 --pretty\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Agent-scoped CLI commands use the active agent saved in the current profile. Override per-call with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--agent-id <id>"]},"."]}]},"headings":[{"value":"Agents","id":"agents","depth":1},{"value":"Identity","id":"identity","depth":2},{"value":"Sub-resources","id":"sub-resources","depth":2},{"value":"Reading conversations & transcripts","id":"reading-conversations--transcripts","depth":2},{"value":"Capturing contact info creates a Person automatically","id":"capturing-contact-info-creates-a-person-automatically","depth":2},{"value":"Deployment lifecycle","id":"deployment-lifecycle","depth":2},{"value":"Operations","id":"operations","depth":2},{"value":"CLI","id":"cli","depth":2}],"frontmatter":{"seo":{"title":"Agents"}},"lastModified":"2026-06-05T04:52:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/concepts/agents","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}