feat: Add adapter for CrewAI #359

XiuShenAl · 2025-12-31T07:47:55Z

Description

Support CrewAI

Type of Change

Component(s) Affected

Checklist

Pre-commit hooks pass
Tests pass locally
Documentation updated (if needed)
Ready for review

rayrayraykk · 2026-01-04T06:47:41Z

Due to incompatibility between the current crewAI version and the latest OpenAI release, the integration with our existing components is currently non-functional. We recommend postponing changes depending on crewAI until an official fix is provided.

Reference issue: crewAIInc/crewAI#4079

As for the incompatibility with Otel, we should separate ms-agent-framework and crewAI into two optional installation groups to reduce coupling and minimize potential conflicts.

Copilot

Pull request overview

This PR adds comprehensive CrewAI framework adapter support to AgentScope Runtime, enabling developers to build collaborative autonomous agents with multi-turn conversations, session memory, and streaming responses.

Key Changes:

Adds CrewAI adapter implementation with message conversion, streaming, memory, and tool adapters
Integrates CrewAI as a supported framework in the engine (runner, constants, and app registration)
Includes comprehensive integration tests and bilingual documentation

Reviewed changes

Copilot reviewed 16 out of 17 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
`tests/integrated/test_crewai_agent_app.py`	Integration tests for CrewAI adapter with streaming, OpenAI-compatible mode, and multi-turn conversation tests
`src/agentscope_runtime/engine/runner.py`	Adds CrewAI message stream adapter integration in the streaming query handler
`src/agentscope_runtime/engine/constant.py`	Registers "crewai" as a supported framework
`src/agentscope_runtime/engine/app/agent_app.py`	Adds "crewai" to allowed frameworks in query decorator
`src/agentscope_runtime/adapters/crewai/message.py`	Converts AgentScope runtime messages to CrewAI-compatible format
`src/agentscope_runtime/adapters/crewai/stream.py`	Adapts CrewAI streaming chunks to runtime message format with reasoning/message mode parsing
`src/agentscope_runtime/adapters/crewai/memory/_external_memory_adapter.py`	CrewAI external memory adapter using SessionHistoryService for persistence
`src/agentscope_runtime/adapters/crewai/tool/tool.py`	Tool adapter converting runtime tools to CrewAI BaseTool format
`cookbook/en/crewai_guidelines.md`	English documentation guide for CrewAI integration
`cookbook/zh/crewai_guidelines.md`	Chinese documentation guide for CrewAI integration
`pyproject.toml`	Adds crewai>=1.6.1 dependency to ext optional dependencies
`README.md` / `README_zh.md`	Updates framework support table with CrewAI entry
`cookbook/_toc.yml`	Adds CrewAI guidelines to documentation table of contents

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-01-04T06:52:20Z

tests/integrated/test_crewai_agent_app.py

@@ -0,0 +1,280 @@
+# -*- coding: utf-8 -*-
+# tests/api/test_crewai_agent_app.py


The file path comment is incorrect. It states "tests/api/test_crewai_agent_app.py" but the actual file is located at "tests/integrated/test_crewai_agent_app.py". This should be updated to match the actual file location.

Suggested change

# tests/api/test_crewai_agent_app.py

# tests/integrated/test_crewai_agent_app.py

Copilot · 2026-01-04T06:52:20Z

tests/integrated/test_crewai_agent_app.py

+                f"Investigate the following user query: '{user_question}'"
+            ),
+            expected_output=(
+                "A comprehensive yet easy-to-read answer"


Missing space in the concatenated string. The expected output should have a space between "answer" and "that" for readability.

Suggested change

"A comprehensive yet easy-to-read answer"

"A comprehensive yet easy-to-read answer "

Copilot · 2026-01-04T06:52:20Z

src/agentscope_runtime/adapters/crewai/message.py

+    agno_message = await formatter.format(as_msgs)
+
+    return agno_message if raw_list else agno_message[0]


The variable name "agno_message" is misleading. This is a CrewAI adapter, not an Agno adapter, so the variable should be named "crewai_message" or a more generic name like "formatted_message" to accurately reflect its purpose.

Suggested change

agno_message = await formatter.format(as_msgs)

return agno_message if raw_list else agno_message[0]

crewai_message = await formatter.format(as_msgs)

return crewai_message if raw_list else crewai_message[0]

Copilot · 2026-01-04T06:52:21Z

src/agentscope_runtime/adapters/crewai/message.py

+    agno_message = await formatter.format(as_msgs)
+
+    return agno_message if raw_list else agno_message[0]


The variable name "agno_message" is misleading. This is a CrewAI adapter, not an Agno adapter, so the variable should be named "crewai_message" or a more generic name like "formatted_message" to accurately reflect its purpose.

Suggested change

agno_message = await formatter.format(as_msgs)

return agno_message if raw_list else agno_message[0]

crewai_message = await formatter.format(as_msgs)

return crewai_message if raw_list else crewai_message[0]

Copilot · 2026-01-04T06:52:21Z

src/agentscope_runtime/adapters/crewai/stream.py

+
+                break
+        # elif event.chunk_type == StreamChunkType.TOOL_CALL:
+        # Not support now


Grammatical error in the comment. "Not support now" should be "Not supported now" for correct grammar.

Suggested change

# Not support now

# Not supported now

Copilot · 2026-01-04T06:52:21Z

src/agentscope_runtime/adapters/crewai/message.py

+
+async def message_to_crewai_message(
+    messages: Union[Message, List[Message]],
+) -> Union[dict, List[dict]]:


Missing docstring for the function. Based on similar adapters (e.g., the Agno adapter), this function should include a docstring that explains what the function does, its arguments, and return values. For example: "Convert AgentScope runtime Message(s) to CrewAI Message(s)."

Suggested change

) -> Union[dict, List[dict]]:

) -> Union[dict, List[dict]]:

