mirror of
https://github.com/crewAIInc/crewAI.git
synced 2026-01-08 23:58:34 +00:00
* docs(cli): document device-code login and config reset guidance; renumber sections * docs(cli): fix duplicate numbering (renumber Login/API Keys/Configuration sections) * docs: Fix webhook documentation to include meta dict in all webhook payloads - Add note explaining that meta objects from kickoff requests are included in all webhook payloads - Update webhook examples to show proper payload structure including meta field - Fix webhook examples to match actual API implementation - Apply changes to English, Korean, and Portuguese documentation Resolves the documentation gap where meta dict passing to webhooks was not documented despite being implemented in the API. * WIP: CrewAI docs theme, changelog, GEO, localization * docs(cli): fix merge markers; ensure mode: "wide"; convert ASCII tables to Markdown (en/pt-BR/ko) * docs: add group icons across locales; split Automation/Integrations; update tools overviews and links
79 lines
2.8 KiB
Plaintext
79 lines
2.8 KiB
Plaintext
---
|
|
title: Replay Tasks from Latest Crew Kickoff
|
|
description: Replay tasks from the latest crew.kickoff(...)
|
|
icon: arrow-right
|
|
mode: "wide"
|
|
---
|
|
|
|
## Introduction
|
|
|
|
CrewAI provides the ability to replay from a task specified from the latest crew kickoff. This feature is particularly useful when you've finished a kickoff and may want to retry certain tasks or don't need to refetch data over and your agents already have the context saved from the kickoff execution so you just need to replay the tasks you want to.
|
|
|
|
<Note>
|
|
You must run `crew.kickoff()` before you can replay a task.
|
|
Currently, only the latest kickoff is supported, so if you use `kickoff_for_each`, it will only allow you to replay from the most recent crew run.
|
|
</Note>
|
|
|
|
Here's an example of how to replay from a task:
|
|
|
|
### Replaying from Specific Task Using the CLI
|
|
|
|
To use the replay feature, follow these steps:
|
|
|
|
<Steps>
|
|
<Step title="Open your terminal or command prompt."></Step>
|
|
<Step title="Navigate to the directory where your CrewAI project is located."></Step>
|
|
<Step title="Run the following commands:">
|
|
To view the latest kickoff task_ids use:
|
|
|
|
```shell
|
|
crewai log-tasks-outputs
|
|
```
|
|
|
|
Once you have your `task_id` to replay, use:
|
|
|
|
```shell
|
|
crewai replay -t <task_id>
|
|
```
|
|
</Step>
|
|
</Steps>
|
|
|
|
<Note>
|
|
Ensure `crewai` is installed and configured correctly in your development environment.
|
|
</Note>
|
|
|
|
### Replaying from a Task Programmatically
|
|
|
|
To replay from a task programmatically, use the following steps:
|
|
|
|
<Steps>
|
|
<Step title="Specify the `task_id` and input parameters for the replay process.">
|
|
Specify the `task_id` and input parameters for the replay process.
|
|
</Step>
|
|
<Step title="Execute the replay command within a try-except block to handle potential errors.">
|
|
Execute the replay command within a try-except block to handle potential errors.
|
|
<CodeGroup>
|
|
```python Code
|
|
def replay():
|
|
"""
|
|
Replay the crew execution from a specific task.
|
|
"""
|
|
task_id = '<task_id>'
|
|
inputs = {"topic": "CrewAI Training"} # This is optional; you can pass in the inputs you want to replay; otherwise, it uses the previous kickoff's inputs.
|
|
try:
|
|
YourCrewName_Crew().crew().replay(task_id=task_id, inputs=inputs)
|
|
|
|
except subprocess.CalledProcessError as e:
|
|
raise Exception(f"An error occurred while replaying the crew: {e}")
|
|
|
|
except Exception as e:
|
|
raise Exception(f"An unexpected error occurred: {e}")
|
|
```
|
|
</CodeGroup>
|
|
</Step>
|
|
</Steps>
|
|
|
|
## Conclusion
|
|
|
|
With the above enhancements and detailed functionality, replaying specific tasks in CrewAI has been made more efficient and robust.
|
|
Ensure you follow the commands and steps precisely to make the most of these features. |