Update a Feedback dataset#

Oftentimes datasets that we have created previously need modifications or updates. In this section, we will explore some of the most common workflows to change an existing Feedback dataset in Argilla.

Remember that you will need to connect to Argilla to perform any of the actions below.

rg.init(
    api_url="<ARGILLA_API_URL>",
    api_key="<ARGILLA_API_KEY>
)

Add more records#

To add a (list of) Feedback record(s) to an existing dataset you will only need to load the dataset using the Python client and use the add_records method as explained below:

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# list of Feedback records to add
new_records = [...]
# add records to the dataset
dataset.add_records(new_records)

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# list of Feedback records to add
new_records = [...]
# add records to the dataset
dataset.add_records(new_records)
# push the dataset to Argilla
dataset.push_to_argilla()

To learn about the format that these records follow, check this page or go to our cheatsheet.

Delete existing records#

From v1.14.0 it is also possible to delete records from a Feedback dataset using the delete method like so:

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# delete a specific record
dataset.records[0].delete()

If you prefer to delete a list of records, you can also achive this in this way:

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# delete a list of records from a dataset
dataset.delete_records([record for record in dataset.records[:5]])

Add or update suggestions in existing records#

You can also add suggestions to records that have been already pushed to Argilla and from v1.14.0 update existing ones.

You can add or update existing suggestions from Argilla v1.14.0 using this method.

Note

If you include in this method a suggestion for a question that already has one, this will overwrite the previous suggestion.

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# loop through the records and add suggestions
for record in dataset.records:
    record.update(suggestions=[...])

This method will only add suggestions to records that don’t have them. To update suggestions, upgrade to v1.14.0 or higher and follow the snippet in the other tab.

# load the dataset
dataset = rg.FeedbackDataset.from_argilla(name="my_dataset", workspace="my_workspace")
# loop through the records and add suggestions
for record in dataset.records:
    record.set_suggestions([...])
dataset.push_to_argilla()

To learn about the schema that these suggestions should follow check this page.