Voice Agents for Box and GitHub

autonomy-and-box/
|-- autonomy.yaml           # Deployment configuration
|-- secrets.yaml            # Your API credentials (gitignored)
|-- secrets.yaml.example    # Template for credentials
|-- images/
|   |-- main/
|       |-- Dockerfile      # Container definition
|       |-- main.py         # Application entry point
|       |-- box.py          # Box API client
|       |-- github.py       # GitHub issue creation tool
|       |-- index.html      # Voice interface
|       |-- requirements.txt
|
|-- scripts/
    |-- upload_docs_to_box.py  # Utility to populate Box

BOX_CLIENT_ID: "your_box_client_id"
BOX_CLIENT_SECRET: "your_box_client_secret"
BOX_ENTERPRISE_ID: "your_box_enterprise_id"
GITHUB_TOKEN: "your_github_token"
GITHUB_REPO: "your-org/your-repo"

from autonomy import (
  Node,
  Agent,
  Model,
  Knowledge,
  KnowledgeTool,
  NaiveChunker,
  HttpServer,
  Tool,
)

async def main(node: Node):
  # Create knowledge base for document search
  knowledge = Knowledge(
    name="autonomy_docs",
    searchable=True,
    model=Model("embed-english-v3"),
    max_results=5,
    max_distance=0.4,
    chunker=NaiveChunker(max_characters=1024, overlap=128),
  )

  # Create tools
  knowledge_tool = KnowledgeTool(knowledge=knowledge, name="search_autonomy_docs")
  github_tool = Tool(create_github_issue)

  # Start the voice-enabled agent
  await Agent.start(
    node=node,
    name="autonomy-docs",
    instructions=INSTRUCTIONS,
    model=Model("claude-sonnet-4-v1", max_tokens=256),
    tools=[knowledge_tool, github_tool],
    voice={
      "voice": "alloy",
      "instructions": VOICE_INSTRUCTIONS,
      "vad_threshold": 0.7,
      "vad_silence_duration_ms": 700,
    },
  )

  # Load documents from Box
  await load_documents_from_box(knowledge)

from box_sdk_gen import BoxClient, BoxCCGAuth, CCGConfig

class Box:
  def __init__(self):
    self.client = BoxClient(
      auth=BoxCCGAuth(
        config=CCGConfig(
          client_id=environ["BOX_CLIENT_ID"],
          client_secret=environ["BOX_CLIENT_SECRET"],
          enterprise_id=environ["BOX_ENTERPRISE_ID"],
        )
      )
    )

  async def extract_text_representation(self, file_id: str) -> str:
    """Download file content from Box."""
    return await self.box_call(box_file_download_content, self.client, file_id)

  async def list_folder_items(self, folder_id: str):
    """List items in a Box folder."""
    return await self.box_call(self.client.folders.get_folder_items, folder_id)

async def create_github_issue(title: str, body: str, labels: str = "") -> str:
  """
  Create a GitHub issue in the configured repository.

  Args:
    title: The title of the issue
    body: The detailed description of the issue
    labels: Comma-separated list of labels to apply (optional)

  Returns:
    A message indicating success or failure with the issue URL
  """
  url = f"https://api.github.com/repos/{GITHUB_REPO}/issues"

  async with httpx.AsyncClient() as client:
    response = await client.post(url, headers=headers, json=data)

    if response.status_code == 201:
      issue_data = response.json()
      return f"Successfully created issue #{issue_data['number']}: {issue_data['html_url']}"

name: boxdocs
pods:
  - name: main-pod
    public: true
    size: big
    containers:
      - name: main
        image: main
        env:
          - BOX_CLIENT_ID: secrets.BOX_CLIENT_ID
          - BOX_CLIENT_SECRET: secrets.BOX_CLIENT_SECRET
          - BOX_ENTERPRISE_ID: secrets.BOX_ENTERPRISE_ID
          - BOX_FOLDER_PATH: "docs"
          - GITHUB_TOKEN: secrets.GITHUB_TOKEN
          - GITHUB_REPO: secrets.GITHUB_REPO