본문으로 건너뛰기

가이드

에이전트

Piqline 에이전트에게 답하게 하기: 턴, 상태, 대화.

에이전트는 HTTP로 호출하는 대시보드 어시스턴트입니다. 요청을 읽고, 도구를 고르고, 실행한 뒤 출처와 함께 답합니다. 채팅과 같은 엔진을 사용하며, 키가 직접 호출할 수 있는 도구만 가집니다.

에이전트 목록#

에이전트역할
piqline워크스페이스 파이프라인: 코퍼스, 모니터링, 보드, 테이블, 북마크.
requete정확한 질문 하나에 대해 웹, 등록부, 아카이브에서 가져온 날짜가 있는 사실.
facebookMarketplace와 공개 그룹을 실시간으로.
linkedin공개 게시물에서 채용, 모니터링, 기회.
upworkUpwork 일감을 읽고, 점수를 매기고, 지식 베이스를 바탕으로 답안 작성.
onboarding워크스페이스 설정 안내: 니즈, 소스, 홈 보드, 알림. 소유자와 관리자 전용.

키에는 agents 스코프가 필요합니다. GEThttps://piqline.com/api/v1/agents는 에이전트 목록과, 각 에이전트에 대해 키로 호출할 수 있는 도구를 반환합니다.

한 턴 실행하기#

HTTP
POST https://piqline.com/api/v1/agents/{agent}
Content-Type: application/json
필드형식역할
input텍스트, 최대 20,000자사용자의 메시지.
messages배열이전 호출이 반환한 이전 대화.
model텍스트어시스턴트가 제공하는 모델의 ID. 알 수 없는 ID는 기본 모델로 대체됩니다.
reasoninglow, medium, high이를 지원하는 모델의 추론 강도.
stream불리언true: 스트리밍 응답(아래 참조).

input 또는 messages 중 하나 이상을 보내십시오.

curl -s https://piqline.com/api/v1/agents/piqline \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Quelles sources sont en erreur, et depuis quand ?"}'

응답:

필드의미
agent요청한 에이전트
statuscompleted, requires_input, requires_approval 중 하나(아래 참조)
text에이전트의 답변
tool_calls이번 턴에 호출된 도구: tool, state, input, 그리고 output 또는 error
pending사용자의 답을 기다리는 항목: kind(input 또는 approval), tool, input, 승인인 경우 approval_id
messages다음 호출에서 다시 보낼 전체 대화

대화 이어가기#

이전 응답의 messages 배열을 그대로 다시 보내고, 새 메시지는 input에 넣습니다.

Shell
# Premier tour : on garde la réponse.
curl -s https://piqline.com/api/v1/agents/piqline \
  -H "Authorization: Bearer $PIQLINE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Quelles sources sont en erreur ?"}' > tour1.json

# Deuxième tour : on renvoie la conversation.
jq '{messages: .messages, input: "Et depuis quand ?"}' tour1.json \
  | curl -s https://piqline.com/api/v1/agents/piqline \
      -H "Authorization: Bearer $PIQLINE_API_KEY" \
      -H "Content-Type: application/json" \
      -d @-

에이전트가 멈추는 경우#

  • completed. 에이전트가 답했습니다. text에 답변이 들어 있습니다.
  • requires_input. 에이전트가 질문하거나 카드를 제시합니다. 예를 들어 여러 소스 중 하나를 고르는 경우입니다. pending에 내용이 설명되어 있습니다. messages를 다시 보내면서 input에 텍스트로 답하십시오.
  • requires_approval. 에이전트가 소스 구독 같은 작업을 제안하지만 실행하지는 않습니다. 실행하려면 pending[].tool에 지정된 도구를 pending[].input으로 직접 호출하십시오. POSThttps://piqline.com/api/v1/tools/{nom}을 사용하며, 키에 act 스코프가 있어야 합니다.

스트리밍#

"stream": true를 지정하면 응답이 Server-Sent Events 스트림으로 도착합니다. 대시보드 채팅과 같은 스트림입니다. curl에서는 -N을 추가하면 도착하는 대로 볼 수 있습니다.

크레딧과 소요 시간#

한 턴은 워크스페이스 크레딧을 사용하며, 월간 한도에서 차감됩니다. 한 턴은 몇 초에서 수십 초가 걸립니다. 클라이언트에는 5분 타임아웃을 설정하십시오.

키 하나로 기본적으로 분당 10턴을 실행할 수 있습니다. 한도를 참조하십시오.

API에 대한 질문이 있거나 이 페이지에 오류가 있나요? 문의하기.