612 lines
No EOL
19 KiB
TypeScript
612 lines
No EOL
19 KiB
TypeScript
import { APIResource } from "../../../../resource.js";
|
|
import * as Core from "../../../../core.js";
|
|
import * as StepsAPI from "./steps.js";
|
|
import { CursorPage, type CursorPageParams } from "../../../../pagination.js";
|
|
export declare class Steps extends APIResource {
|
|
/**
|
|
* Retrieves a run step.
|
|
*/
|
|
retrieve(threadId: string, runId: string, stepId: string, query?: StepRetrieveParams, options?: Core.RequestOptions): Core.APIPromise<RunStep>;
|
|
retrieve(threadId: string, runId: string, stepId: string, options?: Core.RequestOptions): Core.APIPromise<RunStep>;
|
|
/**
|
|
* Returns a list of run steps belonging to a run.
|
|
*/
|
|
list(threadId: string, runId: string, query?: StepListParams, options?: Core.RequestOptions): Core.PagePromise<RunStepsPage, RunStep>;
|
|
list(threadId: string, runId: string, options?: Core.RequestOptions): Core.PagePromise<RunStepsPage, RunStep>;
|
|
}
|
|
export declare class RunStepsPage extends CursorPage<RunStep> {
|
|
}
|
|
/**
|
|
* Text output from the Code Interpreter tool call as part of a run step.
|
|
*/
|
|
export interface CodeInterpreterLogs {
|
|
/**
|
|
* The index of the output in the outputs array.
|
|
*/
|
|
index: number;
|
|
/**
|
|
* Always `logs`.
|
|
*/
|
|
type: 'logs';
|
|
/**
|
|
* The text output from the Code Interpreter tool call.
|
|
*/
|
|
logs?: string;
|
|
}
|
|
export interface CodeInterpreterOutputImage {
|
|
/**
|
|
* The index of the output in the outputs array.
|
|
*/
|
|
index: number;
|
|
/**
|
|
* Always `image`.
|
|
*/
|
|
type: 'image';
|
|
image?: CodeInterpreterOutputImage.Image;
|
|
}
|
|
export declare namespace CodeInterpreterOutputImage {
|
|
interface Image {
|
|
/**
|
|
* The [file](https://platform.openai.com/docs/api-reference/files) ID of the
|
|
* image.
|
|
*/
|
|
file_id?: string;
|
|
}
|
|
}
|
|
/**
|
|
* Details of the Code Interpreter tool call the run step was involved in.
|
|
*/
|
|
export interface CodeInterpreterToolCall {
|
|
/**
|
|
* The ID of the tool call.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The Code Interpreter tool call definition.
|
|
*/
|
|
code_interpreter: CodeInterpreterToolCall.CodeInterpreter;
|
|
/**
|
|
* The type of tool call. This is always going to be `code_interpreter` for this
|
|
* type of tool call.
|
|
*/
|
|
type: 'code_interpreter';
|
|
}
|
|
export declare namespace CodeInterpreterToolCall {
|
|
/**
|
|
* The Code Interpreter tool call definition.
|
|
*/
|
|
interface CodeInterpreter {
|
|
/**
|
|
* The input to the Code Interpreter tool call.
|
|
*/
|
|
input: string;
|
|
/**
|
|
* The outputs from the Code Interpreter tool call. Code Interpreter can output one
|
|
* or more items, including text (`logs`) or images (`image`). Each of these are
|
|
* represented by a different object type.
|
|
*/
|
|
outputs: Array<CodeInterpreter.Logs | CodeInterpreter.Image>;
|
|
}
|
|
namespace CodeInterpreter {
|
|
/**
|
|
* Text output from the Code Interpreter tool call as part of a run step.
|
|
*/
|
|
interface Logs {
|
|
/**
|
|
* The text output from the Code Interpreter tool call.
|
|
*/
|
|
logs: string;
|
|
/**
|
|
* Always `logs`.
|
|
*/
|
|
type: 'logs';
|
|
}
|
|
interface Image {
|
|
image: Image.Image;
|
|
/**
|
|
* Always `image`.
|
|
*/
|
|
type: 'image';
|
|
}
|
|
namespace Image {
|
|
interface Image {
|
|
/**
|
|
* The [file](https://platform.openai.com/docs/api-reference/files) ID of the
|
|
* image.
|
|
*/
|
|
file_id: string;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
/**
|
|
* Details of the Code Interpreter tool call the run step was involved in.
|
|
*/
|
|
export interface CodeInterpreterToolCallDelta {
|
|
/**
|
|
* The index of the tool call in the tool calls array.
|
|
*/
|
|
index: number;
|
|
/**
|
|
* The type of tool call. This is always going to be `code_interpreter` for this
|
|
* type of tool call.
|
|
*/
|
|
type: 'code_interpreter';
|
|
/**
|
|
* The ID of the tool call.
|
|
*/
|
|
id?: string;
|
|
/**
|
|
* The Code Interpreter tool call definition.
|
|
*/
|
|
code_interpreter?: CodeInterpreterToolCallDelta.CodeInterpreter;
|
|
}
|
|
export declare namespace CodeInterpreterToolCallDelta {
|
|
/**
|
|
* The Code Interpreter tool call definition.
|
|
*/
|
|
interface CodeInterpreter {
|
|
/**
|
|
* The input to the Code Interpreter tool call.
|
|
*/
|
|
input?: string;
|
|
/**
|
|
* The outputs from the Code Interpreter tool call. Code Interpreter can output one
|
|
* or more items, including text (`logs`) or images (`image`). Each of these are
|
|
* represented by a different object type.
|
|
*/
|
|
outputs?: Array<StepsAPI.CodeInterpreterLogs | StepsAPI.CodeInterpreterOutputImage>;
|
|
}
|
|
}
|
|
export interface FileSearchToolCall {
|
|
/**
|
|
* The ID of the tool call object.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* For now, this is always going to be an empty object.
|
|
*/
|
|
file_search: FileSearchToolCall.FileSearch;
|
|
/**
|
|
* The type of tool call. This is always going to be `file_search` for this type of
|
|
* tool call.
|
|
*/
|
|
type: 'file_search';
|
|
}
|
|
export declare namespace FileSearchToolCall {
|
|
/**
|
|
* For now, this is always going to be an empty object.
|
|
*/
|
|
interface FileSearch {
|
|
/**
|
|
* The ranking options for the file search.
|
|
*/
|
|
ranking_options?: FileSearch.RankingOptions;
|
|
/**
|
|
* The results of the file search.
|
|
*/
|
|
results?: Array<FileSearch.Result>;
|
|
}
|
|
namespace FileSearch {
|
|
/**
|
|
* The ranking options for the file search.
|
|
*/
|
|
interface RankingOptions {
|
|
/**
|
|
* The ranker used for the file search.
|
|
*/
|
|
ranker: 'default_2024_08_21';
|
|
/**
|
|
* The score threshold for the file search. All values must be a floating point
|
|
* number between 0 and 1.
|
|
*/
|
|
score_threshold: number;
|
|
}
|
|
/**
|
|
* A result instance of the file search.
|
|
*/
|
|
interface Result {
|
|
/**
|
|
* The ID of the file that result was found in.
|
|
*/
|
|
file_id: string;
|
|
/**
|
|
* The name of the file that result was found in.
|
|
*/
|
|
file_name: string;
|
|
/**
|
|
* The score of the result. All values must be a floating point number between 0
|
|
* and 1.
|
|
*/
|
|
score: number;
|
|
/**
|
|
* The content of the result that was found. The content is only included if
|
|
* requested via the include query parameter.
|
|
*/
|
|
content?: Array<Result.Content>;
|
|
}
|
|
namespace Result {
|
|
interface Content {
|
|
/**
|
|
* The text content of the file.
|
|
*/
|
|
text?: string;
|
|
/**
|
|
* The type of the content.
|
|
*/
|
|
type?: 'text';
|
|
}
|
|
}
|
|
}
|
|
}
|
|
export interface FileSearchToolCallDelta {
|
|
/**
|
|
* For now, this is always going to be an empty object.
|
|
*/
|
|
file_search: unknown;
|
|
/**
|
|
* The index of the tool call in the tool calls array.
|
|
*/
|
|
index: number;
|
|
/**
|
|
* The type of tool call. This is always going to be `file_search` for this type of
|
|
* tool call.
|
|
*/
|
|
type: 'file_search';
|
|
/**
|
|
* The ID of the tool call object.
|
|
*/
|
|
id?: string;
|
|
}
|
|
export interface FunctionToolCall {
|
|
/**
|
|
* The ID of the tool call object.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The definition of the function that was called.
|
|
*/
|
|
function: FunctionToolCall.Function;
|
|
/**
|
|
* The type of tool call. This is always going to be `function` for this type of
|
|
* tool call.
|
|
*/
|
|
type: 'function';
|
|
}
|
|
export declare namespace FunctionToolCall {
|
|
/**
|
|
* The definition of the function that was called.
|
|
*/
|
|
interface Function {
|
|
/**
|
|
* The arguments passed to the function.
|
|
*/
|
|
arguments: string;
|
|
/**
|
|
* The name of the function.
|
|
*/
|
|
name: string;
|
|
/**
|
|
* The output of the function. This will be `null` if the outputs have not been
|
|
* [submitted](https://platform.openai.com/docs/api-reference/runs/submitToolOutputs)
|
|
* yet.
|
|
*/
|
|
output: string | null;
|
|
}
|
|
}
|
|
export interface FunctionToolCallDelta {
|
|
/**
|
|
* The index of the tool call in the tool calls array.
|
|
*/
|
|
index: number;
|
|
/**
|
|
* The type of tool call. This is always going to be `function` for this type of
|
|
* tool call.
|
|
*/
|
|
type: 'function';
|
|
/**
|
|
* The ID of the tool call object.
|
|
*/
|
|
id?: string;
|
|
/**
|
|
* The definition of the function that was called.
|
|
*/
|
|
function?: FunctionToolCallDelta.Function;
|
|
}
|
|
export declare namespace FunctionToolCallDelta {
|
|
/**
|
|
* The definition of the function that was called.
|
|
*/
|
|
interface Function {
|
|
/**
|
|
* The arguments passed to the function.
|
|
*/
|
|
arguments?: string;
|
|
/**
|
|
* The name of the function.
|
|
*/
|
|
name?: string;
|
|
/**
|
|
* The output of the function. This will be `null` if the outputs have not been
|
|
* [submitted](https://platform.openai.com/docs/api-reference/runs/submitToolOutputs)
|
|
* yet.
|
|
*/
|
|
output?: string | null;
|
|
}
|
|
}
|
|
/**
|
|
* Details of the message creation by the run step.
|
|
*/
|
|
export interface MessageCreationStepDetails {
|
|
message_creation: MessageCreationStepDetails.MessageCreation;
|
|
/**
|
|
* Always `message_creation`.
|
|
*/
|
|
type: 'message_creation';
|
|
}
|
|
export declare namespace MessageCreationStepDetails {
|
|
interface MessageCreation {
|
|
/**
|
|
* The ID of the message that was created by this run step.
|
|
*/
|
|
message_id: string;
|
|
}
|
|
}
|
|
/**
|
|
* Represents a step in execution of a run.
|
|
*/
|
|
export interface RunStep {
|
|
/**
|
|
* The identifier of the run step, which can be referenced in API endpoints.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The ID of the
|
|
* [assistant](https://platform.openai.com/docs/api-reference/assistants)
|
|
* associated with the run step.
|
|
*/
|
|
assistant_id: string;
|
|
/**
|
|
* The Unix timestamp (in seconds) for when the run step was cancelled.
|
|
*/
|
|
cancelled_at: number | null;
|
|
/**
|
|
* The Unix timestamp (in seconds) for when the run step completed.
|
|
*/
|
|
completed_at: number | null;
|
|
/**
|
|
* The Unix timestamp (in seconds) for when the run step was created.
|
|
*/
|
|
created_at: number;
|
|
/**
|
|
* The Unix timestamp (in seconds) for when the run step expired. A step is
|
|
* considered expired if the parent run is expired.
|
|
*/
|
|
expired_at: number | null;
|
|
/**
|
|
* The Unix timestamp (in seconds) for when the run step failed.
|
|
*/
|
|
failed_at: number | null;
|
|
/**
|
|
* The last error associated with this run step. Will be `null` if there are no
|
|
* errors.
|
|
*/
|
|
last_error: RunStep.LastError | null;
|
|
/**
|
|
* Set of 16 key-value pairs that can be attached to an object. This can be useful
|
|
* for storing additional information about the object in a structured format. Keys
|
|
* can be a maximum of 64 characters long and values can be a maxium of 512
|
|
* characters long.
|
|
*/
|
|
metadata: unknown | null;
|
|
/**
|
|
* The object type, which is always `thread.run.step`.
|
|
*/
|
|
object: 'thread.run.step';
|
|
/**
|
|
* The ID of the [run](https://platform.openai.com/docs/api-reference/runs) that
|
|
* this run step is a part of.
|
|
*/
|
|
run_id: string;
|
|
/**
|
|
* The status of the run step, which can be either `in_progress`, `cancelled`,
|
|
* `failed`, `completed`, or `expired`.
|
|
*/
|
|
status: 'in_progress' | 'cancelled' | 'failed' | 'completed' | 'expired';
|
|
/**
|
|
* The details of the run step.
|
|
*/
|
|
step_details: MessageCreationStepDetails | ToolCallsStepDetails;
|
|
/**
|
|
* The ID of the [thread](https://platform.openai.com/docs/api-reference/threads)
|
|
* that was run.
|
|
*/
|
|
thread_id: string;
|
|
/**
|
|
* The type of run step, which can be either `message_creation` or `tool_calls`.
|
|
*/
|
|
type: 'message_creation' | 'tool_calls';
|
|
/**
|
|
* Usage statistics related to the run step. This value will be `null` while the
|
|
* run step's status is `in_progress`.
|
|
*/
|
|
usage: RunStep.Usage | null;
|
|
}
|
|
export declare namespace RunStep {
|
|
/**
|
|
* The last error associated with this run step. Will be `null` if there are no
|
|
* errors.
|
|
*/
|
|
interface LastError {
|
|
/**
|
|
* One of `server_error` or `rate_limit_exceeded`.
|
|
*/
|
|
code: 'server_error' | 'rate_limit_exceeded';
|
|
/**
|
|
* A human-readable description of the error.
|
|
*/
|
|
message: string;
|
|
}
|
|
/**
|
|
* Usage statistics related to the run step. This value will be `null` while the
|
|
* run step's status is `in_progress`.
|
|
*/
|
|
interface Usage {
|
|
/**
|
|
* Number of completion tokens used over the course of the run step.
|
|
*/
|
|
completion_tokens: number;
|
|
/**
|
|
* Number of prompt tokens used over the course of the run step.
|
|
*/
|
|
prompt_tokens: number;
|
|
/**
|
|
* Total number of tokens used (prompt + completion).
|
|
*/
|
|
total_tokens: number;
|
|
}
|
|
}
|
|
/**
|
|
* The delta containing the fields that have changed on the run step.
|
|
*/
|
|
export interface RunStepDelta {
|
|
/**
|
|
* The details of the run step.
|
|
*/
|
|
step_details?: RunStepDeltaMessageDelta | ToolCallDeltaObject;
|
|
}
|
|
/**
|
|
* Represents a run step delta i.e. any changed fields on a run step during
|
|
* streaming.
|
|
*/
|
|
export interface RunStepDeltaEvent {
|
|
/**
|
|
* The identifier of the run step, which can be referenced in API endpoints.
|
|
*/
|
|
id: string;
|
|
/**
|
|
* The delta containing the fields that have changed on the run step.
|
|
*/
|
|
delta: RunStepDelta;
|
|
/**
|
|
* The object type, which is always `thread.run.step.delta`.
|
|
*/
|
|
object: 'thread.run.step.delta';
|
|
}
|
|
/**
|
|
* Details of the message creation by the run step.
|
|
*/
|
|
export interface RunStepDeltaMessageDelta {
|
|
/**
|
|
* Always `message_creation`.
|
|
*/
|
|
type: 'message_creation';
|
|
message_creation?: RunStepDeltaMessageDelta.MessageCreation;
|
|
}
|
|
export declare namespace RunStepDeltaMessageDelta {
|
|
interface MessageCreation {
|
|
/**
|
|
* The ID of the message that was created by this run step.
|
|
*/
|
|
message_id?: string;
|
|
}
|
|
}
|
|
export type RunStepInclude = 'step_details.tool_calls[*].file_search.results[*].content';
|
|
/**
|
|
* Details of the Code Interpreter tool call the run step was involved in.
|
|
*/
|
|
export type ToolCall = CodeInterpreterToolCall | FileSearchToolCall | FunctionToolCall;
|
|
/**
|
|
* Details of the Code Interpreter tool call the run step was involved in.
|
|
*/
|
|
export type ToolCallDelta = CodeInterpreterToolCallDelta | FileSearchToolCallDelta | FunctionToolCallDelta;
|
|
/**
|
|
* Details of the tool call.
|
|
*/
|
|
export interface ToolCallDeltaObject {
|
|
/**
|
|
* Always `tool_calls`.
|
|
*/
|
|
type: 'tool_calls';
|
|
/**
|
|
* An array of tool calls the run step was involved in. These can be associated
|
|
* with one of three types of tools: `code_interpreter`, `file_search`, or
|
|
* `function`.
|
|
*/
|
|
tool_calls?: Array<ToolCallDelta>;
|
|
}
|
|
/**
|
|
* Details of the tool call.
|
|
*/
|
|
export interface ToolCallsStepDetails {
|
|
/**
|
|
* An array of tool calls the run step was involved in. These can be associated
|
|
* with one of three types of tools: `code_interpreter`, `file_search`, or
|
|
* `function`.
|
|
*/
|
|
tool_calls: Array<ToolCall>;
|
|
/**
|
|
* Always `tool_calls`.
|
|
*/
|
|
type: 'tool_calls';
|
|
}
|
|
export interface StepRetrieveParams {
|
|
/**
|
|
* A list of additional fields to include in the response. Currently the only
|
|
* supported value is `step_details.tool_calls[*].file_search.results[*].content`
|
|
* to fetch the file search result content.
|
|
*
|
|
* See the
|
|
* [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
|
|
* for more information.
|
|
*/
|
|
include?: Array<RunStepInclude>;
|
|
}
|
|
export interface StepListParams extends CursorPageParams {
|
|
/**
|
|
* A cursor for use in pagination. `before` is an object ID that defines your place
|
|
* in the list. For instance, if you make a list request and receive 100 objects,
|
|
* ending with obj_foo, your subsequent call can include before=obj_foo in order to
|
|
* fetch the previous page of the list.
|
|
*/
|
|
before?: string;
|
|
/**
|
|
* A list of additional fields to include in the response. Currently the only
|
|
* supported value is `step_details.tool_calls[*].file_search.results[*].content`
|
|
* to fetch the file search result content.
|
|
*
|
|
* See the
|
|
* [file search tool documentation](https://platform.openai.com/docs/assistants/tools/file-search/customizing-file-search-settings)
|
|
* for more information.
|
|
*/
|
|
include?: Array<RunStepInclude>;
|
|
/**
|
|
* Sort order by the `created_at` timestamp of the objects. `asc` for ascending
|
|
* order and `desc` for descending order.
|
|
*/
|
|
order?: 'asc' | 'desc';
|
|
}
|
|
export declare namespace Steps {
|
|
export import CodeInterpreterLogs = StepsAPI.CodeInterpreterLogs;
|
|
export import CodeInterpreterOutputImage = StepsAPI.CodeInterpreterOutputImage;
|
|
export import CodeInterpreterToolCall = StepsAPI.CodeInterpreterToolCall;
|
|
export import CodeInterpreterToolCallDelta = StepsAPI.CodeInterpreterToolCallDelta;
|
|
export import FileSearchToolCall = StepsAPI.FileSearchToolCall;
|
|
export import FileSearchToolCallDelta = StepsAPI.FileSearchToolCallDelta;
|
|
export import FunctionToolCall = StepsAPI.FunctionToolCall;
|
|
export import FunctionToolCallDelta = StepsAPI.FunctionToolCallDelta;
|
|
export import MessageCreationStepDetails = StepsAPI.MessageCreationStepDetails;
|
|
export import RunStep = StepsAPI.RunStep;
|
|
export import RunStepDelta = StepsAPI.RunStepDelta;
|
|
export import RunStepDeltaEvent = StepsAPI.RunStepDeltaEvent;
|
|
export import RunStepDeltaMessageDelta = StepsAPI.RunStepDeltaMessageDelta;
|
|
export import RunStepInclude = StepsAPI.RunStepInclude;
|
|
export import ToolCall = StepsAPI.ToolCall;
|
|
export import ToolCallDelta = StepsAPI.ToolCallDelta;
|
|
export import ToolCallDeltaObject = StepsAPI.ToolCallDeltaObject;
|
|
export import ToolCallsStepDetails = StepsAPI.ToolCallsStepDetails;
|
|
export import RunStepsPage = StepsAPI.RunStepsPage;
|
|
export import StepRetrieveParams = StepsAPI.StepRetrieveParams;
|
|
export import StepListParams = StepsAPI.StepListParams;
|
|
}
|
|
//# sourceMappingURL=steps.d.ts.map
|