agentx-python 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

{agentx_python-0.3.1.dist-info → agentx_python-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: agentx-python
-Version: 0.3.1
+Version: 0.3.2
 Summary: Offical Python SDK for AgentX (https://www.agentx.so/)
 Home-page: https://github.com/AgentX-ai/AgentX-python-sdk
 Author: Robin Wang and AgentX Team
@@ -23,12 +23,25 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-# AgentX Python SDK API library
+![Logo](agentx/images/LOGO.png)
 
 [![PyPI version](https://img.shields.io/pypi/v/agentx-python)](https://pypi.org/project/agentx-python/)
 
-The AgentX Python SDK provides a convenient way to access to your Agent programmatically.
-This is a python SDK for AgentX (https://www.agentx.so/)
+---
+
+## Fast way to build AI Agents and create agent workforce
+
+The official AgentX Python SDK for [AgentX](https://www.agentx.so/)
+
+Why build AI agent with AgentX?
+
+- Simplicity, Agent - Conversation - Message structure.
+- Include chain-of-thoughts.
+- Choose from most open and closed sourced LLM vendors.
+- Built-in Voice(ASR, TTS), Image Gen, Document, CSV/excel tool, OCR, etc.
+- Support all running MCP (model context protocol).
+- Support RAG with built-in re-rank.
+- Multi-agent workforce orchestration.
 
 ## Installation
 
@@ -44,7 +57,7 @@ You can get an API key from https://app.agentx.so
 ### Agent
 
 ```python
-from agentx_python import AgentX
+from agentx import AgentX
 
 client = AgentX(api_key="<your api key here>")
 
@@ -61,7 +74,13 @@ Each Conversation has `agents` and `users` tied to it.
 my_agent = client.get_agent(id="<agent id here>")
 
 # Get the list of conversation from this agent
-print(my_agent.list_conversations())
+existing_conversations = my_agent.list_conversations()
+print(existing_conversations)
+
+# Get the list of history messages from a conversation
+last_conversation = existing_conversations[-1]
+msgs = last_conversation.list_messages()
+print(msgs)
 ```
 
 ### Chat
@@ -71,10 +90,23 @@ A `chat` needs to happen in the conversation. You can do `stream` response too,
 ```python
 a_conversation = my_agent.get_conversation(id="<conversation id here>")
 
-response = a_conversation.chat("Hello, what is your name?", stream=True)
+response = a_conversation.chat_stream("Hello, what is your name?")
 for chunk in response:
-    print(chunk, end="")
+    print(chunk)
+```
+
+output looks like:
 
-# output:
-# My name is Rosita. I'm an AI assistant created by AgentX. It's nice to meet you! How can I help you today?
 ```
+text=None cot='The user is greeting and asking for my ' botId='xxx'
+text=None cot='name, which are casual, straightforward questions.' botId='xxx'
+text=None cot=' I can answer these directly' botId='xxx'
+text='Hello' cot=None botId='xxx'
+text='!' cot=None botId='xxx'
+text=' I' cot=None botId='xxx'
+text=' am' cot=None botId='xxx'
+text=' AgentX' cot=None botId='xxx'
+text=None cot=None botId='xxx'
+```
+
+\*`cot` stands for chain-of-thoughts

agentx_python-0.3.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+agentx/__init__.py,sha256=AiY83tsCtjSMIBVsvNuxOgSU4i-rCREQrqDrNmCoSd0,279
+agentx/agentx.py,sha256=kmpAgnvtLdA3ytn0TJuDmchOQZydjuD4NSP77K3tsYM,1859
+agentx/util.py,sha256=grYAa8YTvoQSyuy4GvUOwq6SVBRr4DdrBlcTuZwQpzw,132
+agentx/version.py,sha256=OgfvlOui_Z4FwAja2bTJgiUkMeuAXZ561wYewaEr6SQ,18
+agentx/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+agentx/resources/agent.py,sha256=SMu4H1UDL31Bub4hnaySoySeckgAchRSaAaHDpXa1L8,1521
+agentx/resources/conversation.py,sha256=Xwy3IfFF6C7U7Xu6BNC32IOPqmaKNwCBTbN2w4FpI8w,4485
+agentx_python-0.3.2.dist-info/LICENSE,sha256=6ZbiPNFmv3xBb44LGhAa3PZYK0ROAztsd5LRFZDlGFE,1074
+agentx_python-0.3.2.dist-info/METADATA,sha256=47m1FfWDCtAvT8frfeKYapKOBc-OHX_GSQxjhdMjDto,2956
+agentx_python-0.3.2.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+agentx_python-0.3.2.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
+agentx_python-0.3.2.dist-info/RECORD,,

agentx_python/__init__.py

@@ -1,13 +0,0 @@
-import logging
-
-from agentx.agentx import AgentX
-from agentx.version import VERSION
-
-logging.basicConfig(
-    level=logging.INFO,
-    format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
-    datefmt="%Y-%m-%d %H:%M:%S %Z",
-)
-
-__all__ = ["AgentX"]
-__version__ = VERSION

agentx_python/agentx.py

@@ -1,51 +0,0 @@
-from typing import List
-import requests
-import os
-import logging
-
-from agentx.util import get_headers
-from agentx.resources.agent import Agent
-
-
-class AgentX:
-
-    def __init__(self, api_key: str = None):
-        self.api_key = api_key or os.getenv("AGENTX_API_KEY")
-        if self.api_key and not os.getenv("AGENTX_API_KEY"):
-            os.environ["AGENTX_API_KEY"] = self.api_key
-
-    def get_agent(self, id: str) -> Agent:
-        url = f"https://api.agentx.so/api/v1/access/agents/{id}"
-        # Make a GET request to the AgentX API
-        response = requests.get(url, headers=get_headers())
-        # Check if response was successful
-        if response.status_code == 200:
-            agent_res = response.json()
-            return Agent(
-                id=agent_res.get("_id"),
-                name=agent_res.get("name"),
-                avatar=agent_res.get("avatar"),
-                createdAt=agent_res.get("createdAt"),
-                updatedAt=agent_res.get("updatedAt"),
-            )
-        else:
-            raise Exception(f"Failed to retrieve agent: {response.reason}")
-
-    def list_agents(self) -> List[Agent]:
-        url = "https://api.agentx.so/api/v1/access/agents"
-        # Make a GET request to the AgentX API
-        response = requests.get(url, headers=get_headers())
-        # Check if response was successful
-        if response.status_code == 200:
-            return [
-                Agent(
-                    id=agent_res.get("_id"),
-                    name=agent_res.get("name"),
-                    avatar=agent_res.get("avatar"),
-                    createdAt=agent_res.get("createdAt"),
-                    updatedAt=agent_res.get("updatedAt"),
-                )
-                for agent_res in response.json()
-            ]
-        else:
-            raise Exception(f"Failed to list agents: {response.reason}")

agentx_python/resources/agent.py

@@ -1,46 +0,0 @@
-from typing import Optional, List
-from pydantic import BaseModel, Field
-import requests
-import os
-import logging
-from dataclasses import dataclass
-from agentx.util import get_headers
-from .conversation import Conversation
-
-
-@dataclass
-class Agent(BaseModel):
-    id: str
-    name: str
-    avatar: Optional[str]
-    createdAt: Optional[str]
-    updatedAt: Optional[str]
-
-    def __init__(self, **data):
-        super().__init__(**data)
-
-    def get_conversation(self, id: str) -> Conversation:
-        list_of_conversations = self.list_conversations()
-        return next(
-            (conv for conv in list_of_conversations if conv.id == id),
-            Exception("404 - Conversation not found"),
-        )
-
-    def list_conversations(self) -> List[Conversation]:
-        url = f"https://api.agentx.so/api/v1/access/agents/{self.id}/conversations"
-        response = requests.get(url, headers=get_headers())
-        if response.status_code == 200:
-            return [
-                Conversation(
-                    agent_id=self.id,
-                    id=conv_res.get("_id"),
-                    title=conv_res.get("title"),
-                    users=conv_res.get("users"),
-                    agents=conv_res.get("bots"),
-                    createdAt=conv_res.get("createdAt"),
-                    updatedAt=conv_res.get("updatedAt"),
-                )
-                for conv_res in response.json()
-            ]
-        else:
-            raise Exception(f"Failed to retrieve agent details: {response.reason}")

agentx_python/resources/conversation.py

@@ -1,63 +0,0 @@
-from typing import Optional, List
-from pydantic import BaseModel, Field
-import os
-import requests
-from agentx.util import get_headers
-
-
-class Conversation(BaseModel):
-    agent_id: str
-    id: str
-    title: Optional[str] = Field(default=None)  # conversation customized title
-    users: List[str]
-    agents: List[str]
-    createdAt: Optional[str]
-    updatedAt: Optional[str]
-
-    def __init__(self, **data):
-        super().__init__(**data)
-
-    def generate_conversation_id(self):
-        return "generate new_conversation_id"
-
-    def list_messages(self):
-        url = f"https://api.agentx.so/api/v1/access/agents/{self.agent_id}/conversations/{self.id}"
-        response = requests.get(url, headers=get_headers())
-        if response.status_code == 200:
-            return response.json()
-        else:
-            raise Exception(
-                f"Failed to retrieve agent details: {response.status_code} - {response.reason}"
-            )
-
-    def chat(self, message: str, stream: bool = False, context: int = None):
-        if stream:
-            return self._chat_stream(message, context)
-        else:
-            url = f"https://api.agentx.so/api/v1/access/conversations/{self.id}/message"
-            response = requests.post(
-                url,
-                headers=get_headers(),
-                json={"message": message, "context": context},
-            )
-            return response.json()
-
-    def _chat_stream(self, message: str, context: int = None):
-        url = f"https://api.agentx.so/api/v1/access/conversations/{self.id}/messagesse"
-        response = requests.post(
-            url, headers=get_headers(), json={"message": message, "context": context}
-        )
-        if response.status_code == 200:
-            buf = b""
-            for chunk in response.iter_content():
-                buf += chunk
-                try:
-                    chunk = buf.decode("utf-8")
-                    yield chunk
-                except UnicodeDecodeError:
-                    continue
-                buf = b""
-        else:
-            raise Exception(
-                f"Failed to send message: {response.status_code} - {response.reason}"
-            )

agentx_python/util.py

@@ -1,5 +0,0 @@
-import os
-
-
-def get_headers(api_key: str = None):
-    return {"accept": "*/*", "x-api-key": api_key or os.getenv("AGENTX_API_KEY")}

agentx_python/version.py

@@ -1 +0,0 @@
-VERSION = "0.1.0"

agentx_python-0.3.1.dist-info/RECORD

@@ -1,19 +0,0 @@
-agentx/__init__.py,sha256=AiY83tsCtjSMIBVsvNuxOgSU4i-rCREQrqDrNmCoSd0,279
-agentx/agentx.py,sha256=kmpAgnvtLdA3ytn0TJuDmchOQZydjuD4NSP77K3tsYM,1859
-agentx/util.py,sha256=grYAa8YTvoQSyuy4GvUOwq6SVBRr4DdrBlcTuZwQpzw,132
-agentx/version.py,sha256=OgfvlOui_Z4FwAja2bTJgiUkMeuAXZ561wYewaEr6SQ,18
-agentx/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentx/resources/agent.py,sha256=SMu4H1UDL31Bub4hnaySoySeckgAchRSaAaHDpXa1L8,1521
-agentx/resources/conversation.py,sha256=Xwy3IfFF6C7U7Xu6BNC32IOPqmaKNwCBTbN2w4FpI8w,4485
-agentx_python/__init__.py,sha256=AiY83tsCtjSMIBVsvNuxOgSU4i-rCREQrqDrNmCoSd0,279
-agentx_python/agentx.py,sha256=kmpAgnvtLdA3ytn0TJuDmchOQZydjuD4NSP77K3tsYM,1859
-agentx_python/util.py,sha256=grYAa8YTvoQSyuy4GvUOwq6SVBRr4DdrBlcTuZwQpzw,132
-agentx_python/version.py,sha256=CpXi3jGlx23RvRyU7iytOMZrnspdWw4yofS8lpP1AJU,18
-agentx_python/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-agentx_python/resources/agent.py,sha256=SMu4H1UDL31Bub4hnaySoySeckgAchRSaAaHDpXa1L8,1521
-agentx_python/resources/conversation.py,sha256=MR0ZBkpSWxUdWoN5HklaoP79zKxp-uzrnX5koX3m504,2179
-agentx_python-0.3.1.dist-info/LICENSE,sha256=6ZbiPNFmv3xBb44LGhAa3PZYK0ROAztsd5LRFZDlGFE,1074
-agentx_python-0.3.1.dist-info/METADATA,sha256=YHCO7IJsO9XajdldjKJtWvgIwVhRRj8z3ffISqzarIs,2065
-agentx_python-0.3.1.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-agentx_python-0.3.1.dist-info/top_level.txt,sha256=s-q-HB9Gb_QdrZNacSeQyF_c25gQooMy7DlxzgLOHPk,7
-agentx_python-0.3.1.dist-info/RECORD,,