# Agent (/api/reference/objects/agent)

An agent that works for a workspace: it reads a candidate or a job and acts on it, such as screening or research. Every workspace starts with Kith ATS's standard set.

```graphql
type Agent {
  hire: AgentHire
  id: ID!
  isEnabled: Boolean!
  kind: AgentKind
  name: String!
  role: String!
}
```

### Fields [#fields]

#### [`Agent.hire`](#hire) · [`AgentHire`](/api/reference/objects/agent-hire) `object` [#hire]
The terms the workspace hired this agent on. Null for the agents every workspace gets, which are not billed.

#### [`Agent.id`](#id) · [`ID!`](/api/reference/scalars/id) `non-null` `scalar` [#id]
The agent's id.

#### [`Agent.isEnabled`](#is-enabled) · [`Boolean!`](/api/reference/scalars/boolean) `non-null` `scalar` [#is-enabled]
False when the agent has been switched off or its hire ended. It is then not offered and `runAgent` refuses it.

#### [`Agent.kind`](#kind) · [`AgentKind`](/api/reference/enums/agent-kind) `enum` [#kind]
Which of Kith ATS's standard agents this is. Null for an agent the workspace hired with its own instructions.

#### [`Agent.name`](#name) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#name]
The agent's name, as shown where a person picks one.

#### [`Agent.role`](#role) · [`String!`](/api/reference/scalars/string) `non-null` `scalar` [#role]
What the agent does, as a short label.

### Returned By [#returned-by]

[`agent`](/api/reference/queries/agent)  `query`

### Member Of [#member-of]

[`AddDefaultAgentsPayload`](/api/reference/objects/add-default-agents-payload)  `object` · [`AgentBillingPeriod`](/api/reference/objects/agent-billing-period)  `object` · [`AgentEdge`](/api/reference/objects/agent-edge)  `object` · [`AgentRun`](/api/reference/objects/agent-run)  `object` · [`HireAgentPayload`](/api/reference/objects/hire-agent-payload)  `object` · [`TerminateAgentPayload`](/api/reference/objects/terminate-agent-payload)  `object`