🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org
Python agentai-societiesartificial-intelligencecommunicative-aicooperative-aideep-learninglarge-language-modelsmulti-agent-systemsnatural-language-processing
# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
# 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.
# ========= Copyright 2023-2026 @ CAMEL-AI.org. All Rights Reserved. =========
from typing import Any, Dict
import requests
from pydantic import BaseModel, Field
from camel.agents import ChatAgent
from camel.toolkits import FunctionTool
# example function
def movie_data_by_id(id: int) -> Dict[str, Any]:
r"""Fetch movie data by its ID from the IMDB Top 100 Movies API.
Args:
id (int): The ID of the movie to retrieve information for.
Returns:
Dict[str, Any]: A dictionary with the following keys:
- rank (int): The rank of the movie in the top 100 list.
- movie_title (str): The title of the movie.
- rating (str): The movie's rating.
- id (str): The unique identifier of the movie.
- year (int): The release year of the movie.
- description (str): A brief description of the movie.
Raises:
Exception: If an unexpected error occurs while fetching the data.
"""
try:
url = f"https://imdb-top-100-movies.p.rapidapi.com/{id}"
headers = {
"x-rapidapi-key": "Your API Key",
"x-rapidapi-host": "imdb-top-100-movies.p.rapidapi.com",
}
response = requests.get(url, headers=headers)
return response.json()
except Exception as e:
return {
"error": str(e),
}
# Define the response format for movie data
class MovieResponse(BaseModel):
rating: str = Field(description="The movie's rating.")
description: str = Field(description="A brief description of the movie.")
movie_title: str = Field(description="The title of the movie.")
real_get_movie = FunctionTool(movie_data_by_id)
synthesized_get_movie = FunctionTool(movie_data_by_id, synthesize_output=True)
assistant_sys_msg = "You are a helpful assistant."
user_msg = (
"What is the rating, description and movie_title of the movie with id 2048"
)
print("Synthesize output: False")
real_agent = ChatAgent(assistant_sys_msg, tools=[real_get_movie])
assistant_response = real_agent.step(user_msg)
print(assistant_response.msg.content)
print("\nSynthesize output: True")
synthesized_agent = ChatAgent(assistant_sys_msg, tools=[synthesized_get_movie])
assistant_response = synthesized_agent.step(
user_msg, response_format=MovieResponse
)
print(assistant_response.msg.content)
"""
===============================================================================
Warning: No synthesize_output_model provided. Use `gpt-4o-mini` to synthesize
the output.
Synthesize output: False
It seems that I'm unable to access the movie data at the moment due to a
subscription issue with the API. However, if you provide me with the title of
the movie or any other details, I can help you find information about it!
===============================================================================
"""
"""
===============================================================================
Synthesize output: True
{'rating': '8.8', 'description': 'A thief who steals corporate secrets through
the use of dream-sharing technology is given the inverse task of planting an
idea into the mind of a CEO.', 'movie_title': 'Inception'}
===============================================================================
"""