Fixie
Fixie
Fixie는 에이전트형 AI(agentic AI) 플랫폼이에요. 자연어로 에이전트를 만들고, 바로 테스트하고, Fixie 클라우드에 배포해 팀이나 다른 사용자들이 쓸 수 있게 해 줘요. 에이전트는 agent.yaml과 main.py 두 파일로 구성하고, 파이써닉한 SDK 덕분에 로컬에서도 쉽게 만들고 디버깅할 수 있어요. Python 3.9 이상만 있으면 CLI로 바로 시작할 수 있어요.
참고: 현재 fixie.ai/docs 주소는 회사가 리브랜딩하면서 실시간 음성 AI 서비스인 Ultravox.ai로 리다이렉트돼요. 아래 내용은 Fixie의 공식 예제 저장소(fixie-ai/fixie-examples, fixie-sdk)에 보존된 문서를 바탕으로 해요.
출처: 문서
본문
에이전트 구축 (Building agents)
Fixie CLI를 설치하고 인증부터 시작해요.
pip install fixieai
CLI가 설치되면 fixie auth로 Fixie 서비스에 인증해요. 계정이 없으면 app.fixie.ai에서 먼저 만들어야 해요. fixie init을 실행하면 기본 에이전트를 스캐폴딩해 줘요.
Fixie에서 에이전트를 만들려면 두 파일이 필요해요.
agent.yamlmain.py
agent.yaml 파일에는 이런 필드를 써요.
handle: "agent"
description: |
The `agent` serves the following function.
Example queries:
-Do this task for me.
more_info_url: "https://github.com/fixie-ai/fixie-examples"
entry_point: main:agent
public: false
tests:
- query: "Please do the task."
expected: "The response should indicate that the task has been done."
main.py 파일에는 이렇게 에이전트 로직을 작성해요.
from fixieai import agents
BASE_PROMPT = """I am an intelligent agent that does a task."""
FEW_SHOTS = """
Q: Example question here
A: Example of answer here
"""
agent = agents.CodeShotAgent(BASE_PROMPT, FEW_SHOTS)
에이전트에 함수(툴)를 추가하고 싶으면 @agent.register_func 데코레이터를 써요.
@agent.register_func
def example(query: fixieai.Message) -> str:
assert query.text == "input"
return "output"
에이전트 배포 (Deploying agents)
fixie agent deploy를 실행하면 에이전트가 자동으로 Fixie 클라우드에 업로드되고 즉시 서빙을 시작해요. 이 명령으로 에이전트를 생성(또는 업데이트)하고 fewshots과 함수들을 Fixie에 올려요.
fixie agent deploy
배포 후에는 로컬에서 이렇게 테스트할 수 있어요.
fixie session new '@username/agentname example query
아니면 app.fixie.ai에서 메인 채팅을 열고 @username/agentname로 호출해 새 에이전트와 대화할 수 있어요.
사용 예시 (Examples)
공식 예제 저장소에는 실제 동작하는 에이전트들이 있어요. 예를 들어 주가 조회 에이전트(stock)와 지메일 에이전트(gmail)가 있어요.
stock 에이전트의 agent.yaml은 이렇게 생겼어요.
handle: stock
description: |
The `stock` agent is capable of looking up stock prices for a given company.
`stock` can determine the proper ticker symbol from the company name or you can provide one directly.
Example queries:
- How did Apple do today?
- What is the current stock price for NVDA?
- Who did better today, Apple or Google?
tests:
- query: What is the price of Caterpillar?
expected: The response should be similar to "The share price for Caterpillar is $229.86."
more_info_url: https://github.com/fixie-ai/fixie-examples
entry_point: main:agent
public: false
gmail 에이전트는 OAuth 이메일 연동을 보여주는 예시로, "What are my latest emails?" 같은 쿼리로 최신 이메일을 확인하고 검색해 줘요.
이렇게 만든 에이전트는 app.fixie.ai에서 @username/agentname 형식으로 다른 사용자도 호출할 수 있어요.