docs: clarify json crew quickstart guidance

This commit is contained in:
Joao Moura
2026-06-16 08:39:42 -07:00
parent 5b766f999f
commit 49cb1cd2a2
5 changed files with 14 additions and 6 deletions

View File

@@ -44,13 +44,14 @@ research_crew/
## الخطوة 2: تعريف الـ Agents
أنشئ ملفين للـ Agents. اسم الملف هو الاسم الذي تشير إليه في `crew.jsonc`.
استبدل ملف `agents/researcher.jsonc` المُنشأ وأضف `agents/analyst.jsonc`. اسم الملف هو الاسم الذي تشير إليه في `crew.jsonc`.
```jsonc agents/researcher.jsonc
{
"role": "Senior Research Specialist for {topic}",
"goal": "Find comprehensive and accurate information about {topic}, with a focus on recent developments and key insights.",
"backstory": "You are an experienced research specialist who organizes complex information into clear, useful notes.",
// استبدله بالنموذج الذي تستخدمه، مثل "openai/gpt-4o".
"llm": "provider/model-id",
"tools": ["SerperDevTool"],
"settings": {
@@ -65,6 +66,7 @@ research_crew/
"role": "Report Analyst for {topic}",
"goal": "Turn research findings into a clear, well-structured report.",
"backstory": "You are a careful analyst with strong technical writing skills and a talent for extracting useful insights.",
// استبدله بالنموذج الذي تستخدمه، مثل "openai/gpt-4o".
"llm": "provider/model-id",
"settings": {
"verbose": true,

View File

@@ -46,13 +46,14 @@ Need the older `crew.py`, `config/agents.yaml`, and `config/tasks.yaml` layout?
## Step 2: Define Your Agents
Create two agent files. The file names are the names you reference from `crew.jsonc`.
Replace the generated `agents/researcher.jsonc` file and add `agents/analyst.jsonc`. The file names are the names you reference from `crew.jsonc`.
```jsonc agents/researcher.jsonc
{
"role": "Senior Research Specialist for {topic}",
"goal": "Find comprehensive and accurate information about {topic}, with a focus on recent developments and key insights.",
"backstory": "You are an experienced research specialist who organizes complex information into clear, useful notes.",
// Replace with your model, for example "openai/gpt-4o".
"llm": "provider/model-id",
"tools": ["SerperDevTool"],
"settings": {
@@ -67,6 +68,7 @@ Create two agent files. The file names are the names you reference from `crew.js
"role": "Report Analyst for {topic}",
"goal": "Turn research findings into a clear, well-structured report.",
"backstory": "You are a careful analyst with strong technical writing skills and a talent for extracting useful insights.",
// Replace with your model, for example "openai/gpt-4o".
"llm": "provider/model-id",
"settings": {
"verbose": true,

View File

@@ -147,7 +147,7 @@ If you have not installed CrewAI yet, follow the [installation guide](/en/instal
```
<Tip>
If your package name differs from `latest_ai_flow`, change the import of `ResearchCrew` to match your projects module path.
If your package name differs from `latest_ai_flow`, change the `kickoff_content_crew` import to match your projects module path.
</Tip>
</Step>
@@ -198,7 +198,7 @@ If you have not installed CrewAI yet, follow the [installation guide](/en/instal
## How this run fits together
1. **Flow** — `LatestAiFlow` runs `prepare_topic` first, then `run_research`, then `summarize`. State (`topic`, `report`) lives on the Flow.
2. **Crew** — `ResearchCrew` runs one task with one agent: the researcher uses **Serper** to search the web, then writes the structured report.
2. **Crew** — `kickoff_content_crew` loads `crew.jsonc` and runs one task with one agent: the researcher uses **Serper** to search the web, then writes the structured report.
3. **Artifact** — The tasks `output_file` writes the report under `output/report.md`.
To go deeper on Flow patterns (routing, persistence, human-in-the-loop), see [Build your first Flow](/en/guides/flows/first-flow) and [Flows](/en/concepts/flows). For crews without a Flow, see [Crews](/en/concepts/crews). For a single `Agent` and `kickoff()` without tasks, see [Agents](/en/concepts/agents#direct-agent-interaction-with-kickoff).

View File

@@ -44,13 +44,14 @@ research_crew/
## 2단계: 에이전트 정의
두 에이전트 파일을 만듭니다. 파일 이름이 `crew.jsonc`에서 참조하는 에이전트 이름입니다.
생성된 `agents/researcher.jsonc` 파일을 교체하고 `agents/analyst.jsonc`를 추가합니다. 파일 이름이 `crew.jsonc`에서 참조하는 에이전트 이름입니다.
```jsonc agents/researcher.jsonc
{
"role": "Senior Research Specialist for {topic}",
"goal": "Find comprehensive and accurate information about {topic}, with a focus on recent developments and key insights.",
"backstory": "You are an experienced research specialist who organizes complex information into clear, useful notes.",
// 사용하는 모델로 바꾸세요. 예: "openai/gpt-4o".
"llm": "provider/model-id",
"tools": ["SerperDevTool"],
"settings": {
@@ -65,6 +66,7 @@ research_crew/
"role": "Report Analyst for {topic}",
"goal": "Turn research findings into a clear, well-structured report.",
"backstory": "You are a careful analyst with strong technical writing skills and a talent for extracting useful insights.",
// 사용하는 모델로 바꾸세요. 예: "openai/gpt-4o".
"llm": "provider/model-id",
"settings": {
"verbose": true,

View File

@@ -46,13 +46,14 @@ Precisa do layout antigo com `crew.py`, `config/agents.yaml` e `config/tasks.yam
## Etapa 2: Definir os agentes
Crie dois arquivos de agentes. Os nomes dos arquivos são os nomes referenciados em `crew.jsonc`.
Substitua o arquivo gerado `agents/researcher.jsonc` e adicione `agents/analyst.jsonc`. Os nomes dos arquivos são os nomes referenciados em `crew.jsonc`.
```jsonc agents/researcher.jsonc
{
"role": "Senior Research Specialist for {topic}",
"goal": "Find comprehensive and accurate information about {topic}, with a focus on recent developments and key insights.",
"backstory": "You are an experienced research specialist who organizes complex information into clear, useful notes.",
// Substitua pelo seu modelo, por exemplo "openai/gpt-4o".
"llm": "provider/model-id",
"tools": ["SerperDevTool"],
"settings": {
@@ -67,6 +68,7 @@ Crie dois arquivos de agentes. Os nomes dos arquivos são os nomes referenciados
"role": "Report Analyst for {topic}",
"goal": "Turn research findings into a clear, well-structured report.",
"backstory": "You are a careful analyst with strong technical writing skills and a talent for extracting useful insights.",
// Substitua pelo seu modelo, por exemplo "openai/gpt-4o".
"llm": "provider/model-id",
"settings": {
"verbose": true,