Skip to content

armgit / camel

Public Imported from GitHub
0

🐫 CAMEL: The first and the best multi-agent framework. Finding the Scaling Law of Agents. https://www.camel-ai.org

6.7 KB
Raw Blame

_get_wechat_access_token

def _get_wechat_access_token():

Returns:

str: The valid access token.

Raises:

  • ValueError: If credentials are missing or token retrieval fails.
  • References:
  • https: //developers.weixin.qq.com/doc/offiaccount/Basic_Information/Get_access_token.html

_make_wechat_request

def _make_wechat_request(method: Literal['GET', 'POST'], endpoint: str, **kwargs):

Makes a request to WeChat API with proper error handling.

Parameters:

  • method (Literal["GET", "POST"]): HTTP method ('GET' or 'POST').
  • endpoint (str): API endpoint path. **kwargs: Additional arguments for requests.

Returns:

Dict[str, Any]: API response data.

Raises:

  • requests.exceptions.RequestException: If request fails.
  • ValueError: If API returns an error.

WeChatOfficialToolkit

class WeChatOfficialToolkit(BaseToolkit):

A toolkit for WeChat Official Account operations.

This toolkit provides methods to interact with the WeChat Official Account API, allowing users to send messages, manage users, and handle media files.

References:

Note:

Set environment variables: WECHAT_APP_ID, WECHAT_APP_SECRET

init

def __init__(self, timeout: Optional[float] = None):

Initializes the WeChatOfficialToolkit.

send_customer_message

def send_customer_message(
    self,
    openid: str,
    content: str,
    msgtype: Literal['text', 'image', 'voice', 'video'] = 'text'
):

Sends a customer service message to a WeChat user.

Parameters:

  • openid (str): The user's OpenID.
  • content (str): Message content or media_id for non-text messages.
  • msgtype (str): Message type: "text", "image", "voice", "video".

Returns:

str: Success or error message.

References: https://developers.weixin.qq.com/doc/offiaccount/Message_Management/Service_Center_messages.html

get_user_info

def get_user_info(self, openid: str, lang: str = 'zh_CN'):

Retrieves WeChat user information.

Parameters:

  • openid (str): The user's OpenID.
  • lang (str): Response language. Common values: "zh_CN", "zh_TW", "en". (default: "zh_CN")

Returns:

Dict[str, Any]: User information as dictionary or error information.

References: https://developers.weixin.qq.com/doc/offiaccount/User_Management/ Getting_user_basic_information.html

get_followers_list

def get_followers_list(self, next_openid: str = ''):

Retrieves list of followers' OpenIDs.

Parameters:

  • next_openid (str): Starting OpenID for pagination. (default: "") (default: "")

Returns:

Dict[str, Any]: Followers list as dictionary or error information.

References: https://developers.weixin.qq.com/doc/offiaccount/User_Management/ Getting_a_list_of_followers.html

upload_wechat_media

def upload_wechat_media(
    self,
    media_type: Literal['image', 'voice', 'video', 'thumb'],
    file_path: str,
    permanent: bool = False,
    description: Optional[str] = None
):

Uploads media file to WeChat.

Parameters:

  • media_type (str): Media type: "image", "voice", "video", "thumb".
  • file_path (str): Local file path.
  • permanent (bool): Whether to upload as permanent media. (default: :obj:False)
  • description (Optional[str]): Video description in JSON format for permanent upload. (default: :obj:None)

Returns:

Dict[str, Any]: Upload result with media_id or error information.

References:

get_media_list

def get_media_list(
    self,
    media_type: Literal['image', 'voice', 'video', 'news'],
    offset: int = 0,
    count: int = 20
):

Gets list of permanent media files.

Parameters:

  • media_type (str): Media type: "image", "voice", "video", "news".
  • offset (int): Starting position. (default: :obj:0) (default: 0)
  • count (int): Number of items (1-20). (default: :obj:20) (default: 20)

Returns:

Dict[str, Any]: Media list as dictionary or error information.

References: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/ Get_the_list_of_all_materials.html

send_mass_message_to_all

def send_mass_message_to_all(
    self,
    content: str,
    msgtype: Literal['text', 'image', 'voice', 'video'] = 'text',
    clientmsgid: Optional[str] = None,
    send_ignore_reprint: Optional[int] = 0,
    batch_size: int = 10000
):

Sends a mass message to all followers (by OpenID list).

This method paginates all follower OpenIDs and calls the mass-send API in batches.

Parameters:

  • content (str): For text, the message content; for non-text, the media_id.
  • msgtype (Literal["text","image","voice","video"]): Message type. For "video", the mass API expects "mpvideo" internally.
  • clientmsgid (Optional[str]): Idempotency key to avoid duplicate mass jobs.
  • send_ignore_reprint (Optional[int]): Whether to continue when a news article is judged as a reprint (reserved; applies to news/mpnews).
  • batch_size (int): Max OpenIDs per request (WeChat limit is up to 10000 per batch).

Returns:

Dict[str, Any]: Aggregated result including counts and each batch response.

References:

get_tools

def get_tools(self):

Returns toolkit functions as tools.