Fields¶
Fields in Argilla define the content of a record that will be reviewed by a user.
Usage Examples¶
To define a field, instantiate the different field classes and pass it to the fields
parameter of the Settings
class.
text_field = rg.TextField(name="text")
markdown_field = rg.TextField(name="text", use_markdown=True)
image_field = rg.ImageField(name="image")
The fields
parameter of the Settings
class can accept a list of fields, like this:
settings = rg.Settings(
fields=[
text_field,
markdown_field,
image_field,
],
questions=[
rg.TextQuestion(name="response"),
],
)
data = rg.Dataset(
name="my_dataset",
settings=settings,
)
To add records with values for fields, refer to the
rg.Dataset.records
documentation.
TextField
¶
Bases: FieldBase
Text field for use in Argilla Dataset
Settings
Source code in src/argilla/settings/_field.py
__init__(name, title=None, use_markdown=False, required=True, description=None, client=None)
¶
Text field for use in Argilla Dataset
Settings
Parameters:
name (str): The name of the field
title (Optional[str], optional): The title of the field. Defaults to None.
use_markdown (Optional[bool], optional): Whether to use markdown. Defaults to False.
required (bool): Whether the field is required. Defaults to True.
description (Optional[str], optional): The description of the field. Defaults to None.
Source code in src/argilla/settings/_field.py
ImageField
¶
Bases: FieldBase
Image field for use in Argilla Dataset
Settings
Source code in src/argilla/settings/_field.py
__init__(name, title=None, required=True, description=None, _client=None)
¶
Text field for use in Argilla Dataset
Settings
Parameters:
Name | Type | Description | Default |
---|---|---|---|
name |
str
|
The name of the field |
required |
title |
Optional[str]
|
The title of the field. Defaults to None. |
None
|
required |
Optional[bool]
|
Whether the field is required. Defaults to True. |
True
|
description |
Optional[str]
|
The description of the field. Defaults to None. |
None
|
Source code in src/argilla/settings/_field.py
ChatField
¶
Bases: FieldBase
Chat field for use in Argilla Dataset
Settings
Source code in src/argilla/settings/_field.py
__init__(name, title=None, use_markdown=True, required=True, description=None, _client=None)
¶
Chat field for use in Argilla Dataset
Settings
Parameters:
Name | Type | Description | Default |
---|---|---|---|
name |
str
|
The name of the field |
required |
title |
Optional[str]
|
The title of the field. Defaults to None. |
None
|
use_markdown |
Optional[bool]
|
Whether to use markdown. Defaults to True. |
True
|
required |
bool
|
Whether the field is required. Defaults to True. |
True
|
description |
Optional[str]
|
The description of the field. Defaults to None. |
None
|
Source code in src/argilla/settings/_field.py
CustomField
¶
Bases: FieldBase
Custom field for use in Argilla Dataset
Settings
Source code in src/argilla/settings/_field.py
__init__(name, title=None, template='', advanced_mode=False, required=True, description=None, _client=None)
¶
Custom field for use in Argilla Dataset
Settings
for working with custom HTML and CSS templates.
By default argilla will use a brackets syntax engine for the templates, which converts
{{ field.key }}
to the values of record's field's object.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
name |
str
|
The name of the field |
required |
title |
Optional[str]
|
The title of the field. Defaults to None. |
None
|
template |
str
|
The template of the field (HTML and CSS) |
''
|
advanced_mode |
Optional[bool]
|
Whether to use advanced mode. Defaults to False. Deactivate the brackets syntax engine and use custom javascript to render the field. |
False
|
required |
Optional[bool]
|
Whether the field is required. Defaults to True. |
True
|
required |
bool
|
Whether the field is required. Defaults to True. |
True
|
description |
Optional[str]
|
The description of the field. Defaults to None. |
None
|