Decisions API 用于 agent 下一步动作

// Agent loop: decisions-1 picks the next action each step.
type Action = "search_docs" | "call_tool" | "ask_user" | "finish";

async function decideNext(state: unknown): Promise<{ action: Action; confidence: number }> {
  const res = await fetch("https://decisions-api.net/api/v1/decisions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.DECISIONS_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "decisions-1",
      state, // string, JSON object, or array of text
      questions: {
        next: {
          type: "choice",
          instructions: "What should the agent do next?",
          criteria: {
            search_docs: "Look up documentation before acting.",
            call_tool: "Run the next planned tool call.",
            ask_user: "Stop and ask the user for clarification.",
            finish: "The task is complete; produce the final answer.",
          },
        },
        done: { type: "noul", instructions: "Is the user's task fully complete?" },
      },
    }),
  });
  const { answers } = await res.json();
  return { action: answers.next.choice, confidence: answers.next.confidence };
}

const MAX_STEPS = 8;

async function runAgent(agentState: unknown) {
  for (let step = 0; step < MAX_STEPS; step++) {
    const { action, confidence } = await decideNext(agentState);
    // Illustrative response: { action: "call_tool", confidence: 0.83 }
    if (confidence < 0.8) { await askUser(agentState); continue; }
    switch (action) {
      case "finish": return;
      case "search_docs": await searchDocs(agentState); break;
      case "call_tool": await runTool(agentState); break;
      case "ask_user": await askUser(agentState); break;
    }
  }
  // MAX_STEPS reached: hand off to a human instead of looping forever.
}