gohumanloop 0.0.6__py3-none-any.whl → 0.0.8__py3-none-any.whl

gohumanloop/core/interface.py

@@ -292,10 +292,22 @@ class HumanLoopProvider(Protocol):
 class HumanLoopCallback(ABC):
     """人机循环回调的抽象类"""
 
+    @abstractmethod
+    async def async_on_humanloop_request(
+        self, provider: HumanLoopProvider, request: HumanLoopRequest
+    ) -> Any:
+        """当人机循环请求开始时的回调
+
+        Args:
+            provider: 人机循环提供者实例
+            request: 循环请求
+        """
+        pass
+
     @abstractmethod
     async def async_on_humanloop_update(
         self, provider: HumanLoopProvider, result: HumanLoopResult
-    ) -> None:
+    ) -> Any:
         """当请求更新时的回调
 
         Args:
@@ -306,9 +318,8 @@ class HumanLoopCallback(ABC):
 
     @abstractmethod
     async def async_on_humanloop_timeout(
-        self,
-        provider: HumanLoopProvider,
-    ) -> None:
+        self, provider: HumanLoopProvider, result: HumanLoopResult
+    ) -> Any:
         """当请求超时时的回调
 
         Args:
@@ -319,7 +330,7 @@ class HumanLoopCallback(ABC):
     @abstractmethod
     async def async_on_humanloop_error(
         self, provider: HumanLoopProvider, error: Exception
-    ) -> None:
+    ) -> Any:
         """当请求发生错误时的回调
 
         Args:

gohumanloop/core/manager.py

@@ -1,8 +1,10 @@
 from typing import Dict, Any, Optional, List, Union
 import asyncio
+from datetime import datetime
 from gohumanloop.utils import run_async_safely
 
 from gohumanloop.core.interface import (
+    HumanLoopRequest,
     HumanLoopManager,
     HumanLoopProvider,
     HumanLoopCallback,
@@ -147,6 +149,25 @@ class DefaultHumanLoopManager(HumanLoopManager):
 
             # 如果提供了回调，存储它
             if callback:
+                try:
+                    # 创建请求对象
+                    request = HumanLoopRequest(
+                        task_id=task_id,
+                        conversation_id=conversation_id,
+                        loop_type=loop_type,
+                        context=context,
+                        metadata=metadata or {},
+                        timeout=timeout,
+                        created_at=datetime.now(),
+                    )
+                    await callback.async_on_humanloop_request(provider, request)
+                except Exception as e:
+                    # 处理回调执行过程中的异常
+                    try:
+                        await callback.async_on_humanloop_error(provider, e)
+                    except Exception:
+                        # 如果错误回调也失败，只能忽略
+                        pass
                 self._callbacks[(conversation_id, request_id)] = callback
 
             # 如果设置了超时，创建超时任务
@@ -266,6 +287,25 @@ class DefaultHumanLoopManager(HumanLoopManager):
 
             # 如果提供了回调，存储它
             if callback:
+                try:
+                    # 创建请求对象
+                    request = HumanLoopRequest(
+                        task_id=task_id or "",
+                        conversation_id=conversation_id,
+                        loop_type=HumanLoopType.CONVERSATION,
+                        context=context,
+                        metadata=metadata or {},
+                        timeout=timeout,
+                        created_at=datetime.now(),
+                    )
+                    await callback.async_on_humanloop_request(provider, request)
+                except Exception as e:
+                    # 处理回调执行过程中的异常
+                    try:
+                        await callback.async_on_humanloop_error(provider, e)
+                    except Exception:
+                        # 如果错误回调也失败，只能忽略
+                        pass
                 self._callbacks[(conversation_id, request_id)] = callback
 
             # 如果设置了超时，创建超时任务
@@ -613,7 +653,9 @@ class DefaultHumanLoopManager(HumanLoopManager):
             # INPROGRESS状态表示对话正在进行中，不应视为超时
             if result.status == HumanLoopStatus.PENDING:
                 if callback:
-                    await callback.async_on_humanloop_timeout(provider=provider)
+                    await callback.async_on_humanloop_timeout(
+                        provider=provider, result=result
+                    )
             # 如果状态是INPROGRESS，重置超时任务
             elif result.status == HumanLoopStatus.INPROGRESS:
                 # 对于进行中的对话，我们可以选择延长超时时间

{gohumanloop-0.0.6.dist-info → gohumanloop-0.0.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gohumanloop
-Version: 0.0.6
+Version: 0.0.8
 Summary: Perfecting AI workflows with human intelligence
 Author-email: gohumanloop authors <baird0917@163.com>
 Project-URL: repository, https://github.com/ptonlix/gohumanloop
@@ -19,6 +19,8 @@ Requires-Dist: langgraph>=0.3.30; extra == "langgraph"
 Provides-Extra: apiservices
 Requires-Dist: fastapi>=0.115.12; extra == "apiservices"
 Requires-Dist: uvicorn>=0.34.2; extra == "apiservices"
+Provides-Extra: agentops
+Requires-Dist: agentops>=0.4.12; extra == "agentops"
 Dynamic: license-file
 
 <div align="center">
@@ -61,17 +63,15 @@ To get started, check out the following example or jump straight into one of the
 
 - 🦜⛓️ [LangGraph](./examples/langgraph/)
 
-### Example
+### Installation
 
 **GoHumanLoop** currently supports `Python`.
 
-- Installation
-
 ```shell
 pip install gohumanloop
 ```
 
-- Example
+### Example
 
 The following example enhances [the official LangGraph example](https://langchain-ai.github.io/langgraph/tutorials/get-started/4-human-in-the-loop/#5-resume-execution) with `human-in-the-loop` functionality.
 
@@ -95,7 +95,9 @@ from langgraph.prebuilt import ToolNode, tools_condition
 
 from gohumanloop.adapters.langgraph_adapter import interrupt, create_resume_command
 
+# Please replace with your Deepseek API Key from https://platform.deepseek.com/usage
 os.environ["DEEPSEEK_API_KEY"] = "sk-xxx"
+# Please replace with your Tavily API Key from https://app.tavily.com/home
 os.environ["TAVILY_API_KEY"] = "tvly-xxx"
 
 llm = init_chat_model("deepseek:deepseek-chat")
@@ -169,6 +171,43 @@ for event in events:
 
 ```
 
+- Deployment & Test
+
+Run the above code with the following steps:
+
+```shell
+# 1.Initialize environment
+uv init gohumanloop-example
+cd gohumanloop-example
+uv venv .venv --python=3.10
+
+# 2.Copy the above code to main.py
+
+# 3.Deploy and test
+uv pip install langchain
+uv pip install langchain_tavily
+uv pip install langgraph
+uv pip install langchain-deepseek
+uv pip install gohumanloop
+
+python main.py
+
+```
+
+- Interaction Demo
+
+![终端展示](http://cdn.oyster-iot.cloud/202505232244870.png)
+
+Perform `human-in-the-loop` interaction by entering:
+
+> We, the experts are here to help! We'd recommend you check out LangGraph to build your agent.It's much more reliable and extensible than simple autonomous agents.
+
+![输出结果](http://cdn.oyster-iot.cloud/202505232248390.png)
+
+🚀🚀🚀 Completed successfully ~
+
+➡️ Check out more examples in the [Examples Directory](./examples/) and we look foward to your contributions!
+
 ## 🎵 Why GoHumanloop?
 
 ### Human-in-the-loop

{gohumanloop-0.0.6.dist-info → gohumanloop-0.0.8.dist-info}/RECORD

@@ -1,12 +1,13 @@
-gohumanloop/__init__.py,sha256=oJqVOtRRDHNxwxZ2Blw7ycBRwcTBMTURUCx-XcL2YJ0,1969
+gohumanloop/__init__.py,sha256=KiY2ncM6OQvkBYcz5rsbob_GuV8hQHOARA-EsxAylEU,2134
 gohumanloop/__main__.py,sha256=zdGKN92H9SgwZfL4xLqPkE1YaiRcHhVg_GqC-H1VurA,75
-gohumanloop/adapters/__init__.py,sha256=cFXd9qzyR0oZg8mR912PShj2b_3BAM_RO_cIVMXVdWQ,390
-gohumanloop/adapters/langgraph_adapter.py,sha256=il_zsQMdgbJrwIn_ucQiH1ku3JhozxIQ7RH82KqTLwA,36750
+gohumanloop/adapters/__init__.py,sha256=_XqJ6eaUBLJJJyjfBQJykBZ4X9HvC3VYOVTn2KnBlqo,484
+gohumanloop/adapters/base_adapter.py,sha256=snKd2GWE5SuFxqkNwdwS8YAhQzhMs9fpeOG6hT6VRhc,32600
+gohumanloop/adapters/langgraph_adapter.py,sha256=AHJv_b6g8xjeq_9X2cGiW76pSGlfgCGBUvjrZQcbR9s,11621
 gohumanloop/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gohumanloop/cli/main.py,sha256=Txjk31MlkiX9zeHZfFEXEu0s2IBESY8sxrxBEzZKk2U,767
 gohumanloop/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-gohumanloop/core/interface.py,sha256=D59FR4Bj-7gCFXw_55pPcFBjG2bY-EI5sYZl46tBaB0,21476
-gohumanloop/core/manager.py,sha256=xyJJItJvt5ZPudAa3kWy282jn-I5yCsLJYNPaJyIQLI,29906
+gohumanloop/core/interface.py,sha256=uzV3xG08DDItgB9TgMvskcKVDSIFTx2qv8HXjVBtJcI,21810
+gohumanloop/core/manager.py,sha256=imeDVuQlyBRyVR5-PFwxNaFQYaZaAQ69ZGtmsiUpUDg,31790
 gohumanloop/manager/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gohumanloop/manager/ghl_manager.py,sha256=rmbfaS5mAb9c8RPr9Id24vO5DJT9ZC4D282dHZ26SJE,22695
 gohumanloop/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -22,9 +23,9 @@ gohumanloop/utils/__init__.py,sha256=l0e3lnOVrt6HwaxidNGFXORX4awCKemhJZ_t3k-5u-s
 gohumanloop/utils/context_formatter.py,sha256=sAWrKJpxmsHga6gsyBwFBlAsHW8bjR1hkaGhk1PoE1M,2064
 gohumanloop/utils/threadsafedict.py,sha256=9uyewnwmvS3u1fCx3SK0YWFxHMcyIwlye1Ev7WW7WHA,9588
 gohumanloop/utils/utils.py,sha256=-bti65OaVh5dlvc5BIgiTw6dqxmqdKnOQHE0V-LKjek,2107
-gohumanloop-0.0.6.dist-info/licenses/LICENSE,sha256=-U5tuCcSpndQwSKWtZbFbazb-_AtZcZL2kQgHbSLg-M,1064
-gohumanloop-0.0.6.dist-info/METADATA,sha256=waWXbFIFOXC9loVTl4OJUTB-UbjSae_TZcXLIrMek8k,10057
-gohumanloop-0.0.6.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-gohumanloop-0.0.6.dist-info/entry_points.txt,sha256=wM6jqRRD8bQXkvIduRVCuAJIlbyWg_F5EDXo5OZ_PwY,88
-gohumanloop-0.0.6.dist-info/top_level.txt,sha256=LvOXBqS6Mspmcuqp81uz0Vjx_m_YI0w06DOPCiI1BfY,12
-gohumanloop-0.0.6.dist-info/RECORD,,
+gohumanloop-0.0.8.dist-info/licenses/LICENSE,sha256=-U5tuCcSpndQwSKWtZbFbazb-_AtZcZL2kQgHbSLg-M,1064
+gohumanloop-0.0.8.dist-info/METADATA,sha256=FvrBF4EDkQXWzC2Jg7A43zdvPPsdpR2BN035wgTMxOo,11216
+gohumanloop-0.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gohumanloop-0.0.8.dist-info/entry_points.txt,sha256=wM6jqRRD8bQXkvIduRVCuAJIlbyWg_F5EDXo5OZ_PwY,88
+gohumanloop-0.0.8.dist-info/top_level.txt,sha256=LvOXBqS6Mspmcuqp81uz0Vjx_m_YI0w06DOPCiI1BfY,12
+gohumanloop-0.0.8.dist-info/RECORD,,

{gohumanloop-0.0.6.dist-info → gohumanloop-0.0.8.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.8.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any