From 49cb1cd2a21a32f394169204c7e6731a4254ea39 Mon Sep 17 00:00:00 2001 From: Joao Moura Date: Tue, 16 Jun 2026 08:39:42 -0700 Subject: [PATCH] docs: clarify json crew quickstart guidance --- docs/ar/guides/crews/first-crew.mdx | 4 +++- docs/en/guides/crews/first-crew.mdx | 4 +++- docs/en/quickstart.mdx | 4 ++-- docs/ko/guides/crews/first-crew.mdx | 4 +++- docs/pt-BR/guides/crews/first-crew.mdx | 4 +++- 5 files changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/ar/guides/crews/first-crew.mdx b/docs/ar/guides/crews/first-crew.mdx index b83e8fc54..db51d2ae7 100644 --- a/docs/ar/guides/crews/first-crew.mdx +++ b/docs/ar/guides/crews/first-crew.mdx @@ -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, diff --git a/docs/en/guides/crews/first-crew.mdx b/docs/en/guides/crews/first-crew.mdx index e5f5f7dd5..9665a293a 100644 --- a/docs/en/guides/crews/first-crew.mdx +++ b/docs/en/guides/crews/first-crew.mdx @@ -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, diff --git a/docs/en/quickstart.mdx b/docs/en/quickstart.mdx index 0e7c80aa4..ee996f770 100644 --- a/docs/en/quickstart.mdx +++ b/docs/en/quickstart.mdx @@ -147,7 +147,7 @@ If you have not installed CrewAI yet, follow the [installation guide](/en/instal ``` - If your package name differs from `latest_ai_flow`, change the import of `ResearchCrew` to match your project’s module path. + If your package name differs from `latest_ai_flow`, change the `kickoff_content_crew` import to match your project’s module path. @@ -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 task’s `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). diff --git a/docs/ko/guides/crews/first-crew.mdx b/docs/ko/guides/crews/first-crew.mdx index c4384661b..9362c5948 100644 --- a/docs/ko/guides/crews/first-crew.mdx +++ b/docs/ko/guides/crews/first-crew.mdx @@ -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, diff --git a/docs/pt-BR/guides/crews/first-crew.mdx b/docs/pt-BR/guides/crews/first-crew.mdx index a2b201036..6325ff528 100644 --- a/docs/pt-BR/guides/crews/first-crew.mdx +++ b/docs/pt-BR/guides/crews/first-crew.mdx @@ -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,