전화기에서 자체 에이전트의 작업을 승인하십시오.
ColliePWA는 직접 구축한 에이전트의 질문을 터미널 에이전트 옆 휴대전화 화면에 표시합니다. 한 번의 탭으로 응답하면 에이전트가 답변을 수신합니다.
01/Durable agents
직접 만든 에이전트를 휴대폰에서.
durable agent는 Pi Durable 등을 사용하여 사용자가 직접 구축하고 실행하는 에이전트입니다. 이 에이전트는 소형 프로토콜인 wire를 통해 Collie와 통신하며, Node 및 Bun용 SDK가 이를 대신 처리합니다. 그런 다음 ColliePWA가 에이전트의 질문, 대화 및 채팅을 화면에 그리므로 UI 코드를 작성할 필요가 없습니다.
실험적 기능. wire는 마이너 릴리스에서 변경되거나 기능이 제거될 수 있습니다. 현재는 Collie 저장소의 예제만 이를 지원합니다.
02/ColliePWA
제공되는 기능
- 남은 시간이 표시되는 승인
- 에이전트의 질문은 휴대전화에서 카드로 표시됩니다. 예 또는 아니요, 선택지, 한 줄 텍스트 또는 짧은 양식 형태입니다. 한 번의 탭으로 응답할 수 있으며 카드는 질문이 열려 있는 시간을 표시합니다.
- 기록이 포함된 채팅
- durable agent의 각 대화는 채팅으로 열립니다. durable agent가 기록을 유지하므로 종료된 대화도 읽을 수 있습니다.
- 전용 섹션 및 푸시
- 에이전트는 휴대전화에 자체 Durable agents 섹션을 갖게 되며, 대기 중인 질문이 있으면 이 섹션이 스페이스 위로 이동합니다. push를 켜면 질문이 들어올 때 알림도 전송됩니다.
- 터미널 세션과 함께 표시
- Herdr, tmux, zellij 세션은 이전과 동일하게 보이고 작동합니다. durable agent는 세션이 생성될 수 있는 또 하나의 위치입니다.
03/hello.mjs
첫 번째 질문까지 10줄
에이전트 폴더에 SDK를 설치하십시오:
$ npm install @colliepwa/durable-sdk@experimental이 에이전트를 hello.mjs로 저장한 다음 node hello.mjs 또는 bun hello.mjs로 실행하십시오. 소켓 경로를 출력하고 대기합니다.
import { openCollie } from "@colliepwa/durable-sdk";
const socket = process.env.COLLIE_DURABLE_SOCKET ?? `${process.env.XDG_RUNTIME_DIR}/hello/app.sock`;
const collie = await openCollie({ socket, hostName: "hello", caps: { asks: true } });
const pane = collie.workspace("hello", { title: "Hello" }).tab("main", { title: "Questions" }).pane("deploy", { title: "Deploy", harness: "hello" });
collie.ready();
console.log(`listening ${collie.address}`);
const options = [{ id: "yes", label: "Yes" }, { id: "no", label: "No" }];
const answer = await pane.ask({ kind: "choice", toolCallId: "deploy-1", itemId: "deploy-1", title: "Deploy to staging?", options });
console.log(`answer: ${answer.optionIds[0]}`);
await collie.close();두 번째 터미널에서 출력된 경로를 사용하여 에이전트를 Collie에 연결하십시오. --restart는 Collie 브리지를 다시 시작합니다. 휴대전화는 몇 초 내에 다시 연결되며 터미널 세션은 계속 실행됩니다.
$ collie durable attach hello --socket /run/user/1000/hello/app.sock --restart
휴대전화에서 ColliePWA를 여십시오. Durable agents 섹션에 hello 행이 나타납니다. 해당 항목을 열면 단일 대화에 "Deploy to staging?" 질문이 포함되어 있습니다. Yes 또는 No를 탭하면 에이전트가 답변을 출력하고 종료됩니다.
04/Socket · HTTPS
실행 위치
- 동일한 머신에서
- Collie는 사용자만 열 수 있는 파일인 비공개 소켓을 통해 에이전트에 접근합니다.
- 그 외 모든 위치
- Collie는 32바이트 이상의 무작위 바이트 토큰을 사용하여 HTTPS로 에이전트에 접근하며, 토큰을 가진 사람은 누구나 대신 응답할 수 있습니다.
- Node 또는 Bun
- SDK는 Node 22.18 이상 및 Bun 1.4 이상에서 실행됩니다.
05/문서
문서 읽기
문서의 Durable agents 페이지에서는 설정, 두 가지 연결 방법, 문제 해결 및 durable agent가 휴대전화에 표시할 수 있는 내용을 다룹니다.