Skills Overview

from definable.agent import Agent
from definable.model import OpenAIChat
from definable.skill import Calculator, DateTime

agent = Agent(
  model=OpenAIChat(id="gpt-4o"),
  skills=[Calculator(), DateTime()],
)

output = agent.run("What is 2^10? And what day of the week is it?")
print(output.content)

from definable.skill import Skill
from definable.tool.decorator import tool

@tool
def search_docs(query: str) -> str:
  """Search the documentation."""
  return docs.search(query)

support = Skill(
  name="support",
  instructions="You are a support specialist. Always cite sources.",
  tools=[search_docs],
)

agent = Agent(model=model, skills=[support])

from definable.skill import Skill
from definable.tool.decorator import tool

class CustomerSupport(Skill):
  name = "customer_support"
  instructions = "You are a support specialist. Look up orders before answering."

  def __init__(self, db_url: str):
    super().__init__(dependencies={"db_url": db_url})

  def setup(self):
    """Called once when the agent initializes."""
    self._db = connect(self.dependencies["db_url"])

  def teardown(self):
    """Called when the agent shuts down."""
    self._db.close()

  @tool
  def lookup_order(self, order_id: str) -> str:
    """Look up an order by ID."""
    return self._db.query(order_id)

agent = Agent(model=model, skills=[CustomerSupport(db_url="sqlite:///orders.db")])

from definable.skill import Skill

skill = Skill(
  name="my_skill",
  instructions="Domain expertise...",
  tools=[my_tool],
  dependencies={"api_key": "..."},
)

from definable.skill import Calculator, DateTime, WebSearch, Shell, MacOS

agent = Agent(
  model=model,
  skills=[
    Calculator(),
    DateTime(),
    WebSearch(),
    Shell(allowed_commands={"ls", "cat", "grep"}),
    MacOS(allowed_apps={"Safari", "TextEdit"}),
  ],
)