mirror of
https://github.com/hanzoai/python-sdk.git
synced 2026-10-23 20:23:00 +00:00
zeekayandHanzo Dev
321aa75a5c
pip install hanzoai on 3.12 gets 8.5.156, which has no Client; on 3.9 to 3.11 it gets the 2.1 line, a different client. The README said neither. It showed KeysApi and MemoryApi, which the generated client does not have, and mapped hanzo-agent and hanzo-agents to copies here that PyPI does not publish. examples/agent and examples/tools imported AgentsApi and ToolsApi, which the document now names AgentApi and ToolApi. Both flows ran against a local server after the change. The per-agent runs read is generated without its ref, so the agent flow reads /v1/agent/runs and keeps its own rows. The status table and the Retry-After lines come from runs against a local server: a capability call is one request, two on a 401; a generated operation sleeps for Retry-After on 429 or 503 and retries three times. Co-authored-by: Hanzo Dev <[email protected]>
55 lines
1.7 KiB
Python
55 lines
1.7 KiB
Python
"""agent — define one, run it, read the run back.
|
|
|
|
POST /v1/agent post_agent
|
|
POST /v1/agent/{ref}/run post_agent_by_ref_run
|
|
GET /v1/agent/runs get_agent_runs
|
|
|
|
``ref`` is the agent's public id (``agent_...``) OR its org-unique name, which
|
|
is why the run below can use the name we just created without waiting for an id
|
|
to come back.
|
|
|
|
The read-back is the RUN list rather than the agent record: an agent you just
|
|
created tells you nothing you did not just send, while its runs are the part the
|
|
server actually produced. It reads the org's run feed and keeps this agent's
|
|
rows, because the document declares ``GET /v1/agent/{ref}/runs`` without its
|
|
``ref`` parameter and the generated method cannot take one.
|
|
|
|
python -m examples.agent
|
|
"""
|
|
|
|
import time
|
|
|
|
from hanzoai.cloud import AgentApi, CreateAgentIn
|
|
|
|
from examples.client import MODEL, client, run
|
|
|
|
# Org-unique: a fixed name collides with itself on the second run.
|
|
NAME = f"example-greeter-{time.time_ns()}"
|
|
|
|
|
|
def main() -> None:
|
|
with client() as api:
|
|
agents = AgentApi(api)
|
|
|
|
created = agents.post_agent(
|
|
CreateAgentIn(
|
|
name=NAME,
|
|
model=MODEL,
|
|
description="Created by the hanzoai SDK agent example.",
|
|
instructions="You greet the user in one short sentence.",
|
|
)
|
|
)
|
|
print(f"created {created.name} ({created.id}) on {created.model}")
|
|
|
|
agents.post_agent_by_ref_run(NAME)
|
|
print("run started")
|
|
|
|
entries = [r for r in agents.get_agent_runs().runs or [] if r.agent == NAME][:5]
|
|
print(f"{len(entries)} run(s):")
|
|
for entry in entries:
|
|
print(f" {entry.to_str()}")
|
|
|
|
|
|
if __name__ == "__main__":
|
|
run(main)
|