101 lines
2.8 KiB
TypeScript
101 lines
2.8 KiB
TypeScript
import CodeEditor from '@pages/components/CodeEditor'
|
|
|
|
export default function Configuration() {
|
|
return (
|
|
<div>
|
|
<h1 className="text-4xl font-bold mb-6">配置选项</h1>
|
|
|
|
<CodeEditor
|
|
className="mb-8"
|
|
language="typescript"
|
|
code={`// config
|
|
type PageAgentConfig = LLMConfig & AgentConfig & DomConfig
|
|
|
|
interface LLMConfig {
|
|
baseURL?: string
|
|
apiKey?: string
|
|
model?: string
|
|
temperature?: number
|
|
maxTokens?: number
|
|
maxRetries?: number
|
|
}
|
|
|
|
interface AgentConfig {
|
|
language?: "en-US" | "zh-CN"
|
|
|
|
/**
|
|
* Custom tools to extend PageAgent capabilities
|
|
* @experimental
|
|
* @note You can also override or remove internal tools by using the same name.
|
|
* @see [tools](../tools/index.ts)
|
|
*
|
|
* @example
|
|
* // override internal tool
|
|
* import { tool } from 'page-agent'
|
|
* const customTools = {
|
|
* ask_user: tool({
|
|
* description:
|
|
* 'Ask the user or parent model a question and wait for their answer. Use this if you need more information or clarification.',
|
|
* inputSchema: zod.object({
|
|
* question: zod.string(),
|
|
* }),
|
|
* execute: async function (this: PageAgent, input) {
|
|
* const answer = await do_some_thing(input.question)
|
|
* return "✅ Received user answer: " + answer
|
|
* },
|
|
* })
|
|
* }
|
|
*
|
|
* @example
|
|
* // remove internal tool
|
|
* const customTools = {
|
|
* ask_user: null // never ask user questions
|
|
* }
|
|
*/
|
|
customTools?: Record<string, PageAgentTool | null>
|
|
|
|
// lifecycle hooks
|
|
// @todo: use event instead of hooks
|
|
|
|
onBeforeStep?: (this: PageAgent, stepCnt: number) => Promise<void> | void
|
|
onAfterStep?: (this: PageAgent, stepCnt: number, history: AgentHistory[]) => Promise<void> | void
|
|
onBeforeTask?: (this: PageAgent) => Promise<void> | void
|
|
onAfterTask?: (this: PageAgent, result: ExecutionResult) => Promise<void> | void
|
|
|
|
/**
|
|
* @note this hook can block the disposal process
|
|
* @note when dispose caused by page unload, "reason" will be 'PAGE_UNLOADING'. this method CANNOT block unloading. async operations may be cut.
|
|
*/
|
|
onDispose?: (this: PageAgent, reason?: string) => void
|
|
|
|
// page behavior hooks
|
|
|
|
/**
|
|
* TODO: @unimplemented
|
|
* hook when action causes a new page to be opened
|
|
* @note PageAgent will try to detect new pages and decide if it's caused by an action. But not very reliable.
|
|
*/
|
|
onNewPageOpen?: (this: PageAgent, url: string) => Promise<void> | void
|
|
|
|
/**
|
|
* TODO: @unimplemented
|
|
* try to navigate to a new page instead of opening a new tab/window.
|
|
* @note will unload the current page when a action tries to open a new page. so that things keep in the same tab/window.
|
|
*/
|
|
experimentalPreventNewPage?: boolean
|
|
}
|
|
|
|
interface DomConfig {
|
|
interactiveBlacklist?: (Element | (() => Element))[]
|
|
interactiveWhitelist?: (Element | (() => Element))[]
|
|
include_attributes?: string[]
|
|
highlightOpacity?: number
|
|
highlightLabelOpacity?: number
|
|
}
|
|
|
|
`}
|
|
/>
|
|
</div>
|
|
)
|
|
}
|