"""

Convert AgentScope runtime Message(s) to CrewAI-compatible message dict(s).

This function first converts the given AgentScope runtime ``Message`` or list

of ``Message`` objects into AgentScope messages, and then uses

``OpenAIChatFormatter`` to produce CrewAI-compatible message dictionaries.

Args:

messages: A single ``Message`` instance or a list of ``Message`` instances

from the AgentScope runtime.

Returns:

A single dictionary if ``messages`` is a single ``Message``; otherwise a

list of dictionaries, each representing a CrewAI-compatible message.

"""

Copilot · 2026-01-04T06:52:22Z

src/agentscope_runtime/adapters/crewai/memory/_external_memory_adapter.py

+                obs_json = json.loads(obs_text)
+                if isinstance(obs_json, dict) and "request_id" in obs_json:
+                    call_id = obs_json["request_id"]
+            except (json.JSONDecodeError, TypeError):


'except' clause does nothing but pass and there is no explanatory comment.

Suggested change

except (json.JSONDecodeError, TypeError):

except (json.JSONDecodeError, TypeError):

# If the observation text is not valid JSON or does not have the

# expected structure, we ignore the error and fall back to

# generating a new call_id below.

Copilot · 2026-01-04T06:52:22Z

tests/integrated/test_crewai_agent_app.py

+                            ].lower()
+                            if "alice" in text_content:
+                                found_name = True
+                        except Exception:


'except' clause does nothing but pass and there is no explanatory comment.

Suggested change

except Exception:

except Exception:

# Ignore malformed or unexpected output chunks; only well-formed

# responses should contribute to found_name in this streaming test.

XiuShenAl requested a review from a team December 31, 2025 07:47

XiuShenAl force-pushed the feat/crewai-adapter branch from bc4acbb to e9e510c Compare January 4, 2026 03:30

feat: Add adapter for CrewAI

bca1c50

XiuShenAl force-pushed the feat/crewai-adapter branch from e9e510c to bca1c50 Compare January 4, 2026 03:48

rayrayraykk requested a review from Copilot January 4, 2026 06:48

Copilot started reviewing on behalf of rayrayraykk January 4, 2026 06:48 View session

Copilot AI reviewed Jan 4, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat: Add adapter for CrewAI #359

feat: Add adapter for CrewAI #359

Uh oh!

XiuShenAl commented Dec 31, 2025

Uh oh!

rayrayraykk commented Jan 4, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Copilot AI Jan 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

		@@ -0,0 +1,280 @@
		# -- coding: utf-8 --
		# tests/api/test_crewai_agent_app.py

	# tests/api/test_crewai_agent_app.py
	# tests/integrated/test_crewai_agent_app.py

	"A comprehensive yet easy-to-read answer"
	"A comprehensive yet easy-to-read answer "

		agno_message = await formatter.format(as_msgs)

		return agno_message if raw_list else agno_message[0]

-) -> Union[dict, List[dict]]:
+) -> Union[dict, List[dict]]:
+    """
+    Convert AgentScope runtime Message(s) to CrewAI-compatible message dict(s).
+    This function first converts the given AgentScope runtime ``Message`` or list
+    of ``Message`` objects into AgentScope messages, and then uses
+    ``OpenAIChatFormatter`` to produce CrewAI-compatible message dictionaries.
+    Args:
+        messages: A single ``Message`` instance or a list of ``Message`` instances
+            from the AgentScope runtime.
+    Returns:
+        A single dictionary if ``messages`` is a single ``Message``; otherwise a
+        list of dictionaries, each representing a CrewAI-compatible message.
+    """

-            except (json.JSONDecodeError, TypeError):
+            except (json.JSONDecodeError, TypeError):
+                # If the observation text is not valid JSON or does not have the
+                # expected structure, we ignore the error and fall back to
+                # generating a new call_id below.

feat: Add adapter for CrewAI #359

Are you sure you want to change the base?

feat: Add adapter for CrewAI #359

Uh oh!

Conversation

XiuShenAl commented Dec 31, 2025

Description

Type of Change

Component(s) Affected

Checklist

Uh oh!

rayrayraykk commented Jan 4, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Jan 4, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants