Agents
Retrieve an agent
Retrieves the agent with the given ID.
GET
/
agents
/
{agent_id}
Path Parameters
agent_id
string
requiredThe unique identifier of the agent
Response
200 - application/json
<p>An _agent_ is an AI entity that exists to serve your project's users. Agents are intelligent, configurable and context-aware and can interact with your users via a messaging system enabled by the Proficient API.</p>
id
string
requiredThe unique identifier of the agent
object
enum<string>
requiredThe type of the Agent
object
Available options:
agent
active
boolean
requiredWhether the agent is currently active. If not, users will not be able to interact with the agent.
description
string
requiredThe description of the agent, intended for developers' reference.
display_description
string
requiredThe agent's public-facing description, meant to be visible to your users.
display_name
string
requiredThe agent's display name, intended to serve as the public-facing name visible to your users.
name
string
requiredThe name of the agent, designed to be visible to developers for internal reference purposes.
created_at
integer
requiredThe time at which the object was created, measured in milliseconds since the Unix epoch
updated_at
integer
requiredThe time at which the object was last updated, measured in milliseconds since the Unix epoch