# Copyright 2024 Bytedance Ltd. and/or its affiliates # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. import json import os from typing import Any import numpy as np import pytest import ray from omegaconf import DictConfig from PIL import Image from transformers.utils import get_json_schema from verl.experimental.agent_loop import AgentLoopManager from verl.protocol import DataProto from verl.tools.base_tool import BaseTool, OpenAIFunctionToolSchema from verl.tools.schemas import ToolResponse from verl.utils import hf_tokenizer @pytest.fixture def init_config() -> DictConfig: from hydra import compose, initialize_config_dir with initialize_config_dir(config_dir=os.path.abspath("verl/trainer/config")): config = compose( config_name="ppo_trainer", overrides=[ "actor_rollout_ref.actor.use_dynamic_bsz=true", # test sleep/wake_up with fsdp offload "actor_rollout_ref.actor.fsdp_config.param_offload=True", "actor_rollout_ref.actor.fsdp_config.optimizer_offload=True", ], ) model_path = os.path.expanduser("~/models/Qwen/Qwen2.5-VL-3B-Instruct") config.actor_rollout_ref.model.path = model_path config.actor_rollout_ref.rollout.name = os.environ["ROLLOUT_NAME"] config.actor_rollout_ref.rollout.mode = "async" config.actor_rollout_ref.rollout.enforce_eager = True config.actor_rollout_ref.rollout.prompt_length = 4096 config.actor_rollout_ref.rollout.response_length = 4096 config.actor_rollout_ref.rollout.n = 4 config.actor_rollout_ref.rollout.agent.num_workers = 2 config.actor_rollout_ref.rollout.skip_tokenizer_init = True return config class ImageGeneratorTool(BaseTool): def generate_image(self, description: str, size: str = "256x256"): """Generate a simple image based on description. Args: description: The description of the image to generate. size: The size of the image. Defaults to "256x256". (choices: ["256x256", "512x512"]) Returns: A generated image """ print(f"[DEBUG] generate_image: {description}, {size}") # Create a simple colored image for testing width, height = map(int, size.split("x")) # Create different colors based on description if "red" in description.lower(): color = (255, 0, 0) elif "blue" in description.lower(): color = (0, 0, 255) elif "green" in description.lower(): color = (0, 255, 0) else: color = (128, 128, 128) # gray # Create image image = Image.new("RGB", (width, height), color) # Add some pattern to make it more interesting for i in range(0, width, 50): for j in range(0, height, 50): # Add white squares in a grid pattern for x in range(i, min(i + 20, width)): for y in range(j, min(j + 20, height)): image.putpixel((x, y), (255, 255, 255)) return image def get_openai_tool_schema(self) -> OpenAIFunctionToolSchema: schema = get_json_schema(self.generate_image) return OpenAIFunctionToolSchema(**schema) async def execute(self, instance_id: str, parameters: dict[str, Any], **kwargs) -> tuple[ToolResponse, float, dict]: try: image = self.generate_image(**parameters) # Return the PIL Image directly - the framework should handle the conversion return ToolResponse(image=[image]), 0, {} except Exception as e: return ToolResponse(text=str(e)), 0, {} def test_multimodal_tool_agent(init_config): """Test agent loop with multimodal tool that returns images using Qwen VL model.""" ray.init( runtime_env={ "env_vars": { "TOKENIZERS_PARALLELISM": "true", "NCCL_DEBUG": "WARN", "VLLM_LOGGING_LEVEL": "INFO", "VLLM_USE_V1": "1", } }, ignore_reinit_error=True, ) # Add custom chat template to enable tool calling support (same as recipe/deepeyes) template_path = os.path.join(os.path.dirname(__file__), "qwen_vl_tool_chat_template.jinja2") with open(template_path, encoding="utf-8") as f: custom_chat_template = f.read() init_config.actor_rollout_ref.model.custom_chat_template = custom_chat_template # =========================== 1. Init rollout manager with image tool =========================== tool_config = { "tools": [ { "class_name": "tests.experimental.agent_loop.test_multi_modal.ImageGeneratorTool", "config": {"type": "native"}, }, ] } tool_config_path = "/tmp/multimodal_tool_config.json" with open(tool_config_path, "w") as f: json.dump(tool_config, f) n = 2 init_config.actor_rollout_ref.rollout.n = n init_config.actor_rollout_ref.rollout.multi_turn.tool_config_path = tool_config_path init_config.actor_rollout_ref.rollout.multi_turn.max_parallel_calls = 1 init_config.actor_rollout_ref.rollout.multi_turn.max_user_turns = 1 agent_loop_manager = AgentLoopManager(init_config) # =========================== 2. Generate sequences with multimodal prompts =========================== raw_prompts = [ [ {"role": "user", "content": "How are you?"}, ], [ {"role": "user", "content": "Please generate a red image for me."}, ], [ {"role": "user", "content": "Can you create a blue picture with size 512x512?"}, ], [ { "role": "system", "content": ( "You are Qwen VL, created by Alibaba Cloud. You are a helpful " "assistant that can generate and analyze images." ), }, {"role": "user", "content": "Generate a green landscape image and describe what you see in it."}, ], ] batch = DataProto( non_tensor_batch={ "raw_prompt": np.array([np.array(prompt) for prompt in raw_prompts], dtype=object), "agent_name": np.array(["tool_agent"] * len(raw_prompts)), "data_source": np.array(["openai/gsm8k"] * len(raw_prompts)), "reward_model": np.array([{"style": "rule", "ground_truth": "1.0"}] * len(raw_prompts)), }, ) batch = batch.repeat(n) result = agent_loop_manager.generate_sequences(prompts=batch) assert len(result) == len(raw_prompts) * n # Check turns num_turns = result.non_tensor_batch["__num_turns__"] print(f"num_turns: {num_turns}") for i in range(len(num_turns)): if i // n == 0: # First prompt: "How are you?" - should have 2 turns [user, assistant] assert num_turns[i] == 2, f"Expected 2 turns but got {num_turns[i]} for sample {i}" else: # Tool-calling prompts should have 4 turns [user, assistant, tool, assistant] assert num_turns[i] == 4, f"Expected 4 turns but got {num_turns[i]} for sample {i}" # Check that images were properly returned in the tool responses tokenizer = hf_tokenizer(init_config.actor_rollout_ref.model.path) responses = result.batch["responses"] response_mask = result.batch["response_mask"] attention_mask = result.batch["attention_mask"] assert responses.size() == response_mask.size(), f"{responses.size()} != {response_mask.size()}" response_length = response_mask.size(1) image_found_count = 0 for i in range(len(responses)): # response with tool response (including images) valid_tokens = responses[i][attention_mask[i][-response_length:].bool()] response_with_obs = tokenizer.decode(valid_tokens) # response without tool response valid_tokens = responses[i][response_mask[i].bool()] response_without_obs = tokenizer.decode(valid_tokens) # Check that tool responses were properly masked out from training assert "" not in response_without_obs, ( f"found in response: {response_without_obs}" ) assert "" not in response_without_obs, ( f"found in response: {response_without_obs}" ) # Check that images were included in the full response if "" in response_with_obs or "image" in response_with_obs.lower(): image_found_count += 1 print("=========================") print("Response with tool observations:") print(response_with_obs) print("---") print("Response without tool observations:") print(response_without_obs) # Verify that tool-calling responses contained image-related content print(f"Found {image_found_count} responses with image content out of {len(responses)}") # We should have at least some image content from the tool-calling prompts # Note: First prompt might not use tools, so we don't expect 100% image content expected_tool_calls = sum(1 for i in range(len(num_turns)) if num_turns[i] == 4) assert image_found_count >= 0, ( f"No image-related content found, but expected at least some from {expected_tool_calls} tool calls" ) print("Multimodal tool test passed!") ray.shutdown()