嵌入到现有应用#

在已有应用中将 Agent 和 Runtime 作为 Python 库使用。宿主提供模型客户端，并决定是否持久化会话。库调用不启动 Web UI 或终端 UI。

提供宿主 Runtime#

from openprogram import Agent, Runtime


def model_call(content, model="host-model", response_format=None):
    # Replace this offline response with the host's model client.
    return "Host model response"

runtime = Runtime(call=model_call, model="host-model")

class ReviewAgent(Agent):
    tools = []

    def classify(self, review: str) -> str:
        """Classify review sentiment."""
        return self(f"Classify review sentiment:\n{review}")

    def summarize(self, review: str) -> str:
        """Summarize a review."""
        sentiment = self.classify(review)
        return self(f"Summarize this {sentiment} review:\n{review}")

reviewer = ReviewAgent(runtime=runtime)
try:
    summary = reviewer.summarize("The service was fast.")
finally:
    runtime.close()

Runtime(call=...) 接收宿主回调，向其传递内容块、模型名称和可选返回格式。构造时不请求模型。宿主负责关闭自己提供的 Runtime。

Agent 方法自动继承该 Runtime，无需逐个帮助函数传递。Context 与函数作用域自动管理。示例回调返回固定文本，不需要网络。

显式持久会话#

默认 Agent 调用不会让实例拥有持久会话。宿主需要续接历史时，显式选择 store 与 session：

from openprogram import Agent, Context
from openprogram.store import SessionStore, SessionNodeWriter

store = SessionStore(root_path="/var/lib/myapp/sessions")
store.create_session("research", agent_id="main")
writer = SessionNodeWriter(store, "research")
researcher = Agent(context=Context(store=writer), tools=[])
try:
    first = researcher("List the project requirements.")
    second = researcher("Review the requirements from the previous call.")
finally:
    store.close()

Context(store=writer) 显式在调用之间续接该会话。宿主拥有 store 与 Runtime。head_id 可选择已有分支末端。默认 Agent 调用保持独立。

检查调用与暴露工具#

from openprogram.store import SessionNodeWriter

for node in SessionNodeWriter(store, "review-42").load():
    print(node.name, node.caller, node.output)

普通公开 Agent 方法自动具有调用作用域。将方法暴露为模型工具时，在 method_options 中设置 tool=True。显式登记提供 .spec 与 .execute。记录本身不授予工具权限，见 Agent 与 Context API。

方法功能与宿主 hook#

Agent 方法提供完整执行约定。openprogram.agentic_programming.call_state 保留 set_cancellation_check 和 set_session_id_provider，用于宿主取消与问题路由。

嵌入 import 路径调用库 API，不替代完整安装产品。import 检查位于 tests/embed/。参见 Runtime 和 编程指南。