> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Attention Create Field Configuration Item: Inputs, Cost &
> Create Field Configuration Item. Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=attention_create_field_configuration_item:{"id":"{{id}}","title":"{{title}}","category":"CRM","contents":"{{contents}}","promptType":"{{promptType}}","contentType":"{{contentType}}"}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| --------------------------- | -------------------------------------------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.id` | `string` | Yes | | UUID of the field configuration. |
| `payload.title` | `string` | Yes | | Short human-readable title of the item. Trimmed; 1-128 characters. |
| `payload.category` | `"CRM" \| "Indicators" \| "BuiltInInsight" \| "CustomInsight"` | Yes | | Category of the item. |
| `payload.contents` | `string` | Yes | | Prompt text that Attention will evaluate against each conversation. |
| `payload.description` | `string` | No | | Optional longer description. 0-2000 characters. |
| `payload.promptType` | `string` | Yes | | Prompt family used to analyze the conversation. |
| `payload.contentType` | `string` | Yes | | Expected shape of the extracted content. |
| `payload.responseType` | `string` | No | | Optional response data type hint. |
| `payload.options` | `array` | No | | Optional allowed response values for multiple-choice items. |
| `payload.dependsOn` | `array` | No | | UUIDs of other items this item depends on. |
| `payload.maxValues` | `integer` | No | | Maximum number of values allowed for multi-select items. |
| `payload.allowLongResponse` | `boolean` | No | | Whether the analyzer may produce a longer free-text response. |
| `payload.extractQuotes` | `boolean` | No | | Whether the analyzer should attach supporting quotes to the response. |
| `payload.analysisLevel` | `"conversation" \| "deal" \| "lead" \| "contact" \| "account"` | No | | Level at which the item is evaluated. |
| `payload.metadata` | `object` | No | | Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`. |
| `payload.displayOrder` | `integer` | No | | Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one. |
| `payload.requestStage` | `integer` | No | | Optional analysis stage in which the resulting assignments are evaluated. |
### Allowed values
| Field | Allowed values |
| ----------------------- | ------------------------------------------------------ |
| `payload.category` | `CRM`, `Indicators`, `BuiltInInsight`, `CustomInsight` |
| `payload.analysisLevel` | `conversation`, `deal`, `lead`, `contact`, `account` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Request payload for creating a single new item inside a field configuration. The REST endpoint wraps this singular request into the underlying bulk creation path (ADR-9). Creating an item fans out into one `IntelligenceItemAssignment` per team the parent configuration is assigned to - the response returns the list of created assignments.",
"properties": {
"id": {
"type": "string",
"description": "UUID of the field configuration."
},
"title": {
"type": "string",
"description": "Short human-readable title of the item. Trimmed; 1-128 characters."
},
"category": {
"type": "string",
"description": "Category of the item.",
"enum": [
"CRM",
"Indicators",
"BuiltInInsight",
"CustomInsight"
]
},
"contents": {
"type": "string",
"description": "Prompt text that Attention will evaluate against each conversation."
},
"description": {
"type": "string",
"description": "Optional longer description. 0-2000 characters."
},
"promptType": {
"type": "string",
"description": "Prompt family used to analyze the conversation."
},
"contentType": {
"type": "string",
"description": "Expected shape of the extracted content."
},
"responseType": {
"type": "string",
"description": "Optional response data type hint."
},
"options": {
"type": "array",
"description": "Optional allowed response values for multiple-choice items.",
"items": {
"type": "string"
}
},
"dependsOn": {
"type": "array",
"description": "UUIDs of other items this item depends on.",
"items": {
"type": "string"
}
},
"maxValues": {
"type": [
"integer",
"null"
],
"description": "Maximum number of values allowed for multi-select items."
},
"allowLongResponse": {
"type": "boolean",
"description": "Whether the analyzer may produce a longer free-text response."
},
"extractQuotes": {
"type": "boolean",
"description": "Whether the analyzer should attach supporting quotes to the response."
},
"analysisLevel": {
"type": "string",
"description": "Level at which the item is evaluated.",
"enum": [
"conversation",
"deal",
"lead",
"contact",
"account"
]
},
"metadata": {
"type": "object",
"description": "Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`.",
"properties": {
"min_score": {
"type": "number",
"description": "Minimum allowed score value.",
"format": "double"
},
"max_score": {
"type": "number",
"description": "Maximum allowed score value.",
"format": "double"
},
"middle_score": {
"type": [
"number",
"null"
],
"description": "Optional midpoint score value, used by scoring heuristics.",
"format": "double"
},
"min_criteria": {
"type": "string",
"description": "Human-readable description of what the minimum score means."
},
"max_criteria": {
"type": "string",
"description": "Human-readable description of what the maximum score means."
},
"middle_criteria": {
"type": [
"string",
"null"
],
"description": "Human-readable description of what the middle score means."
}
},
"additionalProperties": false
},
"displayOrder": {
"type": [
"integer",
"null"
],
"description": "Optional starting position in the team's ordered item list; existing assignments at or after this position are shifted by one."
},
"requestStage": {
"type": "integer",
"description": "Optional analysis stage in which the resulting assignments are evaluated."
}
},
"required": [
"id",
"category",
"contentType",
"contents",
"promptType",
"title"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `result.data` | `object` | Yes | | Envelope returned when a field-configuration item is created. The `data.assignments` array documents the fan-out (one entry per team the parent configuration is assigned to). |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Envelope returned when a field-configuration item is created. The `data.assignments` array documents the fan-out (one entry per team the parent configuration is assigned to).",
"properties": {
"data": {
"type": "object",
"description": "Create-item payload: the newly created item plus the fan-out `IntelligenceItemAssignment` rows - one per team the parent field configuration is assigned to.",
"properties": {
"item": {
"type": "object",
"description": "A single field within a Field Configuration (internally `IntelligenceItem`). Items describe a prompt that Attention evaluates against a conversation and produces a value for. A field-configuration item is cloned as one `IntelligenceItemAssignment` per team the parent configuration is assigned to - see `IntelligenceItemAssignment`.",
"properties": {
"uuid": {
"type": "string",
"description": "Unique identifier of the item."
},
"fieldConfigurationUUID": {
"type": "string",
"description": "UUID of the parent field configuration."
},
"title": {
"type": "string",
"description": "Short human-readable title of the item. Trimmed; 1-128 characters."
},
"category": {
"type": "string",
"description": "Category of the item. One of the intelligence-category enum values.",
"enum": [
"CRM",
"Indicators",
"BuiltInInsight",
"CustomInsight"
]
},
"contents": {
"type": "string",
"description": "Prompt text that Attention will evaluate against each conversation."
},
"description": {
"type": "string",
"description": "Optional longer description shown to end users. 0-2000 characters."
},
"promptType": {
"type": "string",
"description": "Prompt family used to analyze the conversation."
},
"contentType": {
"type": "string",
"description": "Expected shape of the extracted content."
},
"responseType": {
"type": "string",
"description": "Optional response data type hint."
},
"options": {
"type": "array",
"description": "Optional allowed response values when the item is a multiple-choice field.",
"items": {
"type": "string"
}
},
"dependsOn": {
"type": "array",
"description": "UUIDs of other items this item depends on.",
"items": {
"type": "string"
}
},
"maxValues": {
"type": "integer",
"description": "Maximum number of values allowed for multi-select items."
},
"allowLongResponse": {
"type": "boolean",
"description": "Whether the analyzer may produce a longer free-text response."
},
"extractQuotes": {
"type": "boolean",
"description": "Whether the analyzer should attach supporting quotes to the response."
},
"availableToAllClients": {
"type": "boolean",
"description": "Internal flag marking the item as globally available."
},
"analysisLevel": {
"type": "string",
"description": "Level at which the item is evaluated.",
"enum": [
"conversation",
"deal",
"lead",
"contact",
"account"
]
},
"metadata": {
"type": "object",
"description": "Numeric scoring metadata for a field-configuration item. Required when the item represents a numeric score - `min_score` must be less than or equal to `max_score`.",
"properties": {
"min_score": {
"type": "number",
"description": "Minimum allowed score value.",
"format": "double"
},
"max_score": {
"type": "number",
"description": "Maximum allowed score value.",
"format": "double"
},
"middle_score": {
"type": [
"number",
"null"
],
"description": "Optional midpoint score value, used by scoring heuristics.",
"format": "double"
},
"min_criteria": {
"type": "string",
"description": "Human-readable description of what the minimum score means."
},
"max_criteria": {
"type": "string",
"description": "Human-readable description of what the maximum score means."
},
"middle_criteria": {
"type": [
"string",
"null"
],
"description": "Human-readable description of what the middle score means."
}
},
"additionalProperties": false
},
"createdAt": {
"type": "string",
"description": "Timestamp when the item was created.",
"format": "date-time"
},
"lastModifiedAt": {
"type": "string",
"description": "Timestamp when the item was last updated.",
"format": "date-time"
}
},
"required": [
"allowLongResponse",
"availableToAllClients",
"category",
"contentType",
"contents",
"createdAt",
"extractQuotes",
"fieldConfigurationUUID",
"lastModifiedAt",
"promptType",
"title",
"uuid"
],
"additionalProperties": false
},
"assignments": {
"type": "array",
"description": "Assignment rows created as part of the fan-out. For a configuration assigned to N teams, N assignments are returned.",
"items": {
"type": "object",
"description": "One row of the fan-out produced when a field-configuration item is created or updated: a single item is expanded into N `IntelligenceItemAssignment` rows, one per team the parent configuration is assigned to.",
"properties": {
"uuid": {
"type": "string",
"description": "Unique identifier of the assignment row."
},
"intelligenceItemUUID": {
"type": "string",
"description": "UUID of the underlying field-configuration item this assignment points at."
},
"teamUUID": {
"type": "string",
"description": "UUID of the team this assignment applies to."
},
"organizationUUID": {
"type": "string",
"description": "UUID of the organization this assignment belongs to."
},
"category": {
"type": "string",
"description": "Category of the underlying item (copied from the item at assignment time)."
},
"displayOrder": {
"type": "integer",
"description": "Position of this assignment in the team's ordered list of items."
},
"requestStage": {
"type": "integer",
"description": "Analysis stage in which this assignment is evaluated."
},
"createdAt": {
"type": "string",
"description": "Timestamp when the assignment was created.",
"format": "date-time"
},
"lastModifiedAt": {
"type": "string",
"description": "Timestamp when the assignment was last updated.",
"format": "date-time"
}
},
"required": [
"category",
"createdAt",
"intelligenceItemUUID",
"lastModifiedAt",
"teamUUID",
"uuid"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute attention_create_field_configuration_item --payload '{
"id": "string",
"title": "string",
"category": "CRM",
"contents": "string",
"promptType": "string",
"contentType": "string"
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.